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
Si vous avez créé une application, vous serez invité·e à y 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 avez déjà un portefeuille business, vous serez invité·e à le joindre. Si vous n’en avez pas, vous serez invité·e à suivre des instructions vous permettant d’en créer un et de le joindre.
Le fait d’ajouter le produit WhatsApp à votre application et de joindre un portefeuille business :
- Crée un compte WhatsApp Business (« WABA ») de test que vous pouvez utiliser pour vous envoyer un message test gratuit.
- Crée un numéro de téléphone professionnel de test et l’associer à votre WABA que vous pouvez utiliser pour envoyer un message gratuit à un maximum de cinq destinataires.
- Crée un modèle « hello world ».
Étape 2 : Obtenir un token d’accès
Dans le menu de gauche du tableau de bord de l’application, allez dans WhatsApp > Configuration de l’API, puis cliquez sur le bouton bleu Générer un token d’accès. Suivez les étapes pour générer un token d’accès utilisateur·ice. Habituellement, vous utilisez un token système ou un token entreprise, mais pour ces étapes, un token utilisateur·ice suffit.
Étape 3 : Ajouter le numéro d’un·e destinataire
Ajoutez un numéro WhatsApp valide auquel envoyer des messages de test. 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 4 : 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 5 : 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 6 : (Facultatif) Ajouter un vrai numéro professionnel
Avec votre numéro professionnel et votre WABA 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 WABA.