Partager:
){kind=small}
Julia s'engage à aider ses collègues développeurs en créant des tutoriels, des guides et des ressources pratiques. Grâce à son expérience en matière de sensibilisation et d'éducation, elle vise à rendre la technologie plus accessible et à améliorer l'expérience globale des développeurs. Vous pouvez souvent la trouver lors d'événements communautaires locaux.
Comment recevoir des SMS avec Node-RED
Temps de lecture : 4 minutes
Cet article est le deuxième d'une série de tutoriels "Getting Started with Nexmo and Node-RED".
Dans l'article article précédentvous avez configuré votre Account API Vonage et votre éditeur Node-RED, appris à envoyer des SMS et à gérer les accusés de réception. Il est maintenant temps d'apprendre à recevoir des SMS en mettant en œuvre un point de terminaison webhook à l'aide de Node-RED.
Obtenez ce flux à partir de la Bibliothèque Node-RED ou suivez le mouvement !
Avant de commencer, vous aurez besoin de quelques éléments :
Facultatif : ngrok-se mettre à jour avec L'article du blog d'Aaron
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.
This tutorial also uses a virtual phone number. To purchase one, go to Numbers > Buy Numbers and search for one that meets your needs.
Pour recevoir des messages SMS à l'aide de l'API de Vonage, vous devez associer un point de terminaison webhook à un numéro virtuel que vous avez loué auprès de Vonage. Les messages entrants à destination de ce numéro seront alors envoyés à votre point de terminaison webhook.
Tout d'abord, configurez ce point de terminaison webhook dans votre éditeur Node-RED. Connectez un nœud d'entrée http à un nœud http response ainsi qu'à un nœud debug afin que vous puissiez voir vos messages entrants dans la zone de débogage. Dans le nœud d'entrée http nœud d'entrée, sélectionnez GET en tant que Method et remplissez le champ URL avec quelque chose comme /inbound-sms. Le nœud http response devrait avoir 200 défini comme Status codemais ne vous inquiétez pas, c'est la valeur par défaut.
Ensuite, vous devrez exposer votre serveur local à l'internet, afin que Vonage puisse y accéder. Si vous exécutez Node-RED sur un serveur web public au lieu de votre machine locale, vous pouvez sauter cette étape. Sinon, un moyen pratique de le faire est d'utiliser un service de tunneling comme ngrok.
Télécharger et installez ngrokpuis lancez-le dans le terminal pour démarrer un tunnel sur le port 1880.
La dernière étape consiste à indiquer à l'API SMS de Vonage où il doit transférer les messages entrants. Associez un point de terminaison webhook à l'un de vos numéros virtuels en allant à Vos Numberspuis en cliquant sur l'icône des paramètres à côté du numéro que vous souhaitez configurer. Remplissez ensuite l URL du webhook entrant entrant avec YOUR_NGROK_URL/inbound-sms et Save changes.
Maintenant, si vous envoyez un message texte à votre numéro virtuel, vous devriez voir l'objet message apparaître dans la barre latérale de débogage.
La charge utile du message contiendra quelques valeurs clés qu'il convient de noter :
| KEY | DESCRIPTION |
|---|---|
msisdn |
Mobile Station International Subscriber Directory Number (MSISDN) is a number used to identify a mobile phone number internationally. In this case, this will be the sender's number in E.164 format. For example 447401234567. |
to |
Your Nexmo number that the SMS was sent to, in E.164 format. |
text |
The content of the received SMS message. |
type |
The type of the message body received (text key). Possible values are text, unicode and binary. |
keyword |
The first word in the message body. This is typically used with short codes. |
message-timestamp |
The time when Nexmo started to push this Delivery Receipt to your webhook endpoint. |
Pour en savoir plus sur ces paramètres, consultez la Référence API de Vonage pour les SMS entrants.
Pour l'instant, nous n'enregistrons que les messages entrants dans la zone de débogage, mais les possibilités sont infinies. Stockez-les dans une base de données, transférez-les, traduisez-les, publiez-les - ou pourquoi ne pas mettre en place un répondeur automatique ?
Prêt à aller plus loin ? Jetez un coup d'œil à Sampour Recevoir des SMS concaténés de Nexmo.
En savoir plus sur l'API SMS DE VONAGE
Regardez de plus près Node-RED
Partager:
Julia s'engage à aider ses collègues développeurs en créant des tutoriels, des guides et des ressources pratiques. Grâce à son expérience en matière de sensibilisation et d'éducation, elle vise à rendre la technologie plus accessible et à améliorer l'expérience globale des développeurs. Vous pouvez souvent la trouver lors d'événements communautaires locaux.