Présentation de l'API WhatsApp Business avec Twilio

WhatsApp est l'application OTT la plus populaire dans de nombreuses régions du monde. Grâce à l'API WhatsApp Business avec Twilio, vous pouvez atteindre plus de 1,5 milliard d'utilisateurs WhatsApp. Vous pouvez envoyer des notifications, participer à des conversations bidirectionnelles ou construire des chatbots. Si vous essayez d'atteindre (et de mieux discuter avec) des utilisateurs en Amérique latine, en EMEA et en Asie-Pacifique, vous devez envisager d'utiliser WhatsApp.

Conditions d'opt-in WhatsApp

WhatsApp exige que votre application mette en œuvre des opt-ins utilisateur explicites pour transmettre des messages via WhatsApp. Vous pouvez recueillir ces informations d'inscription via une page Web ou une application mobile, par exemple lors du flux d'inscription de votre application, dans les paramètres de compte de votre application, par SMS, etc.

Veuillez noter que l'envoi de messages aux utilisateurs finaux sans opt-in peut entraîner le blocage de votre entreprise par les utilisateurs ainsi que la suspension de votre compte WhatsApp Business.

Utilisation des numéros de téléphone Twilio avec WhatsApp

Sur WhatsApp, les utilisateurs s'envoient des messages en utilisant des numéros de téléphone. Pour envoyer et recevoir des messages WhatsApp à l'aide de l'API Twilio Programmable Messaging, vous aurez également besoin d'un numéro de téléphone. L'API Twilio s'adresse aux utilisateurs WhatsApp et à vos numéros, en utilisant le format d'adresse avec le préfixe suivant:

whatsapp:<E.164 formatted phone number>

(E.164 est un format de numéro de téléphone international ; vous le verrez souvent dans les chaînes qui représentent les numéros de téléphone Twilio.)

Activation de WhatsApp avec un numéro Twilio

Pour utiliser la messagerie WhatsApp dans les applications de production, vous devez activer WhatsApp sur votre numéro Twilio. WhatsApp ouvre actuellement cet accès dans un programme à disponibilité limitée. Cela signifie que l'approbation WhatsApp est requise pour tous les clients qui souhaitent créer leurs propres profils.

Pour une présentation détaillée du processus, consultez notre guide pour connecter votre numéro Twilio à votre profil WhatsApp Business. Une fois votre demande envoyée et approuvée, vous pourrez sélectionner vos numéros Twilio et demander leur activation dans WhatsApp.

For information about using a non-Twilio number with WhatsApp, check out our Support guide Can I activate my own phone number for WhatsApp on Twilio?

Soumettez votre compte Facebook Business Manager

WhatsApp utilise votre compte Facebook Business Manager pour identifier votre entreprise et y associer vos numéros de téléphone.

Vous devez obtenir une autorisation pour activer vos numéros Twilio pour WhatsApp. Ensuite, vous devrez fournir votre identifiant Facebook Business Manager à Twilio. Si vous n'avez pas encore de compte Facebook Business Manager, suivez les instructions de Facebook pour en créer un.

Votre identifiant Facebook Business Manager se trouve dans la section « Business Info » (Informations sur l'entreprise) sous Business Settings (Paramètres d'entreprise).

Gérez et configurez vos numéros Twilio compatibles WhatsApp

You can request to configure up to 25 new numbers for WhatsApp. To manage your own templates and your WhatsApp profile, go to Messaging > Senders > WhatsApp Senders in the Console. Here, you can see the list of your WhatsApp-enabled Twilio phone numbers (senders) as well as any templates that you have submitted for approval.

Cliquez sur un expéditeur (Sender) spécifique (numéro de téléphone compatible WhatsApp) pour accéder à sa page de configuration (Configuration) spécifique. Cela inclut la section de configuration du point de terminaison‌(Endpoint configuration), où vous pouvez spécifier l'action que Twilio doit entreprendre lorsqu'il reçoit un message WhatsApp à ce numéro. Vous pouvez configurer cet expéditeur dans le cadre d'un service de messagerie ou avec une URL de webhook individuelle.

Envoi de notifications avec WhatsApp

WhatsApp exige que les notifications initiées par l'entreprise envoyées par votre application soient modélisées et préenregistrées, à l'exception des messages envoyés en réponse à un message initié par l'utilisateur. (Pour plus d'informations, reportez-vous à la section‌Messagerie conversationnelle (‌Conversational Messaging) sur WhatsApp).Messagerie conversationnelle sur WhatsApp).

Pour en savoir plus, consultez notre Guide d'envoi de notifications WhatsApp à l'aide de modèles de message.

Messagerie conversationnelle sur WhatsApp

Pour avoir des conversations bidirectionnelles avec les utilisateurs finaux, vous devez être en mesure de recevoir des messages de leur part. Les utilisateurs peuvent envoyer vos messages professionnels directement ou en réponse à un modèle de notification.

