Como usar uma conta de sandbox para fazer ligações

• Iniciar e receber ligações usando a API de Ligações
• Validar eventos de webhook de ligações
• Simular fluxos de integração sem criar ativos de negócios reais

1. Navegue até o Painel de Apps.
2. Clique no app que você está usando com o WhatsApp.
3. Selecione Casos de uso (ícone de lápis) na barra lateral.
4. Em Conectar-se com clientes pelo WhatsApp, clique em Personalizar.
5. No menu à esquerda, selecione Ferramentas para parceiros.
6. Na seção Obter conta de sandbox, em Recursos, clique no menu suspenso. Selecione API de Nuvem e ligações.
7. Clique em Obter conta de sandbox.
8. Em Habilitar funcionalidade de ligação, clique no menu suspenso e depois em Gerenciar lista de números de telefone.
9. Adicione seu número de telefone como destinatário.

1. Na mesma página, em Personalize um novo fluxo de integração, clique em Começar para abrir a experiência de Cadastro Incorporado.
   • Observação: mantenha esta aba aberta e disponível, pois você a usará várias vezes ao longo do processo.
2. Na seção Início do Cadastro Incorporado, verifique se o menu suspenso Recursos está vazio e clique em Entrar com o Facebook.
3. Uma notificação pop-up com a experiência de Cadastro Incorporado será exibida. Em Portfólio empresarial, selecione Sandbox Business.
4. Preencha o restante das informações necessárias e clique em Avançar.
5. Na próxima tela, no menu suspenso Crie ou selecione um perfil do WhatsApp Business, selecione Número de teste.
6. Quando o fluxo de login for concluído, na seção Trocar token, clique em Obter token.
   • Observação: guarde esse token para uso futuro com a API da conta de sandbox.
7. Na seção Obtenha a conta do WhatsApp Business compartilhada, clique em Obter detalhes da conta do WhatsApp Business.
8. Em Campo da conta do WhatsApp Business, copie o valor da linha id.
   • Observação: guarde essa identificação, pois ela é a identificação da conta do WhatsApp Business do sandbox.
9. Na seção Obter números de telefone, clique em Obter números de telefone.
10. Em Identificação, copie o valor.
    • Observação: guarde essa identificação, pois ela é a identificação do número de telefone usado como número de teste da sua conta de sandbox.

• A string do token da sua conta de sandbox
• A identificação da conta do WhatsApp Business da sua conta de sandbox
• A identificação do seu número de telefone de teste

• Observação: mantenha esta janela aberta, pois você usará novamente a configuração criada nas etapas posteriores deste guia.

1. Navegue até a ferramenta Explorador da Graph API.
2. Verifique se você está usando a versão mais recente da API.
3. Clique em Gerar token de acesso e siga as instruções.
4. Em Permissões, adicione as permissões whatsapp_business_management e whatsapp_business_messaging.
5. No configurador de ponto de extremidade, insira /<YOUR_SANDBOX_WABA_ID>/subscribed_apps e clique em Enviar.

{
  "success": true
}

1. Depois, registre o número de telefone de teste inserindo /<YOUR_SANDBOX_TEST_PHONE_NUMBER_ID>/register no configurador de ponto de extremidade.
2. Na barra lateral esquerda, clique em JSON e insira o seguinte corpo JSON. Depois, clique em Enviar:

{
  "messaging_product": "whatsapp",
  "pin": "123456"
}

1. Você receberá uma resposta padrão success:

{
  "success": true
}

1. Na ferramenta Explorador da Graph API, insira /<YOUR_SANDBOX_TEST_PHONE_NUMBER_ID>/messages no configurador de ponto de extremidade.
2. Na barra lateral esquerda, clique em JSON e insira o seguinte corpo JSON. Depois, clique em Enviar:

{
  "messaging_product": "whatsapp",
  "to": "YOUR_NUMBER", // Replace this value with phone number of your device.
  "type": "template",
  "template": {
    "name": "hello_world",
    "language": { "code": "en_US" }
  }
}

1. Você receberá uma resposta com o valor "message_status": "accepted" e deverá receber uma mensagem de texto no seu dispositivo.

• Navegue até o Painel de Apps.
• Clique no app que você está usando com o WhatsApp.
• Selecione Casos de uso (ícone de lápis) na barra lateral.
• Em Conectar-se com clientes pelo WhatsApp, clique em Personalizar.
• Na barra lateral esquerda, clique em Configuração.
• Em URL de retorno de chamada, adicione o URL de retorno de chamada do servidor do webhook.
  • Se você não tiver um servidor de webhook, siga as nossas instruções para criar um servidor de webhook de teste.
• Em Verificar token, adicione uma string de verificação arbitrária.
• Clique em Verificar e salvar.
• Na próxima página, no menu suspenso Selecionar produto, clique em Conta do WhatsApp Business.
• Em Campos de webhook, na linha Ligações, clique no botão de alternância para se inscrever no campo de webhook calls.

1. Na ferramenta Explorador da Graph API, insira /<YOUR_SANDBOX_TEST_PHONE_NUMBER_ID>/settings no configurador de ponto de extremidade.
2. Na barra lateral esquerda, clique em JSON e insira o seguinte corpo JSON. Depois, clique em Enviar:

{
  "calling": {
    "status": "ENABLED",
    "call_icon_visibility": "DEFAULT",
    "callback_permission_status": "ENABLED"
  }
}

1. Você receberá uma resposta padrão success:

{
  "success": true
}

1. Por fim, em Token de acesso, copie o token de acesso para uso futuro.
   • Observação: guarde esse token de acesso, pois você o usará para fazer chamadas de API ao testar a integração da API de Ligações.

1. No dispositivo cliente, abra o WhatsApp.
2. Navegue até a conversa que você criou com o número de telefone comercial da sua conta de sandbox.
3. Na parte superior da tela, toque no número de telefone comercial da sua conta de sandbox.
4. Role a tela para baixo e toque em Permissão para ligações da empresa.
5. Toque em Permitir ligações.

1. No dispositivo cliente, abra o WhatsApp.
2. Navegue até a conversa que você criou com o número de telefone comercial da sua conta de sandbox.
3. Toque no ícone de telefone no canto superior direito da tela para ligar para o número de telefone comercial da sua conta de sandbox.
4. Confirme que a ligação foi estabelecida com sucesso.