Premiers pas
Ce guide vous aide à envoyer et à recevoir votre premier message à l’aide de l’API Cloud. Vous y apprendrez également à configurer des webhooks pour les utiliser dans un exemple d’application.
Ce guide s’adresse à toutes les personnes développant des applications pour elles-mêmes ou leur organisation. Si vous développez une application destinée à d’autres entreprises, consultez la rubrique Fournisseurs de solutions.
Avant de commencer
Vous aurez besoin des éléments suivants :
- Un compte de développeur Meta : en savoir plus sur l’inscription en tant que développeur·se Meta.
- Une application Business : en savoir plus sur la création d’applications. Si l’option de création d’une application Business n’apparaît pas, sélectionnez Autre > Suivant > Business lors de la création.
Étape 1 : Ajouter le produit WhatsApp à votre application
À ce stade, si vous avez créé une application, vous serez invité·e à lui ajouter des produits. Faites défiler la page vers le bas, puis sous WhatsApp, sélectionnez Configurer. Vous pouvez également sélectionner votre application sur la page Mes applications et suivre les mêmes étapes pour ajouter le produit WhatsApp.
Si vous disposez d’un compte business Meta (MBA), vous serez invité·e à l’associer lorsque vous ajouterez le produit WhatsApp à votre application. Si vous n’en avez pas, vous serez invité·e à suivre des instructions vous permettant d’en créer un. Une fois votre compte MBA associé à votre application, vous pourrez commencer les tests.
Lors de l’ajout du produit WhatsApp à votre application :
- Vous êtes invité·e à créer un compte business Meta si ce n’est pas déjà fait.
- Un compte WhatsApp Business de test est créé automatiquement pour vous. Ce compte limité doit être utilisé aux fins de test et de développement, car vous ne payez pas les messages.
- Un numéro de téléphone professionnel de test associé à votre compte WhatsApp Business est créé. Il vous permet d’envoyer des messages gratuits à un maximum de cinq destinataires.
- Un ensemble de modèles de messages pré-approuvés est créé.
Étape 2 : Ajouter le numéro d’un·e destinataire
Ajoutez un numéro WhatsApp valide auquel envoyer des messages de test.
Dans le menu gauche de l’Espace App, accédez à WhatsApp > Configuration de l’API. Sous Envoyer et recevoir des messages, sélectionnez le champ À et choisissez Gérer la liste de numéros de téléphone.
Vous pouvez ajouter n’importe quel numéro WhatsApp valide en tant que destinataire. Un code de confirmation sera envoyé au numéro du ou de la destinataire dans WhatsApp afin de vérifier le numéro.
Une fois vérifié, le numéro apparaît dans le champ À. Répétez éventuellement ce processus pour ajouter jusqu’à cinq destinataires en tout.
Étape 3 : Envoyer un message de test
Envoyez le modèle de message pré-approuvé hello_world au numéro du ou de la destinataire de votre choix.
Dans le panneau WhatsApp > Configuration de l’API :
- Vérifiez que votre numéro de téléphone professionnel de test est sélectionné dans le champ De.
- Vérifiez que le numéro du ou de la destinataire à qui envoyer le message figure dans le champ À. En ajoutant plusieurs numéros, vous pouvez envoyer plusieurs messages simultanément.
- Dans le panneau Send messages with the API (Envoyer des messages à l’aide de l’API), cliquez sur le bouton Envoyer un message.
Vous avez également la possibilité de copier la commande cURL, puis de la coller dans une nouvelle fenêtre de terminal pour l’exécuter.
Notez que le code indique que vous envoyez un message de type modèle (”type”:”template”) et que vous identifiez le modèle à utiliser (”name”:”hello_world”).
Étape 4 : Cloner notre exemple d’application et configurer des webhooks
Les webhooks vous permettent de recevoir des notifications HTTP en temps réel concernant des modifications apportées à des objets spécifiques. Dans WhatsApp, ils vous informent des évènements survenus dans votre application, comme la réception des messages, les confirmations de lecture et même les modifications apportées au compte.
Pour afficher le contenu des webhooks, ajoutez une URL de rappel. Pour cloner notre exemple d’application, suivez notre guide sur l’exemple d’URL de rappel pour les tests de webhooks. Notre exemple accepte les notifications de webhooks et affiche leurs charges utiles JSON à l’écran.
Une fois votre webhook configuré, renvoyez le message de modèle, puis répondez-y. Les quatre notifications de webhooks suivantes devraient s’afficher : l’envoi du message, la réception du message, les notifications de lecture et le contenu du message entrant.
Étape 5 : (Facultatif) Ajouter un vrai numéro professionnel
Avec votre numéro professionnel et votre compte WhatsApp Business de test, vous pouvez commencer à développer votre application. Lorsque vous utilisez ces éléments de test, l’envoi des messages est gratuit.
Une fois que vous êtes prêt·e à envoyer des messages à votre clientèle, vous pouvez ajouter un vrai numéro de téléphone professionnel dans le panneau Configuration de l’API et créer un vrai compte WhatsApp Business.