Chamadas pelo WhatsApp Business

Chamadas do WhatsApp Business

Conecte sua Conta do WhatsApp Business (WABA) ao Finn para que os usuários possam fazer chamadas de voz para sua empresa diretamente no WhatsApp — atendidas por um agente Finn e cobradas por minuto, como qualquer outra chamada.

As chamadas do WhatsApp Business (a camada de voz do WhatsApp da Meta, lançada em 2024) funcionam sobre a Cloud API. Para o usuário, é um toque no botão de chamada dentro do chat da sua empresa. Para você, é uma chamada de entrada normal do Finn.

O que você ganha

• Voz de entrada de qualquer usuário do WhatsApp no mundo todo
• Nenhum número novo a provisionar — usa o ID do número de telefone da sua WABA
• O agente Finn atende com o mesmo prompt, voz e fluxo de trabalho das chamadas de entrada normais
• Gravação, transcrição e análises idênticas às chamadas de entrada por PSTN
• Custo por minuto menor que o de chamadas de entrada internacionais por PSTN em várias regiões

Pré-requisitos

Antes de conectar:

1. Uma Conta Comercial da Meta verificada com a Plataforma WhatsApp Business habilitada
2. Um número de telefone da WABA regularizado (não o app WhatsApp de consumidor — o número da Cloud API)
3. Verificação da empresa aprovada pela Meta (obrigatória para chamadas)
4. Uma organização Finn no plano Pro ou superior (o Starter não inclui chamadas do WhatsApp)
5. O recurso Calling API explicitamente habilitado na sua WABA — a Meta controla esse acesso. Solicite em Meta Business → WhatsApp Manager → API Settings → Calling

Configuração (5 etapas)

1. Habilitar chamadas na WABA

Em Meta Business Suite → WhatsApp Manager → Phone Numbers → [seu número] → Settings → Calling:

• Ative Enable inbound calling como On
• Defina Default action como Forward to API
• Salve

2. Gerar um token de acesso permanente de usuário do sistema

Em Meta Business → Business Settings → System Users:

• Crie um usuário do sistema (ou reutilize um existente)
• Gere um token com os escopos: whatsapp_business_management, whatsapp_business_messaging
• Trate o token como uma senha — nunca faça commit dele e faça rotação trimestral

3. Conectar dentro do Finn

Dashboard → Settings → Integrations → WhatsApp → Connect.

Cole:

• phone_number_id (do WhatsApp Manager)
• waba_id (o ID da Conta do WhatsApp Business)
• Token de acesso do usuário do sistema

O Finn valida o token chamando /v18.0/{phone_number_id} e informa o status na própria tela.

4. Vincular um agente Finn

Nessa mesma tela, escolha qual Finn atende as chamadas do WhatsApp. Você pode:

• Fixar um agente para todas as chamadas de entrada do WhatsApp — o mais simples
• Roteie dinamicamente pelo webhook de entrada — agentes diferentes por chamador, país ou tag de campanha

5. Testar

Envie qualquer mensagem de teste no WhatsApp para o seu número WABA a partir de uma conta pessoal e toque no botão de chamada. O agente Finn deve atender em 2–3 segundos.

Se a chamada cair imediatamente, o recurso de chamadas não está totalmente aprovado — verifique o banner de habilitação de chamadas da Meta no WhatsApp Manager.

Comportamento em comparação com chamadas PSTN de entrada

Identificação do chamador

O payload do webhook de entrada inclui campos específicos do WhatsApp:

{
  "session_id": "ws_2H4abc",
  "channel": "whatsapp",
  "from": {
    "wa_id": "919876543210",
    "display_name": "Priya M",
    "profile_pic_url": "https://..."
  },
  "to_phone_number_id": "104382715924563",
  "started_at": "2026-05-22T14:30:00Z"
}

wa_id é o identificador do chamador no WhatsApp (normalmente o número de telefone em E.164 sem o +). Use-o como chave de busca no seu CRM da mesma forma que usaria caller_id para PSTN.

Preços

As chamadas de entrada pelo WhatsApp são cobradas no mesmo modelo de créditos de IA do Finn que as chamadas PSTN de entrada:

• Chamada atendida: cobrança por pulso, por minuto, com mínimo de 1 min
• Sem sobretaxa de operadora — a Meta cuida do trecho de rede
• Sem taxa de configuração por chamada

Consulte Carteira e créditos de IA para ver a fórmula completa de cobrança por pulso.

Limitações

• Somente entrada (restrição da Meta a partir de 2026). Não é possível ligar para usuários do WhatsApp a partir do Finn.
• Um Finn por ID de número de telefone por vez — embora o roteamento dinâmico via webhook de entrada permita alternar agentes a cada chamada.
• Correio de voz ainda não suportado — chamadas perdidas caem sem deixar mensagem.
• A disponibilidade varia por região — a Meta ainda está liberando o recurso de chamadas por país. Verifique seu status em WhatsApp Manager → API Settings.

Conformidade

• Aviso de gravação — valem as mesmas regras da PSTN. Índia, UE e partes dos EUA exigem informar que a chamada está sendo gravada. Configure a mensagem de boas-vindas do Finn para incluir o aviso.
• Consentimento — ao tocar no botão de chamada no WhatsApp, o usuário iniciou a ligação — o consentimento expresso fica implícito naquela sessão. Ainda é necessário consentimento separado para retornar a ligação via PSTN.
• Residência de dados — a Meta processa o áudio na região dela. Se sua organização tem requisitos rígidos de residência, avalie antes de ativar.

FAQ

P: Meu agente Finn atual consegue atender chamadas do WhatsApp sem alterações? R: Sim. O prompt, a voz e o fluxo de trabalho do agente são os mesmos. Basta vinculá-lo na tela de integração do WhatsApp.

P: Quem liga pelo WhatsApp percebe que está falando com uma IA? R: A identidade do seu Finn é a que você configurou (ex.: "Aria, da Smile Dental"). Se perguntarem diretamente, o agente deve informar que é uma IA — mesma regra de conformidade da PSTN.

P: Posso encaminhar chamadas do WhatsApp para um atendente humano? R: Sim — o mecanismo de transferência assistida do Finn funciona da mesma forma. A chamada transferida chega a um número PSTN configurado.

P: Qual a diferença em relação aos links de clique para ligar do WhatsApp? R: O clique para ligar abre o discador do telefone do usuário com um número PSTN. O WhatsApp Business Calling permanece dentro do app do WhatsApp e usa a infraestrutura de voz da Meta — são superfícies totalmente diferentes.

Solução de problemas

Relacionados

• Números de telefone →
• Webhooks de entrada →
• Webhooks pós-chamada →
• Conformidade →
• Carteira e créditos de IA →