Envoyez des notifications WhatsApp, des codes de vérification et des réponses interactives depuis une seule API.

Envoyez confirmations de commande, codes de vérification à usage unique, médias enrichis, boutons interactifs ou menus de liste directement dans les conversations WhatsApp de vos clients. Bird valide les paramètres des modèles et vérifie la fenêtre de service client de 24 heures avant l'envoi, ce qui évite les appels en échec et les frais inattendus, tout en renvoyant les accusés de réception et de lecture à votre application.

Commencer Contacter l’équipe commerciale

// Install the SDK
// npm install @messagebird/sdk

const msg = await bird.whatsapp.send({
  to: "+15551234567",
  template: {
    slug: "bird_otp",
    components: [{ type: "body", parameters: [{ type: "text", text: "123456" }] }],
  },
});
console.log(msg.id, msg.status);

Envoyez votre premier message en quelques minutes avec nos SDK TypeScript, Python, Go ou PHP, la CLI Bird ou des requêtes HTTP directes. Commencez immédiatement avec les modèles préapprouvés de Bird pendant la vérification de votre propre numéro WhatsApp Business.

Modèles et fenêtre de 24 heures

Envoyez le bon format, dans la fenêtre de 24 heures ou en dehors.

WhatsApp distingue les messages initiés par l'entreprise des conversations client actives. Contactez vos clients en dehors d'une conversation active avec des modèles utilitaires, d'authentification ou marketing approuvés par Meta, puis passez au texte libre, aux médias et aux menus interactifs pendant 24 heures après qu'ils vous ont écrit ou appelé.

Détectez en amont les fenêtres fermées et les variables incorrectes

Bird suit la fenêtre de service client de 24 heures par destinataire et par numéro professionnel. Si votre application tente d'envoyer un message libre après la fermeture de la fenêtre, ou transmet des variables de modèle qui ne correspondent pas à vos espaces réservés, l'API rejette l'appel avant toute création ou facturation.

Médias enrichis, boutons interactifs et menus de liste

Lorsqu'une conversation est ouverte, envoyez images, PDF, extraits audio, vidéos, localisations ou fiches de contact depuis un seul endpoint. Ajoutez des boutons de réponse rapide, des menus de liste à options multiples, des carrousels de produits ou des demandes de localisation et de contact pour que vos clients touchent au lieu de taper.

Suivi de la distribution en temps réel

Suivez les messages de leur acceptation par l'API jusqu'à l'accusé de lecture.

L'envoi sur WhatsApp est asynchrone. Dès que Bird accepte votre requête, les événements webhook et la chronologie de chaque message indiquent quand le message est transmis à WhatsApp, distribué sur le téléphone du client et ouvert dans la conversation.

Diagnostiquez les rejets grâce aux détails d'erreur Meta

Si un message échoue après son acceptation, par exemple parce que la fenêtre de service expire pendant l'envoi ou que Meta bloque la distribution, Bird enregistre la description de l'échec et le code d'erreur Meta sous-jacent dans la fiche du message, pour que votre équipe sache s'il faut réessayer ou changer de canal.

Évitez les envois en double lors des nouvelles tentatives réseau

Incluez une clé d'idempotence dans votre requête d'envoi : en cas d'expiration du délai ou de nouvelle tentative d'un worker pendant la période de conservation, la réponse d'origine est renvoyée au lieu d'envoyer un message en double.

order_ready

Distribué

·À +44 7700 900123·Utilitaire

Harbor

Compte professionnel

Merci ! Je viendrai le chercher demain.9:44

Événements

Accepté

Bird accepte la requête et renvoie l'identité du message.

Envoyé

Le message suit le processus d'envoi.

Distribué

Les observations du fournisseur mettent à jour l'enregistrement du message lorsqu'elles sont disponibles.

Lecture

Gérez les rejets, les échecs et les observations manquantes au sein de la même intégration.

Contexte pour les workflows bidirectionnels

Reliez les réponses des clients à la bonne commande ou au bon ticket.

Citez un message précédent pour que votre client voie, directement dans la conversation, à quelle question ou commande vous répondez. Lorsqu'un client touche un bouton de réponse rapide, choisit une option de liste ou répond à un message récent, Bird renvoie l'action sélectionnée et la référence du message cité pour que votre application achemine la réponse immédiatement.

Ajoutez des tags et des métadonnées aux envois sortants

Ajoutez jusqu'à 20 tags filtrables et 2 Ko de métadonnées JSON personnalisées à un message sortant. Filtrez les journaux de messages par campagne ou workflow, et gardez vos identifiants internes de commande ou de ticket associés à l'enregistrement sortant, dans les lectures de l'API comme dans les webhooks de distribution.

Pilotez depuis votre code, votre terminal ou votre agent IA

Envoyez des messages de test, examinez les chronologies de distribution et filtrez l'historique récent depuis la CLI Bird, ou connectez votre assistant de code via le serveur MCP Bird, dans le respect des rôles et des autorisations d'expéditeur de votre espace de travail.

Questions sur l'envoi WhatsApp

Une requête acceptée signifie-t-elle que le message a été distribué ?

Non. L'admission par l'API, l'acceptation par Meta, la livraison et les lectures sont des observations distinctes. Confirmez l'état du message concerné et le résultat métier séparément.

Puis-je envoyer des messages libres à tout moment ?

Les réponses libres dépendent de la fenêtre de service client et du type de contenu pris en charge. En dehors de cette fenêtre, utilisez un modèle approuvé éligible.

Existe-t-il un endpoint batch pour WhatsApp ?

L'API de messages publiée envoie des messages individuels. Cadencez la diffusion applicative en respectant les limites documentées ; ne supposez pas qu'un endpoint de diffusion e-mail envoie aussi des messages WhatsApp.

Comment associer une réponse interactive à mon application ?

Utilisez des identifiants de réponse explicites avec l'état de conversation ou de tâche que vous stockez. Une référence de message cité peut aider lorsqu'elle est disponible, mais les métadonnées sortantes ne sont pas automatiquement héritées par la réponse.

Connectez le parcours complet

Guide d'envoi WhatsAppEnvoyez des modèles, des médias libres et des boutons interactifs, et vérifiez les accusés de réception.Templates WhatsAppConcevez des modèles utilitaires, marketing et d'authentification, et suivez leur approbation par Meta pour chaque langue.Conversations WhatsAppRépondez depuis une boîte de réception partagée, gérez les libellés et passez le relais entre l'IA et vos collègues.Analytique WhatsAppSuivez les taux de distribution, les accusés de lecture, les réponses des clients et les motifs d'échec sur tous vos numéros.Bibliothèque de ressources WhatsAppParcourez les guides pour développeurs, les réponses techniques et les comparatifs de fournisseurs.Plateforme WhatsAppDécouvrez les numéros professionnels, les diffusions, les Flows et le support bidirectionnel sur Bird.

Passez à l'échelle sans perdre le contrôle.

Separate production and sandbox traffic into dedicated workspaces, scope API keys to the exact channels each service or agent needs, and track permission changes in the audit log.

Commencez avec WhatsApp.
Développez sur tous les canaux avec Bird.