Receba Ligações no WhatsApp Oficial: Conecte sua API a um Tronco SIP (Tutorial Completo)

---

Bora pra ação, galera! Você sabia que agora é possível receber ligações de voz diretamente no seu número da API Oficial do WhatsApp? Neste tutorial, vamos conectar sua conta a um tronco SIP, permitindo que você centralize mais um canal de comunicação e atenda seus clientes de forma integrada.

Vamos passar por todo o passo a passo, desde a configuração no painel da Meta até a execução do comando para ativar a rota. O melhor? Tudo que você precisa está aqui!

O Que Você Vai Precisar (Pré-requisitos)

Antes de começarmos, garanta que você já tenha o seguinte ambiente preparado:

• Uma API Oficial do WhatsApp (WABA) Ativa: Você precisa ter um número de telefone já configurado e funcionando através de um App no painel Facebook for Developers.
• Um Ambiente de Telecomunicações (SIP): É necessário ter um servidor Asterisk, FreePBX ou qualquer outra solução de telefonia que forneça um tronco SIP. É para este servidor que o WhatsApp irá encaminhar as chamadas.
• Acesso ao seu App da Meta: Você precisará do seu Token de Acesso e do ID do Número de Telefone (Phone Number ID).

Passo 1: Ative o Webhook de Chamadas (Calls) no seu App

O primeiro passo é dizer à Meta que você deseja receber eventos de chamada. Siga as instruções:

1. Acesse o painel do seu aplicativo em Facebook for Developers.
2. No menu lateral, navegue até WhatsApp > Configuração (Configuration).
3. Na seção de Webhooks, clique em "Editar".
4. Você verá uma lista de campos de webhook disponíveis para assinatura. Procure por calls e marque a caixa de seleção.
5. Salve as alterações.

Com isso, seu aplicativo está pronto para processar eventos de chamada.

Passo 2: Configure a Rota SIP via API

Agora, vamos informar à Meta qual é o endereço do seu servidor SIP. Faremos isso através de uma chamada de API. Você pode usar ferramentas como o Postman ou simplesmente executar o comando curl que preparamos para você em um terminal.

O comando realiza uma requisição POST para o endpoint da Meta, enviando seu hostname SIP e a porta que deve receber a chamada.

O Comando Mágico

Copie o comando abaixo, substitua os placeholders com suas informações e execute-o em um terminal (Bash, PowerShell, etc.).

curl -X POST \
'https://graph.facebook.com/v20.0/SEU_PHONE_NUMBER_ID_AQUI/settings?sip_credentials=true' \
-H 'Authorization: Bearer SEU_TOKEN_AQUI' \
-H 'Content-Type: application/json' \
-d '{
  "hostname": "SEU_HOSTNAME_SIP_AQUI",
  "port": 5061
}'

Onde encontrar cada informação:

• SEU_PHONE_NUMBER_ID_AQUI: Encontrado no painel do seu App, em WhatsApp > Getting Started.
• SEU_TOKEN_AQUI: É o seu token de acesso permanente, também gerado no painel da Meta.
• SEU_HOSTNAME_SIP_AQUI: O endereço IP ou domínio do seu servidor Asterisk/FreePBX.
• "port": 5061: A porta configurada no seu tronco SIP para receber as chamadas. Altere se a sua for diferente.

Se tudo der certo, a API retornará uma resposta simples: {"success":true}. Pronto! Sua rota SIP está configurada.

Como Funciona na Prática?

Após a configuração, quando um cliente ligar para o seu número do WhatsApp, a Meta irá encaminhar essa chamada para o hostname:porta que você definiu. A partir daí, seu servidor Asterisk assume o controle, e você pode rotear a chamada para um softphone (como o MicroSIP), um webphone integrado (como em nossa plataforma Z-PRO) ou para qualquer outro ramal da sua rede.

Vale lembrar que o WhatsApp cobra por minuto para essas chamadas. Consulte sempre a tabela de preços oficial da Meta para se manter atualizado.

Quer uma Solução Omnichannel Completa? Conheça o Z-PRO!

Em nossa plataforma SaaS Z-PRO, toda essa configuração é feita de forma visual e simplificada. Você pode conectar seu número oficial, configurar o SIP diretamente no painel e atender as ligações no nosso webphone integrado, unificando todos os seus canais — WhatsApp, Instagram, Facebook, E-mail, Chat e agora, voz — em um único lugar.

Se você quer entrar para o mundo de revendas de plataformas de multiatendimento, com desenvolvimento ativo e suporte dedicado, venha conhecer o Z-PRO. E para aprender mais sobre o universo das APIs, junte-se à Comunidade ZDG, a maior do mundo sobre o assunto!

Qualquer dúvida, é só chamar. Tamo junto!