Pular para o conteúdo

WhatsApp Business Calling API: o que é, preço e como usar com IA

Guia em português da WhatsApp Business Calling API: quem pode usar, permissão para ligar, quanto custa, SIP ou WebRTC, disponibilidade no Brasil e como colocar um agente de IA.

Cofundador da Tolky

Atualizado em 20 de novembro de 2026

12 min de leitura
WhatsApp Business Calling API: o que é, preço e como usar com IA

TL;DR

A WhatsApp Business Calling API é a parte da API oficial do WhatsApp que permite a uma empresa receber e fazer ligações de voz pelo WhatsApp, no mesmo número das mensagens. Ligações iniciadas pelo cliente são grátis; as iniciadas pela empresa exigem permissão do contato e são cobradas pela duração, em pulsos de 6 segundos. A sinalização pode ser feita pela Graph API com WebRTC ou por SIP, e um agente de IA pode atender ou fazer essas ligações.

Compartilhar

Quem procura "WhatsApp Business Calling API" quase só encontra a documentação da Meta, em inglês e espalhada em várias páginas. Faltava um guia em português que juntasse o essencial: o que a API faz, quem pode usar, quanto custa e como colocar uma IA para atender ou ligar.

Este guia resume a documentação oficial da Meta, conferida em 20 de novembro de 2026, com link para cada regra. Onde a fonte não dá o número, indicamos onde consultar em vez de chutar.

Atualizado em novembro de 2026.

O que é a WhatsApp Business Calling API?

A WhatsApp Business Calling API é o recurso da plataforma oficial do WhatsApp que permite a uma empresa iniciar e receber ligações de voz com usuários do WhatsApp, pela internet (VoIP), usando o mesmo número das mensagens. O cliente toca no ícone de ligação da conversa e fala com a empresa; a empresa, com permissão, liga para o cliente dentro do próprio app.

Segundo a visão geral da Calling API, a ligação não passa pela rede telefônica: é uma chamada de voz pela internet, como as ligações entre pessoas no WhatsApp. A Meta lista vídeo e compartilhamento de tela como recursos ainda em desenvolvimento.

No glossário, o termo aparece como chamadas no WhatsApp. Para a dúvida de quem usa o app no dia a dia (fazer e receber ligação no WhatsApp Business), veja o post ligação no WhatsApp Business.

Quem pode usar a Calling API?

Pode usar a Calling API a empresa que tem o número na Cloud API, a API oficial do WhatsApp, com limite de mensagens alto o suficiente e as ligações ativadas no número. Quem usa só o aplicativo WhatsApp Business não tem acesso a ela.

Os requisitos da documentação da Meta, conferidos em 20 de novembro de 2026:

  • Número na Cloud API, e não apenas no aplicativo. O caminho está em como conseguir a API oficial do WhatsApp Business.
  • Limite de mensagens de pelo menos 2.000 destinatários únicos por dia.
  • Ligações ativadas no número, porque elas vêm desligadas.
  • Aplicativo inscrito nos webhooks de mensagens e de chamadas (este último dispensado quando se usa SIP), com a permissão de mensagens do WhatsApp para o número.
  • Forma de pagamento válida na conta para a empresa poder ligar.

Nas configurações de chamada, a empresa define horário de atendimento por voz, controle das ligações recebidas, pedidos de retorno e onde o ícone de ligação aparece, inclusive por país.

Ligação iniciada pelo cliente ou pela empresa: qual a diferença?

A ligação iniciada pelo cliente é grátis e não precisa de autorização; a iniciada pela empresa só acontece com permissão do contato e é cobrada pela duração.

CritérioIniciada pelo clienteIniciada pela empresa
Quem discaO cliente, pelo ícone de ligação ou por um botãoA empresa, pela API
PermissãoNão precisaPrecisa de permissão do contato
Custo da ligaçãoGrátisCobrada por duração, em pulsos de 6 segundos
DisponibilidadeOnde a Cloud API está disponívelOnde a Cloud API está disponível, com exceção de alguns países
Uso típicoSuporte, dúvidas, pré-vendaRetorno combinado, confirmação, follow-up, campanhas
RiscoFila e horário sem coberturaLigação não atendida e perda da permissão

As regras de preço estão na página de preços da Calling API e as de permissão na página de permissões de chamada, ambas conferidas em 20 de novembro de 2026.

Como funciona a permissão para a empresa ligar?

Para ligar pelo WhatsApp, a empresa precisa que o contato autorize antes, e só o contato pode conceder ou revogar essa permissão. A Meta chama esse pedido de solicitação de permissão de chamada (call permission request).

Como pedir a permissão

A documentação de permissões prevê quatro caminhos:

  1. Mensagem interativa livre, só dentro da janela de atendimento aberta pelo cliente.
  2. Template, que pode ser enviado fora dessa janela. A regra da janela está em janela de 24 horas e templates.
  3. Retorno de ligação: quando o cliente liga para a empresa, ele concede permissão temporária automaticamente, desde que a empresa ative o recurso de retorno no número.
  4. Perfil da empresa: o cliente pode autorizar direto pelo perfil comercial.

