You are viewing the Portuguese (Brazil) site, but your language preference is set to English. Switch to English site →

Menu

Expand
Rate this page:

API da Twilio para o início rápido do WhatsApp com 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 a sandbox da Twilio 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:

  1. Inscreva-se na Twilio e ative a Sandbox.
  2. Configure seu ambiente de desenvolvimento para enviar e receber mensagens
  3. Faça a inscrição (opt-in) para a Sandbox
  4. Envie sua primeira mensagem pelo WhatsApp
  5. Receba mensagens pelo WhatsApp
  6. Responda mensagens recebidas pelo WhatsApp
Mostre-me como se faz!

Inscreva-se na Twilio e ative a 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 a Sandbox da Twilio 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 na sandbox para ativá-lo.

WA_Sandbox.png

Anote o número de telefone escolhido na Sandbox. Você precisará disso mais tarde quando for o momento de enviar algumas mensagens.

Canal WhatsApp instalado! O que vem a seguir?

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.

  • SID da conta – Usado para autenticar solicitações à API REST
  • Token de autenticação – Usado para autenticar solicitações à API REST

Account Credentials

Para todos os nossos trechos de código e exemplos de cURL, você precisará autenticar com o SID da conta e o Token de autenticação.

Tudo certo, as credenciais da conta estão em mãos...

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.

O Node está pronto. Vamos escrever um código!

Envie uma mensagem com WhatsApp no Node.js

Como usar números predefinidos de sandbox

A sandbox é pré-provisionado com três números de telefone Twilio que são compartilhados entre todos os usuários. Para usar a sandbox você DEVE aceitar, enviando ao número de telefone escolhido uma mensagem do WhatsApp. Uma vez ativado, você só receberá mensagens de sua sandbox específica.

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 da Sandbox

Envie "join <your sandbox keyword>" para o número da Sandbox no WhatsApp para participar da sandbox e responderemos com uma confirmação de que você ingressou. Veja sua palavra-chave da sandbox no console.

Depois de ingressar, você receberá apenas mensagens da Sandbox específica. Para se desconectar da sandbox, você pode responder à mensagem do WhatsApp com `sandbox stop` ou alternar para uma sandbox diferente por mensagens “join <other sandbox keyword>“.

Screen Shot 2018-08-01 at 8.31.05 AM.png

Como convidar outros usuários para a sandbox (OPCIONAL)

Para convidar outra pessoa para sua 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 sua sandbox.

whatsapp-sandbox-opt-in-qr.png

Para enviar uma mensagem, use o código a seguir e substitua o parâmetro to 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 de , inclua o Identificador de canal whatsapp: antes do número da sandbox no formato E.164.

Para o parâmetro from você precisa do ID do remetente que deve ser mostrado no canal instalado no Twilio Console, como mostrado anteriormente.

        
        
        
        Ótimo! Agora, como recebo mensagens?

        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 sua Sandbox a um app que você já criou para lidar com mensagens recebidas ou criar um novo para mensagens do WhatsApp.

        Configure WhatsApp Sandbox Webhook

        Esta solicitação webhook também é comptatí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 o Twilio enviará incluirá os mesmos parâmetros de uma mensagem SMS recebida, com a exceção de que os endereços Para e De serão definidos para o número WhatsApp que recebe a mensagem (whatsapp:<E.164 número de telefone da Twilio formatado associado ao seu business>) e o número de WhatsApp enviando a mensagem (whatsapp:<User’s E.164 phone number>), respectivamente.

        Para onde ir em seguida?

        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.

        Mal podemos esperar para ver que tipo de integração com o WhatsApp você criará!

        Rate this page:

        Precisa de ajuda?

        Todos nós às vezes criamos; programação é difícil. Receba ajuda agora da nossa equipe de suporte, ou confie na sabedoria da multidão navegando pelos Fóruns da Comunidade da Twilio ou na tag Twilio no Stack Overflow.

              
              
              

              Obrigado pelo seu feedback!

              Não medimos esforços para melhorar nossa qualidade de documentação, e seu feedback é valioso para nós. Selecione o(s) motivo(s) para seu feedback ou forneça informações adicionais sobre como podemos melhorar:

              Enviando seu feedback...
              🎉 Obrigado pelo seu feedback!
              Algo deu errado. Tente novamente.

              Obrigado pelo seu feedback!

              Indique-nos e obtenha $10 em 3 etapas simples!

              Etapa 1

              Obtenha o link

              Obtenha um link de indicação pessoal gratuito aqui

              Etapa 2

              Dê $10

              Seu usuário se inscreve e faz a atualização usando o link

              Etapa 3

              Ganhe $10

              1.250 mensagens SMS grátis
              OU 1.000 min de voz grátis
              OU 12.000 chats
              OU mais