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

Menu

Expand
Classifique esta página:

Programmable Messaging para o Início rápido do WhatsApp para cURL

Com apenas algumas linhas de código, seu aplicativo pode enviar e receber mensagens com o WhatsApp usando a API da Twilio para WhatsApp e cURL.

Este Início rápido do WhatsApp ensinará como fazer isso usando o Twilio Sandbox para WhatsApp, cURL, a API da Twilio para WhatsApp e uma estrutura Web de sua escolha.

Neste início rápido, você aprende a:

  1. Inscreva‐se na Twilio e ative o Sandbox.
  2. Configure seu ambiente de desenvolvimento para enviar e receber mensagens
  3. Faça a inscrição (opt-in) para o 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 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.

WA_Sandbox.png

Anote o número de telefone escolhido no 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.

  • 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

Account Credentials

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).

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

Configurar o “ambiente de desenvolvimento”

cURL deve funcionar por padrão em um terminal Linux ou macOS recente. Se você estiver usando o Windows, poderá encontrar os pacotes cURL já compilados aqui.

Estou pronto para escrever um código!

Envie uma mensagem com WhatsApp e cURL

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>”.

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

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.

whatsapp-sandbox-opt-in-qr.png

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.

        
        
        
        Use cURL para enviar uma mensagem com o WhatsApp

        Envie uma mensagem com WhatsApp e cURL

        Use cURL para enviar uma mensagem com o WhatsApp
        Ó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 seu 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 é compatível com TwiML (Twilio Markup Language) como uma solicitação regular de Twilio SMS.

        Embora tenhamos certeza de que é possível executar um servidor a partir de sua linha de comando, preferimos que você use uma linguagem com mais foco na Web neste momento. Para lidar com essa solicitação, você precisa configurar um aplicativo da web e exibi‐lo na Internet. Os seguintes Inícios rápidos de SMS mostram como responder a uma mensagem e gerar TwiML em sua linguagem de preferência (segunda?).

        Se você é um desenvolvedor Node, também poderá hospedar este aplicativo da Web com o Twilio Functions.

        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.

        Para onde ir em seguida?

        Quais os próximos passos para o WhatsApp e o cURL?

        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á!

        Classifique esta página:

        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.

              
              
              

              Obrigado pelo seu feedback!

              Selecione o(s) motivo(s) para seu feedback. As informações adicionais que você fornece nos ajudam a melhorar nossa documentação:

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

              Obrigado pelo seu feedback!

              Indique‑nos e obtenha USD10 em 3 etapas simples!

              Etapa 1

              Obtenha o link

              Obtenha um link de indicação pessoal gratuito aqui

              Etapa 2

              Dê USD10

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

              Etapa 3

              Obtenha USD10

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