O cliente escolhe entre permissão temporária, que vale 7 dias corridos (168 horas), e permanente, que não expira até ele revogar. Ele também pode recusar ou não responder.

Limites de pedidos e de chamadas não atendidas

A Meta limita a insistência. Por par de empresa e contato, vale no máximo 1 pedido de permissão em 24 horas e 2 em 7 dias; os contadores zeram quando uma ligação se completa. Depois de 2 ligações seguidas não atendidas, o contato recebe uma mensagem do sistema sugerindo rever a permissão; depois de 4, a permissão é revogada sozinha.

A mesma página traz um teto de 100 chamadas conectadas a cada 24 horas. A Meta já revisou esses limites antes, por isso confira a página antes de planejar volume.

Quanto custa a WhatsApp Business Calling API?

Na Calling API, ligações iniciadas pelo cliente são grátis e as iniciadas pela empresa são cobradas pela duração, em pulsos de 6 segundos, com tarifa que depende do país do número chamado e da faixa de volume do mês. Quem paga é sempre a empresa.

As regras da página de preços, conferida em 20 de novembro de 2026:

  • Pulsos de 6 segundos. Pulso quebrado conta inteiro: no exemplo da Meta, uma ligação de 56 s soma 9,33 pulsos e é cobrada como 10.
  • Faixas de volume. A faixa é definida pelos minutos de ligação no mês do calendário. Se uma ligação cruza a mudança de faixa, ela inteira sai pela tarifa menor.
  • Pedido de permissão. É cobrado como mensagem, pela tabela de mensagens, e não pela de chamadas. Os valores por mensagem no Brasil estão no guia de preço da API do WhatsApp em 2026.
  • Gravação e transcrição da Meta. A página informa que os dois recursos estão sem custo adicional por enquanto e que terão preço próprio no futuro, sem data definida.

Como consultar o preço para o Brasil

A página não escreve o preço por minuto no texto: os valores ficam nas tabelas de tarifas em CSV e PDF, uma por moeda de cobrança. A tabela em reais (BRL) passou a valer em 1º de julho de 2026. Para achar o valor, abra a página de preços, baixe a tabela da moeda da sua conta e procure a linha do país de quem recebe a ligação e a sua faixa de volume.

Para estimar a parte das mensagens (pedidos de permissão, templates e conversas), use a calculadora de custo da API do WhatsApp. Ela calcula mensagens, não minutos de ligação.

SIP ou Graph API com WebRTC: qual escolher?

A Calling API aceita dois jeitos de controlar a ligação: a Graph API com webhooks, que vem ativada por padrão, e o SIP, que precisa ser ligado à parte e conversa com centrais telefônicas que você já tem. Para o cliente, a ligação é igual nos dois casos.

CritérioGraph API com WebRTCSIP
SinalizaçãoHTTPS, pela Graph API e webhooksSIP sobre TLS, com autenticação digest
ÁudioWebRTC (ICE, DTLS, SRTP)WebRTC ou SRTP com SDES
AtivaçãoPadrão depois de ligar as chamadasAtivação explícita, com servidor e porta (padrão 5061)
Webhooks de chamadaSimDesligados por padrão; podem ser ativados só para informação
Bom paraIntegração nova, feita sob medidaQuem já tem PABX, central ou provedor SIP
LimiteExige montar a parte de WebRTCUm servidor SIP por número; sem os endpoints de chamada da Graph API

O codec de áudio é o Opus nas duas opções, e a Meta registra suporte também a G.711 (PCMA e PCMU). Os detalhes estão na página de SIP da Calling API, conferida em 20 de novembro de 2026. Se o termo é novo, veja telefonia SIP no glossário.

A Calling API está disponível no Brasil?

Sim: segundo a Meta, a ligação iniciada pelo cliente funciona em todos os países onde a Cloud API está disponível, e a iniciada pela empresa também, exceto quando o número da empresa é de Estados Unidos, Canadá, Egito, Vietnã ou Nigéria. O Brasil não está nessa lista de exceções (conferido em 20 de novembro de 2026).

A restrição olha o código de país do número da empresa; o cliente pode estar em qualquer país atendido pela Cloud API. E existe um modelo de ligação ativa baseado em qualidade, em disponibilidade limitada, em que números elegíveis dispensam o pedido prévio de permissão. Segundo a página de ligações iniciadas pela empresa, os números inscritos automaticamente são da Colômbia e do México, não do Brasil.

Como ligar um agente de IA na Calling API?

Para um agente de IA atender ou fazer ligações pelo WhatsApp, ele precisa receber o áudio da chamada, transcrever a fala, decidir a resposta e devolver voz sintetizada em tempo de conversa. A Calling API entrega o áudio; o resto é trabalho da plataforma de voz.

O que precisa estar no lugar

  1. Ponte de mídia. Um servidor que receba o áudio por WebRTC ou SIP e o entregue ao agente.
  2. Reconhecimento e síntese. STT para transformar fala em texto e TTS para devolver voz, ou um modelo que faça os dois em tempo real.
  3. Conversa natural. Baixa latência e barge-in, para o cliente poder interromper.
  4. Regras de permissão. Pedir autorização antes de ligar, respeitar os limites e ter um plano para quem recusou.
  5. Saída para pessoas. Transferência com a transcrição, como explica o guia de handoff entre IA e humano.

