Programmable Messaging para o Início rápido do WhatsApp e do Node.js
A Twilio está lançando um novo Console. Algumas capturas de tela nesta página podem mostrar o Console legado e, portanto, podem não ser mais precisas. Estamos trabalhando para atualizar todas as capturas de tela para refletir a nova experiência do Console. Saiba mais sobre o novo Console.
Com apenas algumas linhas de código, seu aplicativo pode enviar e receber mensagens com o WhatsApp usando a API da Twilio para WhatsApp.
Este início rápido para WhatsApp ensina como fazer isso usando o Twilio Sandbox para WhatsApp, Node.js e JavaScript, a biblioteca auxiliar Twilio Node.js da Twilio e a estrutura web Express.js. Neste início rápido, você aprende a:
- Inscreva‐se na Twilio e ative o Sandbox.
- Configure seu ambiente de desenvolvimento para enviar e receber mensagens
- Faça a inscrição (opt-in) para o Sandbox
- Envie sua primeira mensagem pelo WhatsApp
- Receba mensagens pelo WhatsApp
- Responda mensagens recebidas pelo WhatsApp
Inscreva‐se na Twilio e ative o Sandbox
Antes de enviar uma mensagem pelo WhatsApp, você precisará cadastrar uma conta da Twilio ou fazer login em sua conta já existente e ativar o Twilio Sandbox para WhatsApp. Ele permite criar protótipos com o WhatsApp imediatamente por meio de um número de telefone compartilhado, sem você ter que esperar que um número exclusivo seja aprovado pelo WhatsApp.
Para começar, selecione um número dentre os disponíveis no Sandbox para ativá‐lo.
Anote o número de telefone escolhido no Sandbox. Você precisará disso mais tarde quando for o momento de enviar algumas mensagens.
Reúna as informações da sua conta da Twilio
Antes de enviar qualquer mensagem, você precisará reunir as credenciais da sua conta da Twilio. Você pode encontrá‐las no Twilio Console.
- Account SID (SID da conta) – Usado para autenticar solicitações à API REST
- Auth Token (Token de autenticação) – Usado para autenticar solicitações à API REST
Para todos os nossos trechos de código e exemplos de cURL, você precisará autenticar com o Account SID (SID da conta) e o Auth Token (Token de autenticação).
Configure seu ambiente de desenvolvimento Node.js
As próximas etapas envolverão a criação de um pouco de código. Escrevemos a configuração do ambiente de desenvolvimento no Node.js, onde você configurará um ambiente virtual e se preparará para criar um aplicativo da web simples com o Express.
Se você ainda não configurou seu ambiente de desenvolvimento para escrever JavaScript, vá até lá primeiro para se preparar. Este início rápido vai estar à espera.
Envie uma mensagem com WhatsApp no Node.js
Como usar números predefinidos de Sandbox
O Sandbox é pré‐provisionado com três números de telefone Twilio que são compartilhados entre todos os usuários. Para usar o Sandbox você DEVE aceitar, enviando ao número de telefone escolhido uma mensagem do WhatsApp. Uma vez ativado, você só receberá mensagens de seu Sandbox específico.
Essas limitações não existem em sua própria identidade corporativa, que você pode solicitar que sejam provisionadas no WhatsApp.
Mensagem de aceitação do Sandbox
Envie “join <your sandbox keyword>” para o número do Sandbox no WhatsApp para participar do Sandbox e responderemos com uma confirmação de que você ingressou. Veja sua palavra‐chave do Sandbox no console.
Depois de ingressar, você receberá apenas mensagens do Sandbox específico. Para se desconectar do Sandbox, você pode responder à mensagem do WhatsApp com “sandbox stop” ou alternar para um Sandbox diferente enviando uma mensagem “join <other sandbox keyword>”.
Como convidar outros usuários para o Sandbox (OPCIONAL)
Para convidar outra pessoa para seu Sandbox, crie um link com o seguinte formato contendo a mensagem de aceitação e envie‐o para ela:whatsapp://send?phone=<Your Sandbox Number>&text=<your URL-encoded sandbox keyword>
Você também pode criar um código QR com o formato de link acima que os usuários podem ler no telefone para aceitar seu Sandbox.
Para enviar uma mensagem, use o código a seguir e substitua o parâmetro to (para) pelo número de telefone da sua conta WhatsApp pessoal no formato E.164. (Se você ainda não o fez, instale o WhatsApp em seu dispositivo e registre uma conta.) Para o parâmetro from (de), inclua o Identificador de canal whatsapp: antes do número do Sandbox no formato E.164.
Para o parâmetro From (De) você precisa do Sender ID (ID do remetente) que deve ser mostrado no canal instalado no Twilio Console, como mostrado anteriormente.
Receba e responda mensagens do WhatsApp
Quando alguém responder a uma de suas mensagens, você receberá uma solicitação webhook da Twilio.
Você pode configurar webhooks conectando seu Sandbox a um app que você já criou para lidar com mensagens recebidas ou criar um novo para mensagens do WhatsApp.
Esta solicitação webhook também é compatível com TwiML (Twilio Markup Language) como uma solicitação regular de Twilio SMS.
Para lidar com essa solicitação, você precisa configurar um aplicativo da web e exibi‐lo na Internet. O Início rápido de SMS para Node.js mostra como responder a uma mensagem e gerar TwiML em Node com Express.
E isso é tudo. Receber e responder é exatamente o mesmo que você faria em qualquer aplicativo SMS com nossa API de mensagens. Legal, não é?
Embora esses inícios rápidos mostrem como receber uma mensagem SMS, o webhook que a Twilio enviará incluirá os mesmos parâmetros de uma mensagem SMS recebida, com a exceção de que os endereços To (Para) e From (De) serão definidos para o número WhatsApp que recebe a mensagem (whatsapp:<E.164 formatted Twilio phone number associated with your business>) e o número de WhatsApp que envia a mensagem (whatsapp:<User’s E.164 phone number>), respectivamente.
Quais os próximos passos para WhatsApp e Node?
Como a API do WhatsApp da Twilio é essencialmente a mesma que a API de Programmable SMS da Twilio, toda a documentação dessa API vale para seus aplicativos que enviam e recebem mensagens com o WhatsApp. Para se aprofundar ainda mais com uma integração do WhatsApp, consulte a visão geral da documentação do WhatsApp assim como a Referência à API.
Aqui estão algumas áreas que você pode querer explorar em seguida.
- Envie lembretes de agendamento
- Crie conversas por SMS
- Visão geral da API de mensagens
- Navegue por outros tutoriais de SMS
Mal podemos esperar para ver que tipo de integração com o WhatsApp você criará!
Precisa de ajuda?
Às vezes, todos nós precisamos; a programação é difícil. Receba ajuda agora da nossa equipe de suporte, ou confie na sabedoria da multidão navegando pelo Stack Overflow Collective da Twilio ou buscando a tag Twilio no Stack Overflow.
