Compartilhar:
){kind=small}
Julia está empenhada em capacitar outros desenvolvedores por meio da criação de tutoriais, guias e recursos práticos. Com experiência em divulgação e educação, ela busca tornar a tecnologia mais acessível e aprimorar a experiência geral dos desenvolvedores. É comum encontrá-la em eventos da comunidade local.
Como receber mensagens SMS com o Node-RED
Tempo de leitura: 4 minutos
Este é o segundo artigo de uma série de tutoriais intitulada “Introdução ao Nexmo e ao Node-RED”.
No artigo anterior, você configurou sua conta da API da Vonage e o editor do Node-RED, aprendeu a enviar mensagens SMS e a lidar com os recibos de entrega. Agora é hora de aprender a receber mensagens SMS implementando um endpoint de webhook usando o Node-RED.
Baixe este fluxo da Biblioteca do Node-RED ou acompanhe o passo a passo!
Antes de começar, você precisará de algumas coisas:
Opcional: ngrok—fique por dentro do postagem no blog do Aaron
Para receber mensagens SMS usando a API da Vonage, é necessário associar um endpoint de webhook a um número virtual que você tenha alugado da Vonage. As mensagens recebidas nesse número serão, então, enviadas para o seu endpoint de webhook.
Primeiro, configure este endpoint de webhook no seu editor do Node-RED. Conecte um http nó de entrada a um http response nó, bem como a um debug nó, para que você possa visualizar suas mensagens recebidas na área de depuração. No http nó de entrada, selecione GET como Method e preencha o URL campo com algo como /inbound-sms. O http response nó deve ter 200 definido como Status code, mas não se preocupe com isso, esse é o valor padrão.
Em seguida, você precisará expor seu servidor local à internet, para que a Vonage possa acessá-lo. Se você estiver executando o Node-RED em um servidor web público, em vez de em sua máquina local, pode pular esta etapa. Caso contrário, uma maneira prática de fazer isso é usando um serviço de tunelamento como o ngrok.
Baixe e instale o ngroke, em seguida, execute-o no terminal para iniciar um túnel na porta 1880.
A última etapa é informar à SMS API da Vonage para onde ela deve encaminhar as mensagens recebidas. Associe um endpoint de webhook a um dos seus números virtuais acessando Seus númerose, em seguida, clicando no ícone de configurações ao lado do número que você deseja configurar. Em seguida, preencha o URL do webhook de entrada com YOUR_NGROK_URL/inbound-sms e Save changes.
Agora, se você enviar uma mensagem de texto para o seu número virtual, deverá ver o objeto da mensagem aparecer na barra lateral de depuração.
A carga útil da mensagem conterá alguns valores-chave que devem ser observados:
| 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. |
Saiba mais sobre esses parâmetros na Referência da API da Vonage para SMS recebidos.
Neste momento, estamos apenas registrando as mensagens recebidas na área de depuração, mas as possibilidades são infinitas. Armazene-as em um banco de dados, encaminhe-as, traduza-as, publique-as — ou por que não configurar uma resposta automática?
Pronto para dar mais um passo adiante? Dê uma olhada em fluxo do Sampara Receber mensagens SMS concatenadas da Nexmo.
Compartilhar:
Julia está empenhada em capacitar outros desenvolvedores por meio da criação de tutoriais, guias e recursos práticos. Com experiência em divulgação e educação, ela busca tornar a tecnologia mais acessível e aprimorar a experiência geral dos desenvolvedores. É comum encontrá-la em eventos da comunidade local.