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:

Comece a usar o Twilio Sandbox para WhatsApp

Procurando um passo a passo para começar a usar a WhatsApp Business API da Twilio? Confira nosso guia de Início rápido, que está disponível em várias linguagens de programação.

Com o Twilio Sandbox para WhatsApp, você pode criar protótipos com o WhatsApp imediatamente, sem esperar que seu número de telefone da Twilio seja aprovado para o WhatsApp.

Para obter mais informações sobre o processo de integração, leia sobre como conectar seu Perfil do WhatsApp Business ao seu número de telefone da Twilio.

O que é o Twilio Sandbox para WhatsApp?

O Twilio Sandbox para WhatsApp é um ambiente pré‐configurado disponível por meio do console da Twilio, no qual você pode criar protótipos de envio de mensagens de saída, resposta a mensagens recebidas e configuração de itens como retornos de chamada de entrega de mensagens. Embora você tenha que esperar que seu Perfil do WhatsApp Business seja vinculado ao seu número de telefone da Twilio, é uma forma rápida de testar a funcionalidade da WhatsApp Business API da Twilio.

O Sandbox é pré‐provisionado com um número de telefone da Twilio (+1-415-523-8886) que é compartilhado entre todos os usuários do Sandbox. No entanto, outros usuários que compartilham o mesmo número do Sandbox não receberão suas mensagens, apenas aqueles que aceitaram seu Sandbox.

The Twilio Sandbox for WhatsApp screenshot

Esteja ciente de que o Twilio Sandbox para WhatsApp é destinado apenas para fins de teste e descoberta. Ele não deve ser usado para produção.

Como participar de um Twilio Sandbox

Para enviar ou receber mensagens do WhatsApp para um usuário final do Sandbox, algum usuário precisa ter ingressado no Sandbox primeiro.

Primeiro, envie a mensagem "senha para ingressar <no seu Sandbox>" para seu número de telefone do Sandbox no WhatsApp para ingressar no seu Sandbox. Sua senha do Sandbox é uma string exclusiva; você pode encontrá‐la no console da Twilio.

Quando a Twilio receber a mensagem ingressar, responderemos com uma confirmação para esse usuário de que ele ingressou no Sandbox.

Ao ingressar em seu Sandbox, os usuários finais receberão mensagens somente do seu Sandbox específico. Para se desconectar do Sandbox, eles podem responder à mensagem do WhatsApp com a palavra "parar". Você pode alternar para um Sandbox diferente usando a mensagem "senha para ingressar < em outro Sandbox>".

Observe que o Sandbox expira três (3) dias após o ingresso. Após esse período, você deve ingressar novamente para continuar o teste.

A opção para uma limitação do Sandbox não existe em seu próprio número de telefone da Twilio habilitado para o WhatsApp.

Modelos de Sandbox

Não é possível usar modelos de notificação personalizados do WhatsApp com o Twilio Sandbox. Em vez disso, o Twilio Sandbox para WhatsApp vem com três modelos pré‐configurados para fins de teste.

Para configurar e usar modelos de notificação, será necessário registrar um número de telefone da Twilio no WhatsApp.

Uma das restrições das mensagens do WhatsApp é a sessão ou período de 24 horas. Quando um usuário final envia uma mensagem à sua empresa, ele inicia um período de 24 horas durante o qual você pode enviar mensagens de saída de forma livre. Fora desse período, você deve usar mensagens modeladas para iniciar mensagens de saída com um usuário final. (Confira nosso guia para notificações e modelos do WhatsApp.)

O Sandbox vem pré‐configurado com três modelos para casos de uso comuns:

  • Lembretes de agendamento: "Seu agendamento está próximo em {{1}} às {{2}}"
  • Notificações de pedidos: "Seu pedido {{1}} de {{2}} foi enviado e deve ser entregue em {{3}}. Detalhes: {{4}}"
  • Códigos de verificação: "Seu código {{1}} é {{2}}"

