Présentation de l'environnement de test de l'API Messages

Le bac à sable de l'API Messages est une nouvelle façon de développer et de tester toute application que vous souhaitez créer à l'aide de WhatsApp, Viberou Facebook Messenger via notre Messages API.

Le bac à sable bac à sable vous permet de lier vos propres comptes WhatsApp, Viber ou Facebook Messenger afin que vous puissiez commencer à envoyer et à recevoir des messages de test sur vos propres appareils au fur et à mesure que vous construisez.

Dans ce tutoriel, nous allons voir comment tout mettre en place.

Conditions préalables

Vonage API Account

To complete this tutorial, you will need a Vonage API account. If you don’t have one already, you can sign up today and start building with free credit. Once you have an account, you can find your API Key and API Secret at the top of the Vonage API Dashboard.

Ready to start building?

Experience seamless connectivity, real-time messaging, and crystal-clear voice and video calls—all at your fingertips.

Une fois que vous aurez votre Account, vous aurez également besoin de :

• Un smartphone avec WhatsApp, Viber ou Facebook Messenger installé.

• Une ligne de commande ou une application de terminal.

Mettez vous sur liste blanche

Accédez à l'API Sandbox de Messages API Sandbox dans votre tableau de bord API Vonage.

La première étape consiste à mettre vos comptes sur liste blanche. Le processus étant similaire pour tous les services pris en charge, nous nous concentrerons sur WhatsApp dans la section Comptes externes.

Cliquez sur le lien "Ajouter au bac à sable" pour ouvrir la liste des options. Il existe trois façons d'ajouter un nouveau compte à la liste blanche :

1. Scannez le code QR avec votre appareil photo pour ouvrir WhatsApp avec un message prédéfini.

2. Envoyez des instructions à vous-même ou à un autre membre de l'équipe par courrier électronique.

3. Envoyez un message directement depuis WhatsApp au numéro indiqué à l'aide de la phrase unique indiquée.

Quelle que soit la méthode choisie, ce que vous faites, c'est lier le numéro et l'identifiant de compte que vous avez défini sur votre compte WhatsApp à la clé API de votre compte Nexmo.

Vous saurez qu'il a fonctionné si le bas de la section "liste blanche" se lit comme suit You have 1 user(s) whitelisted. Si vous ne voyez pas cela tout de suite, cliquez sur le lien Actualiser.

Si vous souhaitez lier un compte Viber ou Facebook Messenger, répétez les étapes pour chaque service.

Envoyez-vous un message

Une fois que votre Account est inscrit sur la liste blanche, vous pouvez le tester en vous envoyant un message.

Pour ce faire, vous pouvez utiliser Terminal sous macOS et Linux ou Ligne de commande sous Windows.

Copiez le code du service que vous avez choisi dans le bloc de codes situé au bas de l'écran.

Il est pré-rempli avec vos identifiants API, mais vous devez modifier le champ $TO_NUMBER pour qu'il corresponde au numéro du compte que vous avez précédemment inscrit sur la liste blanche.

Collez le code dans votre application Terminal. Appuyez sur Entrée et attendez la réponse du serveur ; elle devrait ressembler à ceci :

{"message_uuid":"7836a42b-7493-4ece-a7a7-3f59c5058471"}

Attendez ensuite que le message s'affiche !

Plutôt cool, non ?

Se connecter à votre application via les Webhooks

CURL est excellent, mais nous savons que vous n'êtes pas là pour vous envoyer des messages en ligne de commande.

Pour permettre à votre application de recevoir des messages entrants de n'importe quel service pris en charge, vous pouvez créer une Inbound webhook.

Pour recevoir des messages entrants, assurez-vous d'abord que votre application dispose d'un point de terminaison pour écouter les messages et qu'elle peut recevoir des POST des requêtes. Vous pouvez l'appeler comme vous le souhaitez ; nous avons entendu dire que /inbound est un choix populaire.

Avant de déployer votre application sur un serveur, vous pouvez utiliser une application comme Ngrok pour la rendre accessible au monde extérieur. Vous trouverez plus de détails sur la mise en place de cette application dans notre documentation.

Il est bon de savoir ce qu'il advient des messages envoyés par votre application. Pour ce faire, nous fournissons un Status qui signale tout changement survenant le long du chemin de livraison.

Par exemple, si vous voulez savoir si les messages envoyés par votre application arrivent, cela sera signalé via le webhook status à l'aide d'une balise delivered status. Bien que l'utilisation de ce webhook soit facultative, c'est un excellent choix pour le surveiller activement et enregistrer les données qu'il vous envoie.

Vous pouvez prendre le relais

Le bac à sable de l'API Messages vous permet de commencer à travailler avec WhatsApp, Viber et Facebook Messenger rapidement et facilement. Vous pouvez désormais connecter n'importe lequel de ces services à vos applications nouvelles ou existantes, alors que construirez-vous avec eux ?

Commencez par consulter la de l'API Messages.

Si vous êtes en quête d'inspiration, voici cinq autres tutoriels que nous avons créés et qui pourraient vous donner des idées :

• Sauvegarder les SMS reçus avec Airtable et Node.js-Vous pouvez changer ceci pour stocker les messages reçus de WhatsApp, Viber ou Facebook Messenger.

• Découvrez votre score de positivité sur Twitter-Vous pourriez vous inspirer de cet exemple React et lui faire envoyer le score via Viber ou WhatsApp à la place.

• Scraper le Web et envoyer des mises à jour par SMS-Vous pourriez prendre cet exemple d'application et lui faire envoyer les résultats par WhatsApp.

• Traductions de SMS en temps réel avec Node, React, et Google-Pourquoi ne pas ajouter à cette application et lui faire traduire des SMS, des messages WhatsApp ou Facebook Messenger ?

• Envoyer et recevoir des SMS avec Node.js et Azure Functions-Essayez de modifier cette Azure Function pour qu'elle envoie des messages Viber au lieu de SMS.

Quel que soit votre projet, nous sommes là pour vous si vous avez besoin de nous. Rendez-vous sur le Slack de la communauté des développeurs de Slack de la communauté des développeurs de Vonage pour reprendre la conversation, partager des conseils et apprendre des autres.