Compartir:
){kind=small}
Julia está comprometida con la capacitación de los desarrolladores mediante la creación de tutoriales, guías y recursos prácticos. Con experiencia en divulgación y educación, su objetivo es hacer que la tecnología sea más accesible y mejorar la experiencia general de los desarrolladores. A menudo se la puede encontrar en eventos de la comunidad local.
Cómo recibir mensajes SMS con Node-RED
Tiempo de lectura: 4 minutos
Este es el segundo artículo de la serie de tutoriales "Primeros pasos con Nexmo y Node-RED".
En el artículo anteriorconfiguraste tu cuenta API de Vonage y el editor Node-RED, aprendiste a enviar mensajes SMS y a manejar los recibos de entrega. Ahora es el momento de aprender a recibir mensajes SMS implementando un punto final webhook usando Node-RED.
Obtenga este flujo de la Biblioteca Node-RED ¡o síguelo!
Antes de empezar, necesitarás algunas cosas:
Opcional: ngrok-ponte al día con Aaron's blog post
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.
Para recibir mensajes SMS mediante la API de Vonage, debes asociar un punto final de webhook con un número virtual que hayas alquilado a Vonage. Los mensajes entrantes a ese número se enviarán a tu punto final de webhook.
En primer lugar, configure este punto final webhook en su editor Node-RED. Conecte un http nodo de entrada a un nodo http response así como a un nodo debug para que pueda ver los mensajes de entrada en el área de depuración. En el nodo de http nodo de entrada, seleccione GET como Method y rellene el campo URL con algo como /inbound-sms. El nodo http response debe tener 200 como Status codepero no te preocupes, este es el valor por defecto.
A continuación, deberás exponer tu servidor local a Internet para que Vonage pueda acceder a él. Si estás ejecutando Node-RED en un servidor web público en lugar de tu máquina local, puedes saltarte esta etapa. De lo contrario, una forma conveniente de hacerlo es utilizando un servicio de tunelización como ngrok.
Descargue e instale ngroky ejecútelo en el terminal para iniciar un túnel en el puerto 1880.
El último paso es informarle a la SMS API de Vonage a dónde debe reenviar los mensajes entrantes. Asocia un punto final de webhook con uno de tus números virtuales yendo a Tus Numbersy luego haz clic en el ícono de configuración junto al número que deseas configurar. A continuación, introduzca la URL del webhook de entrada con YOUR_NGROK_URL/inbound-sms y Save changes.
Ahora, si envías un mensaje de texto a tu número virtual, deberías ver aparecer el objeto del mensaje en la barra lateral de depuración.
La carga útil del mensaje contendrá un par de valores clave que conviene tener en cuenta:
| 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. |
Obtenga más información sobre estos parámetros en la Referencia de API de Vonage para SMS entrantes.
En este momento, sólo registramos los mensajes entrantes en el área de depuración, pero las posibilidades son infinitas. Almacénalos en una base de datos, reenvíalos, tradúcelos, publícalos... o ¿por qué no creas una respuesta automática?
¿Listo para dar un paso más? Eche un vistazo a Sampara Recibir mensajes SMS concatenados de Nexmo.
Compartir:
Julia está comprometida con la capacitación de los desarrolladores mediante la creación de tutoriales, guías y recursos prácticos. Con experiencia en divulgación y educación, su objetivo es hacer que la tecnología sea más accesible y mejorar la experiencia general de los desarrolladores. A menudo se la puede encontrar en eventos de la comunidad local.