Integração de Chamadas SIP do WhatsApp

Visão Geral

O WhatsApp agora suporta chamadas SIP através da API WhatsApp Cloud, permitindo chamadas de voz usando SIP sobre TLS/SRTP.

Isso permite a integração nativa entre o WhatsApp e o 3CX, estendendo a integração existente apenas para mensagens para também suportar chamadas de voz do WhatsApp, que podem ser encaminhadas para ramais, filas, URAs ou Agentes de IA do 3CX.

Observe que a implementação atual para chamadas de voz suportará apenas chamadas recebidas do WhatsApp para o 3CX.

Esta integração requer Update 8 da V20.

Pré-requisitos

  • Para habilitar o WhatsApp SIP, é necessário ter um Aplicativo WhatsApp ativo no portal do Desenvolvedor da Meta com permissões de mensagens para o número de telefone comercial para o qual você deseja habilitar o SIP.
  • Se você ainda não tiver feito a configuração acima, siga as etapas explicadas em nosso Guia de integração do WhatsApp e obtenha seu ID de número de Telefone e Token de Acesso do Usuário explicado no guia acima, necessário para autenticar as solicitações exigidas à API Graph da Meta para habilitar o SIP.
  • Como a ativação de Chamadas SIP no aplicativo WhatsApp não está disponível no momento no portal da Interface do Usuário da Meta, você deve usar uma ferramenta de terceiros, como o Postman para enviar solicitações POST à API Graph da Meta.
  • Para integrar vários números de telefone do WhatsApp simultaneamente, cada número deve estar associado ao seu próprio aplicativo do WhatsApp no portal Meta for Developers. O processo de configuração detalhado neste guia, desde a criação de um aplicativo do WhatsApp até a configuração do Tronco SIP no 3CX, deve ser repetido para cada número de telefone do WhatsApp que você deseja integrar.
  • Você pode ler mais no Guia Oficial do WhatsApp SIP.

Etapa 1: Criar um Aplicativo WhatsApp

  • Se você já tiver o WhatsApp Messaging configurado no seu 3CX, pode pular esta etapa e obtenha seu ID de número de Telefone e Token de Acesso do Usuário a partir do seu WhatsApp já configurado no 3CX em Console de Admin > Voz e Chat > Seu Tronco de Mensagens WhatsApp
  • Caso contrário, siga as etapas explicadas em nosso Guia de integração do WhatsApp e obtenha seu ID de número de Telefone e Token de Acesso do Usuário

Etapa 2: Habilitar o SIP no seu número do WhatsApp

  • Envie a seguinte solicitação POST para a API Graph da Meta usando o curl ou qualquer outra ferramenta.
  • Você pode importar o comando curl diretamente para o Postman navegando até "Arquivo → Importar" e colando:

curl -X POST "https://graph.facebook.com/v24.0/<PHONE_NUMBER_ID>/settings" \

  -H "Authorization: Bearer <YOUR_ACCESS_TOKEN>" \

  -H "Content-Type: application/json" \

  -d '{

    "calling": {

      "status": "ENABLED",

      "callback_permission_status": "ENABLED",

      "call_icon_visibility": "DEFAULT",

      "srtp_key_exchange_protocol": "SDES",

      "sip": {

        "status": "ENABLED",

        "servers": [

          {

            "hostname": "<YOUR_3CX_FQDN>",

            "port": <YOUR_SIPS_PORT>

          }

        ]

      }

    }

  }'

  • Certifique-se de substituir os seguintes dados pelo seu próprio no comando acima antes de enviá-lo:
  • <PHONE_NUMBER_ID> = O ID do Número de Telefone que você obteve na Etapa 1 acima
  • <YOUR_ACCESS_TOKEN> = O Token de Acesso do Usuário que você obteve na Etapa 1 acima
  • <YOUR_3CX_FQDN> = Seu FQDN do PABX 3CX; por exemplo:  mypbx.3cx.com
  • <YOUR_SIPS_PORT> = Normalmente 5061 se o seu PABX estiver usando portas padrão
  • Se a solicitação for bem-sucedida:

{"success":true}

  • Você deve obter uma resposta de sucesso no curl

Resposta de sucesso no curl

  • Ou no Postman

Etapa 3: Verificar sua Configuração SIP

  • Envie a seguinte solicitação GET para a API Graph da Meta:

curl -X GET "https://graph.facebook.com/v17.0/<PHONE_NUMBER_ID>/settings?fields=calling&include_sip_credentials=true" \

  -H "Authorization: Bearer <YOUR_ACCESS_TOKEN>"

  • Certifique-se de substituir as seguintes informações pelo seu próprio dado no comando acima antes de enviá-lo:
  • <PHONE_NUMBER_ID> = O ID do Número de Telefone que você obteve na Etapa 1 acima
  • <YOUR_ACCESS_TOKEN> = O Token de Acesso do Usuário que você obteve na Etapa 1 acima
  • Se a solicitação for bem-sucedida, você deverá receber uma resposta semelhante à seguinte:

{

    "calling": {

        "status": "ENABLED",

        "call_icon_visibility": "DEFAULT",

        "callback_permission_status": "ENABLED",

        "srtp_key_exchange_protocol": "SDES",

        "sip": {

            "status": "ENABLED",

            "servers": [

                {

                    "app_id": 112233445566778,

                    "hostname": "pbx.3cx-example.com",

                    "port": 5061,

                    "sip_user_password": "aabbccddeeffgghhiijjkkllmmnnoopp"

                }

            ]

        }

    },

    "storage_configuration": {

        "status": "DEFAULT"

    }

}

  • No curl

Resposta de uma solicitação bem-sucedida

  • Ou no Postman

Etapa 4: Habilitar as Configurações de Chamadas no WhatsApp Business Manager

Selecionando número de telefone do WhatsApp

  • Abra a guia Configurações de Chamadas e certifique-se de ter ativado estas opções:
  • Permitir chamadas de voz
  • Permitir chamadas de retorno
  • Exibir botões de chamada

Etapa 5: Criar um Tronco SIP no 3CX

Para criar seu novo tronco SIP do WhatsApp:

  • Baixe o modelo do WhatsApp aqui
  • No seu Console de Admin 3CX, vá até "Admin → Avançado → Modelos → Modelos do Provedor"
  • Clique no botão Importar Provedor, selecione o modelo que você baixou acima e clique no botão Importar:

Criando um Tronco SIP no 3CX

  • Defina um Nome para o seu novo Tronco SIP do WhatsApp
  • Defina a rota Padrão para chamadas SIP do WhatsApp recebidas
  • Desmarque a caixa de seleção Criar uma regra de saída
  • Defina o Número do Tronco Principal como o seu número do WhatsApp
  • Deixe todos os outros campos com seus valores padrão
  • Clique no botão Salvar botão
  • Agora você poderá aceitar chamadas WhatsApp recebidas no seu número WhatsApp, que serão encaminhadas para o destino 3CX selecionado.

Como alternativa, você pode criar manualmente um tronco SIP Genérico no 3CX, certificando-se de usar a seguinte configuração:

  • Tipo de Autenticação: Baseado em IP
  • Host: wa.meta.vc
  • Porta: Descoberta automática
  • Protocolo de transporte: TLS
  • Modo SRTP: Imposição
  • Codecs: OPUS

Veja também

Última atualização

Este documento foi atualizado pela última vez em 28 de junho de 2026

https://www.3cx.com.br/docs/integracao-chamadas-sip-whatsapp/