O módulo Testes em Sandbox foi projetado para oferecer e simplificar o processo de teste das nossas APIs.
Ele oferece um ambiente seguro onde desenvolvedores realizam testes rápidos das APIs multicanais antes de implementar as integrações em seus ambientes de produção. Por isso, os testes demandam conhecimento técnico e é importante contar com a ajuda de um desenvolvedor.
Explore a documentação abaixo para aprender como testar em Sandbox e aprimorar seu ciclo de desenvolvimento. É possível realizar testes nos seguintes canais:
- RCS.
- Instagram.
- Facebook.
- Whatsapp.
- Telegram.
⚠️ Atenção: não será possível criar testes para os canais já contratados e nem para aqueles que já estão sendo testados no Sandbox.
Criar novo teste em Sandbox
Independente do canal escolhido, o processo de criação de um novo teste é baseado em quatro etapas: Selecione o canal > Inclua os contatos > Envie uma mensagem > Configure um Webhook.
Veja o tutorial abaixo:
No menu lateral, acesse Configurações > Testes em Sandbox > Criar novo teste;
Selecione o Canal que deseja testar e clique em Próximo.
Inclua os contatos. Leia o QR Code exibido e envie a palavra-chave fornecida na tela para o bot. Após incluir ao menos um contato, a tela atualiza e exibe a mensagem de que você está habilitado para enviar mensagens de teste. Nela, há um botão de QR do lado esquerdo acima dessa mensagem. Clique nele caso deseje adicionar mais contatos. Finalize em Próximo;
Para testes no RCS, a etapa de incluir contatos consiste apenas em digitar o seu telefone, clicar em enviar a mensagem e responder clicando no botão de Accept no aplicativo habilitado para RCS em seu telefone.
Envie uma mensagem. Escolha o número de contato no campo Para > Digite a Mensagem a ser enviada > Clique em Enviar mensagem;
Nessa tela, há dois campos abaixo de Enviar mensagem:
Request: É a mensagem enviada para o bot. Inclui dados como o tipo de mensagem, o conteúdo da mensagem e outros parâmetros específicos do canal escolhido.
Response: É a resposta do bot à mensagem enviada. Aqui, você pode analisar como o bot processa e responde à sua mensagem de teste.
💡 Dica: Para testes no canal Whatsapp, há uma aba denominada Template, localizada ao lado de Mensagem. Nela você pode escolher um dos templates disponibilizados no campo Configuração e preencher as variáveis solicitadas no modelo.
5. Configure um Webhook. Nessa última etapa, você pode configurar Webhooks para receber informações sobre eventos e status de mensagens.
Utilize o campo Message Webhook URL se quiser receber informações sobre novas mensagens, e o campo Status Webhook URL se quiser saber os status das mensagens enviadas (enviada, entregue ou recusada).
Em seguida, clique em Finalizar para encerrar o teste. Em caso de dúvidas sobre Webhooks, acesse o artigo Tokens & Webhooks para usar nas APIs.