Skip to main content

Chamadas pelo WhatsApp Business

Receba chamadas de voz do WhatsApp em um agente Finn.

6 min read

Chamada de Negócios WhatsApp

Conecte sua WhatsApp Business Account (WABA) ao Finn para que os usuários possam colocar chamadas de voz no seu negócio diretamente dentro do WhatsApp — respondido por um agente Finn, faturado por minuto como qualquer outra chamada.

WhatsApp Business Calling (a superfície de voz-over-WhatsApp da Meta, lançada em 2024) fica no topo da nuvem API. Do lado do usuário é um toque no botão de chamada dentro do seu bate-papo de negócios. Do teu lado é uma chamada normal Finn.

O que você ganha

  • ** Voz de entrada de qualquer usuário do WhatsApp** em todo o mundo
  • ** Nenhum novo número para provisão** — usa o seu WABA telefone-número de identificação existente
  • Finn respostas do agente com o mesmo prompt, voz e fluxo de trabalho que o seu acesso regular
  • Gravação + transcrição + análise idêntica à entrada PSTN
  • ** Baixo custo por minuto** do que a entrada internacional de PSTN em muitas regiões

Pré-requisitos

Antes de poder ligar-se:

  1. A Verified Meta Business Account com a ** WhatsApp Business Platform** habilitada
  2. Um número de telefone WABA em boa posição (não o aplicativo WhatsApp do consumidor — o número Cloud API)
  3. ** Verificação de negócios** aprovada pela Meta (necessária para chamada)
  4. A Finn org on Pro ou superior (Iniciar não inclui WhatsApp chamando)
  5. A capacidade Chamar API explicitamente ativada em seu WABA — Meta porta isso. Solicitar acesso em Meta Business → WhatsApp Manager → API Configurações → Chamada

Configurar (5 passos)

1. Habilitar chamada em WABA

Em Meta Business Suite → WhatsApp Manager → Números de telefone → [seu número] → Configurações → Chamada:

  • Alternar ** Habilitar chamada de entrada** para On
  • Definir Acção padrão para Avançar para API
  • Gravar

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

Em Meta Business → Configurações de Negócios → Usuários do sistema:

  • Criar um usuário do sistema (ou reutilizar um)
  • Gerar um símbolo com escopos: whatsapp_business_management, whatsapp_business_messaging
  • Trate o token como uma senha — nunca commit, gire trimestralmente

3. Conecte-se dentro Finn

Dashboard → Configurações → Integrações → WhatsApp → Connect.

Colar:

  • phone_number_id (do WhatsApp Manager)
  • waba_id (O ID da conta comercial do WhatsApp)
  • Token de acesso do usuário do sistema

Finn valida o token batendo /v18.0/{phone_number_id} e relata o status em linha.

4. Prenda um agente Finn

Na mesma tela, escolha o Finn que responde chamadas WhatsApp. Você pode:

  • ** Pin one agent for all WhatsApp inbound** — simple
  • Route dinamicamente via inbound webhook — diferentes agentes por chamada, país ou tag de campanha

5. Teste

Envie qualquer mensagem de teste no WhatsApp para o número WABA de uma conta pessoal e, em seguida, toque no botão de chamada. O agente Finn deve responder em 2-3 segundos.

Se a chamada cair imediatamente, a capacidade de chamada não é totalmente aprovada — verifique o banner de ativação de chamadas da Meta no WhatsApp Manager.

Comportamento comparado com a entrada do PSTN

Aspect . PSTN inbound

Tempo de instalação 5 min (número de aluguer) 30-60 min (Aprovação Meta) ID do chamador número de telefone + nome de exibição do WhatsApp □ Custo internacional □ Variações (alta fora do país de origem) Gravação padrão padrão (notificar chamador por lei local) Ainda não — Metacaps Sim (total PSTN) Limites simultâneos de capacidade por número

Identificação do chamador

A carga útil do webhook inbound 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 WhatsApp do chamador (tipicamente seu número de telefone em E.164 menos o +). Use-o como a chave de pesquisa contra o seu CRM da mesma forma que você usaria caller_id para PSTN.

Preços

WhatsApp inbound é faturado no mesmo modelo de crédito Finn AI como PSTN inbound:

  • ** Chamada de escolha:** de impulso a cada minuto, mínimo de 1 minuto
  • ** Nenhuma sobretaxa transportadora** — Meta manuseia a parte da rede
  • ** Nenhuma taxa de configuração por chamada**

Ver Wallet & AI Credits para a fórmula de redução de impulsos.

Limitações

  • ** Inbound only** (Restrição Meta a partir de 2026). Você não pode discar usuários do WhatsApp de Finn.
  • ** Um Finn por número de telefone ID de cada vez** — embora roteamento dinâmico através do inbound webhook permite que você mude de agente por chamada.
  • Voicemail ainda não suportado — chamadas perdidas sem mensagem.
  • A disponibilidade da região varia — Meta ainda está rolando Chamada por país. Verifique WhatsApp Manager → API Configurações para o seu status.

Cumprimento

  • Recording disclosure — aplicam-se as mesmas regras que a PSTN. Índia, UE, partes dos EUA exigem que a chamada seja divulgada. Configure a mensagem de boas-vindas do Finn para incluir a divulgação.
  • Consente — ao tocar no botão de chamada no WhatsApp, o usuário iniciou a chamada — o consentimento expresso está implícito para essa sessão. Você ainda precisa de consentimento separado para chamá-los de volta via PSTN.
  • ** Residência de dados** — Meta processa o áudio em sua região. Se sua org tem requisitos de residência rigorosos, avaliar antes de habilitar.

FAQ

Q: Meu agente Finn existente pode responder chamadas WhatsApp sem alterações? R: Sim. O prompt de agente, voz e fluxo de trabalho são os mesmos. Basta ligá-lo na tela de integração do WhatsApp.

** Q: As chamadas do WhatsApp vêem que estão a falar com a IA?** R: A identidade do seu Finn é o que você configurou (por exemplo, "Aria from Smile Dental"). Se solicitado diretamente, o agente deve divulgar o status de IA — mesma regra de conformidade que PSTN.

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

Q: Como isso difere dos links do clique-to-call do WhatsApp? R: Click-to-call abre o discador de telefone do usuário com um número PSTN. O WhatsApp Business Calling fica dentro do aplicativo WhatsApp e monta a infraestrutura de voz da Meta — superfície totalmente diferente.

Resolução de Problemas

  • Sintomas * Causa provável * Não, não, não
  • "Chamar não habilitado" banner * Meta ainda não aprovou chamada para este WABA • Queda de chamadas em 1-2 segundos – Falta o item inválido ou o escopo – reemissão • Qualidade de áudio ruim em regiões específicas □ Chamador ouve "este número não está configurado" □ Gravação em falta □ recording_enabled bandeira off no limite Finn — alternar nas configurações do agente □

Relacionado

Was this page helpful?

Still stuck or have feedback?

Email [email protected] or use the chat bubble in the bottom-right corner — it's a Finn that knows the Academy cold.