(Os números com colchetes duplos se referem às suas informações específicas na mensagem de notificação, como "Seu código Twilio é 1238432")

No Sandbox, você pode testar a realização de chamadas para a API Programmable Messaging (Mensagens programáveis) da Twilio para enviar um (ou mais!) dessas mensagens de saída.

Responda às mensagens recebidas com o Twilio Sandbox

Pessoas de todo o mundo usam o WhatsApp para interagir com empresas, e seu caso de uso pode envolver a resposta a mensagens recebidas de usuários finais. Você pode usar o Twilio Sandbox para explorar respostas às mensagens recebidas do WhatsApp.

Quando um usuário final envia a você uma mensagem por WhatsApp, a Twilio envia um webhook (uma solicitação para um URL que você especificar) para seu aplicativo. No Sandbox, você pode configurar esse URL do webhook no campo Quando uma mensagem chega:

standbox_incoming_callback_field.jpg

Muito provavelmente, você definirá o URL do webhook de entrada para o URL do seu aplicativo da Web. Quando a Twilio recebe uma mensagem do WhatsApp em seu Sandbox, ela faz uma solicitação para esse URL. Você pode responder à mensagem usando TwilML, que é o idioma das instruções para como a Twilio deve responder à sua mensagem. (Para obter um guia detalhado sobre como configurar um aplicativo para responder com o TwiML no idioma de sua escolha, confira Início rápido para a API da Twilio para WhatsApp.)

Defina um URL de retorno de chamada de status para rastrear a entrega de mensagens

Você pode testar a funcionalidade de atualização de status em tempo real da Twilio para mensagens do WhatsApp que você envia e recebe com o Sandbox. Nas configurações do seu Sandbox, adicione um URL no campo URL de retorno de chamada de status. A Twilio envia uma solicitação a esse URL toda vez que o status da mensagem muda para um dos seguintes: queued, failed, sent, delivered, read.

The Status Callback URL field inside the Twilio Sandbox for WhatsApp

Ao configurar o URL de retorno de chamada de status, você pode receber automaticamente solicitações da Twilio com informações sobre o status de entrega da sua mensagem do WhatsApp. Para obter um passo a passo mais detalhado, consulte o guia de SMS para acompanhar o status de entrega. O canal de mensagens é diferente, mas os princípios são os mesmos. Lembre‐se de colocar o URL para o retorno de chamada de status no Sandbox.)

Limitações do Twilio Sandbox

Como o Twilio Sandbox para WhatsApp é feito para criação rápida de protótipos em vez de uso pronto para produção, ele tem algumas limitações:

  • Você só pode enviar mensagens aos usuários finais que ingressaram em seu Sandbox. O sistema de mensagens para outros usuários irá falhar com o Erro 63015.
  • O Twilio Sandbox oferece suporte a testes funcionais, mas não testes de carga de tráfego de perfil.
  • Os números de telefone do Sandbox são restritos a 1 mensagem a cada 3 segundos.
  • Os números do Sandbox são marcados como números de telefone da Twilio, ou seja, com o logotipo da Twilio.
  • Você só pode usar modelos pré‐registrados no Sandbox para mensagens de saída enviadas fora de uma sessão do WhatsApp. (Saiba mais sobre como usar e registrar modelos de mensagem do WhatsApp.)
  • A sessão do Sandbox expira três (3) dias após o ingresso. Depois disso, siga as etapas descritas acima para ingressar novamente.

Não há limite para a quantidade de mensagens que você pode enviar por meio do Twilio Sandbox, nem qualquer limite de tempo de uso do Sandbox. As mensagens do Sandbox são cobradas como de costume, de acordo com o preço da API da Twilio para WhatsApp.

O que vem a seguir?

Agora que você foi apresentado ao Twilio Sandbox para WhatsApp, pode começar a criar protótipos integrando o WhatsApp com o Twilio Programmable Messaging (Mensagens programáveis) e seu aplicativo.

Você também pode ler mais sobre alguns dos conceitos abordados neste documento seguindo os links abaixo:

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