WhatsAppApi

Ajoutez la messagerie WhatsApp à votre application.

Envoyez des mises à jour utiles, recevez les réponses de vos clients et suivez chaque message tout au long de son cycle de vie. Utilisez les API et SDK publiés de Bird pour connecter WhatsApp aux applications et flux sur lesquels vos clients comptent déjà.

Commencez à développer avec WhatsApp Lire le guide d'envoi

Configurez avec votre agent :

CursorCopied!

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);

Choisissez votre SDK ou utilisez HTTP directement. Ces exemples sont générés à partir de l'opération publiée de Bird.

Une requête claire

Choisissez le message adapté au moment.

Utilisez un modèle approuvé pour un message éligible initié par l'entreprise, ou une réponse libre prise en charge dans la fenêtre de service client. Gardez l'expéditeur, le destinataire, la langue et le contenu explicites.

Utilisez les exemples publiés

Partez de l'exemple SDK ou HTTP généré ci-dessus. Suivez la structure de contenu réelle de l'opération et sa validation au lieu de deviner une méthode à partir d'une illustration marketing.

Cadencez la charge

Utilisez la réponse de limitation du débit et une file d'attente bornée. Lorsqu'une application diffuse des messages, conservez un enregistrement durable de chaque destinataire prévu et de chaque requête.

Un cycle de vie que vous pouvez comprendre

Suivez l'acceptation jusqu'à la réponse du client.

Une requête API acceptée lance le traitement. L'acceptation par Meta, la livraison et les confirmations de lecture décrivent des étapes ultérieures ; elles ne garantissent pas que le client a accompli la tâche métier visée.

Réconciliez avec les lectures de messages

Consommez les webhooks pertinents et récupérez les enregistrements de messages lors de l'investigation d'un écart. Gardez les tentatives incertaines distinctes des échecs confirmés.

Gardez des décisions de réessai précises

Utilisez les protections de requête documentées et la classification des erreurs. Ne supposez pas qu'une tentative incertaine du fournisseur peut être répétée indéfiniment en toute sécurité.

Un message, de la requête à la réponseExemple de parcours

Accepté

Bird admet la requête et renvoie l'identifiant du message.

Traité

Le message passe par le flux d'envoi.

Distribué ou lu

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

Merci ! Je le récupère demain.

Gérez le rejet, l'échec et les observations manquantes dans la même intégration.

Une conversation, pas un simple endpoint

Transmettez le contexte utile dans la réponse.

Utilisez les identifiants explicites de bouton ou de liste de réponse ainsi que l'état de conversation de votre application. Une réponse peut citer un message précédent, mais cette référence est facultative et peut être indisponible.

Gardez les métadonnées à leur place

Les métadonnées sortantes appartiennent à l'enregistrement sortant. Ne supposez pas qu'elles sont copiées sur le message entrant du client.

Connectez des outils avec les mêmes permissions

CLI et MCP peuvent aider les développeurs à exploiter le canal. Ils restent soumis aux mêmes règles d'accès à l'espace de travail, de propriété de l'expéditeur et d'envoi.

Questions sur l'API 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 de l'API WhatsAppSuivez la configuration, les décisions opérationnelles et les étapes de vérification.Templates WhatsAppCréez des messages réutilisables et suivez l'approbation par langue.Conversations WhatsAppRéunissez le contexte client, l'IA et votre équipe dans une seule conversation.Analytique WhatsAppSuivez la livraison, la réponse client et les résultats commerciaux.Bibliothèque de ressources WhatsAppExplorez les guides d'implémentation, les réponses expliquées et les comparatifs.Plateforme WhatsAppExplorez le produit connecté et choisissez la prochaine fonctionnalité.

Ressources associées

Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.

Regarder le guideConnecting WhatsApp to Bird: from buying a number to a live channel Comprendre le conceptWhat is the 24-hour customer service window on WhatsApp?Utiliser l'outilWhatsApp message builder Suivre le parcours d'apprentissageBuild your first integration

Essayez la pratique et obtenez un guide d'implémentation

Faites de la première requête une partie d'une intégration fonctionnelle.

Configurez votre espace de travail, utilisez un exemple publié et inspectez la réponse. Connectez les réponses et les événements de livraison avant d'augmenter le trafic.