Montar isso do zero exige equipe de engenharia de voz. O funcionamento geral de um agente de voz está em IA de voz no atendimento, e as três formas de usar voz no app (entender áudios, responder em áudio e atender ligações) estão em IA de voz no WhatsApp.

Onde a Tolky entra

A Tolky é um AI CRM conversacional que conecta o agente de IA à Calling API, para atender ligações pelo WhatsApp com o mesmo agente que já responde por texto. A voz entra sob ativação, e a solução é o Atendimento por Voz.

  • A IA atende a ligação pelo WhatsApp, pela telefonia e pela voz no site, com vozes e sotaques regionais, saudação de abertura e interrupção permitida.
  • A permissão é tratada na conversa. A Tolky envia o pedido em template ou mensagem e mostra o status: autorizou, recusou ou pendente. Para quem não autorizou, a ligação pode ir pela telefonia comum.
  • O operador liga a partir do chat, pelo WhatsApp ou pelo telefone, e pode entrar numa ligação da IA: quando ele fala, a IA fica em silêncio.
  • A transcrição fica no histórico do contato, junto com as conversas de texto.

Para ligações ativas em escala, as Campanhas por Voz usam o modo combinado: tentam o WhatsApp e, sem permissão, ligam pela telefonia, com roteiro, objetivo, faixas de horário e teto diário de gasto.

Captura real da tela Conversas da Tolky, com a lista de chats do WhatsApp à esquerda, filtros por período e a mensagem Nenhuma conversa selecionada no painel da direita

O que a Tolky não faz: ela não contorna as regras da Meta. Sem permissão do contato, não há ligação pelo WhatsApp, e a tarifa da Meta por minuto vale para qualquer plataforma.

Perguntas frequentes

O que é a WhatsApp Business Calling API?

É o recurso da API oficial do WhatsApp que permite à empresa receber e fazer ligações de voz pela internet com usuários do WhatsApp, no mesmo número das mensagens.

A WhatsApp Business Calling API é paga?

Ligações iniciadas pelo cliente são grátis. As iniciadas pela empresa são cobradas pela duração, em pulsos de 6 segundos, conforme o país do número chamado e a faixa de volume do mês. O pedido de permissão é cobrado como mensagem.

Preciso de permissão para ligar para um cliente pelo WhatsApp?

Sim. O contato precisa autorizar antes, por mensagem, template, perfil da empresa ou ao ligar para você com o retorno ativado. A permissão temporária vale 7 dias; a permanente vale até o contato revogar.

Dá para usar a Calling API com o aplicativo WhatsApp Business?

Não. Segundo a Meta, o número precisa estar na Cloud API, a API oficial, com as ligações ativadas e limite de pelo menos 2.000 destinatários únicos por dia.

A Calling API funciona com SIP?

Sim. Além da Graph API com WebRTC, a Meta aceita SIP sobre TLS como sinalização, o que permite ligar a chamada do WhatsApp a um PABX ou provedor SIP. Com SIP ativo, os endpoints de chamada da Graph API deixam de valer para aquele número.

Uma IA pode atender ligações da Calling API?

Pode, desde que uma plataforma de voz receba o áudio, transcreva, decida a resposta e devolva voz em tempo real. Na Tolky, isso faz parte do Atendimento por Voz, sob ativação.


Conclusão

A WhatsApp Business Calling API leva a ligação de voz para dentro da conversa: o cliente liga de graça, a empresa liga com permissão e paga por duração, e tudo pode ser atendido por um agente de IA com saída para a equipe. Comece pelas ligações recebidas, que não custam minuto, peça permissão com contexto e consulte a tabela em reais antes de planejar ligações ativas.

Conheça o Atendimento por Voz, veja as Campanhas por Voz, veja os planos ou fale com o time →. Vamos conversar?

Compartilhar

Tags

  • whatsapp business calling api
  • whatsapp calling api o que é
  • whatsapp calling api preço
  • whatsapp voice api
  • whatsapp calling api sip
  • ligação pelo whatsapp business
  • agente de voz no whatsapp
  • #CRM conversacional

Sobre o autor

Cofundador da Tolky

Marlos Carmo é empreendedor em IA e fundador da Tolky, a infraestrutura e AI CRM da era conversacional que unifica atendimento inteligente, multicanalidade (como WhatsApp e voz), CRM vivo e inteligência operacional em um único ecossistema. É finalista do SXSW Innovation Awards e integrante do Francesco's Economy, rede global de jovens empreendedores com foco em inovação e impacto social. Atua conectando Inteligência Artificial e transformação digital em projetos para grandes organizações.

Próximo passo

Quer levar isso para a sua operação?

A Tati, assistente de IA da Tolky, entende o seu cenário em poucas perguntas, sugere o melhor caminho e te conecta com uma pessoa do time levando todo o contexto.

Compartilhar

Leia também sobre CRM conversacional e AI CRM