Comment lancer une « session de 24 heures » WhatsApp

Une session WhatsApp commence lorsqu'un utilisateur envoie un message à votre application. Les sessions sont valables 24 heures après le dernier message reçu, au cours desquelles vous pouvez communiquer avec les clients à l'aide de messages libres. Pour envoyer un message en dehors de la fenêtre de session de 24 heures, vous devez utiliser un modèle de message pré-approuvé. (Voir notre Guide des modèles de message WhatsApp).

Configuration des webhooks de messages entrants

Lorsque les clients vous envoient un message WhatsApp, Twilio envoie un webhook (une demande à une URL que vous spécifiez) à votre application. Vous pouvez configurer l'URL vers laquelle Twilio envoie un webhook lorsqu'il reçoit des messages entrants dans la console Twilio :

• Sur la page Sandbox
• Sur la page Numéros compatibles WhatsApp
• Dans la section « Integration » (Intégration) de vos paramètres pour un service de messagerie spécifique (sous la section Services de messagerie de la console)

Configuration des URL de rappel pour vos expéditeurs compatibles WhatsApp

Vous pouvez également configurer une URL de rappel au même endroit que celui où vous avez défini votre URL de webhook par défaut. Si une erreur critique se produit lors de l'exécution d'une requête à votre URL de webhook principal, Twilio « rappelle » cette URL de rappel secondaire.

Lors de l'exécution d'une requête à votre URL de rappel, Twilio soumet également les paramètres ErrorCode et ErrorUrl, indiquant le code d'erreur de l'échec et l'URL pour laquelle l'échec s'est produit.

Configuration des Webhooks de messages entrants pour Twilio Sandbox for WhatsApp	Configuration des webhooks de messages entrants pour votre numéro Twilio compatible WhatsApp

Pour plus de détails sur les données fournies dans la demande que Twilio envoie à votre application (via l'URL du webhook), consultez la rubrique Requêtes HTTP de Twilio à votre application.

Réception d'un message WhatsApp

Le webhook pour les messages entrants utilise le même format que les messages SMS et MMS entrants, à l'exception que les adresses To (À) et From (De) seront définies sur des adresses WhatsApp (whatsapp:<your E.164 number> et whatsapp:<User's E.164 phone number>), respectivement.

Les messages entrants peuvent inclure du texte ou des médias. Le champ Body contient le texte du message et le champ MediaUrl0 contient un lien vers le fichier multimédia. Vous pouvez apprendre à télécharger les médias entrants inclus dans un message dans le tutoriel Recevoir et télécharger des images sur les messages MMS entrants. Les supports pris en charge incluent les images (JPG, JPEG, PNG), les fichiers audio et les fichiers PDF, avec une taille maximale de 16 Mo par message.

Réponse aux messages entrants avec TwiML

Les messages entrants WhatsApp sont entièrement pris en charge par TwiML, ce qui vous permet d'utiliser en toute transparence votre application SMS existante avec WhatsApp. Pour plus d'informations, consultez la documentation sur l'utilisation de TwiML.

Envoi d'un message WhatsApp en forme libre à l'aide de l'API

Dans une session WhatsApp, vous pouvez envoyer des messages de forme libre à l'aide de l'API Programmable Messaging. Les messages de forme libre peuvent inclure du texte ou des médias.

Liens Web dans les messages WhatsApp de forme libre

Les messages WhatsApp de forme libre contenant des liens Web affichent un aperçu de l'extrait de page Web lorsqu'ils sont reçus sur le client WhatsApp.

Surveillez le statut de votre message WhatsApp sortant

Pour recevoir des mises à jour de statut en temps réel pour les messages sortants, vous pouvez choisir de définir une URL de rappel de statut. Twilio envoie une demande à cette URL chaque fois que le statut de votre message passe à l'un des statuts suivants : queued (file d'attente), failed (échec), sent (envoyé), delivered (livré), read (lu).

Vous pouvez définir l'URL de rappel de statut dans la console, ou lorsque vous envoyez un message sortant individuel, en incluant le paramètre StatusCallback (Rappel de statut). Vous pouvez le définir dans différentes parties de la console Twilio en fonction de votre configuration de messagerie :

• Définissez l'URL de rappel de statut pour la Sandbox WhatsApp
• Définissez le rappel de statut pour un expéditeur WhatsApp individuel
• Définissez le rappel de statut d'un service de messagerie (sous les paramètres d'intégration d'un service de messagerie spécifique)

Lorsque vous définissez l'URL de rappel de statut, Twilio envoie une requête POST à cette URL, incluant le MessageSid (identifiant unique du message), ainsi que les autres paramètres de requête standard, comme MessageStatus et ErrorCode.

Les paramètres envoyés par Twilio à votre URL de rappel incluent tous les paramètres de requête standard, ainsi que certains paramètres de messagerie uniques. Vous pouvez voir la liste complète des paramètres dans la référence d'API de la ressource Message.