InícioBlogAPI Oficial

API Oficial

Chamadas de voz pela API do WhatsApp: as regras que decidem se vale a pena

A API permite ligar e receber ligações dentro do WhatsApp. Receber é grátis e abre a janela de 24h; ligar exige permissão, tem limite apertado e é cobrado em pulsos de seis segundos.

Chamada de voz dentro do WhatsApp, pela API, integrada ao seu sistema de atendimento. A ideia vende sozinha: o cliente já está no aplicativo, já está na conversa, e no meio dela existe um botão de ligar.

O recurso existe e está documentado. Mas as regras em volta dele são bem mais restritivas do que os materiais de venda sugerem, e elas mudam completamente a resposta para “vale a pena”. A conclusão curta é que receber ligação é um ótimo negócio e ligar é caro em mais de um sentido.

Dois sentidos, duas realidades

A Calling API permite chamadas por VoIP nos dois sentidos, mas eles não se parecem em nada.

O cliente ligando para você funciona em todas as regiões onde a Cloud API opera, não exige permissão nenhuma e — o ponto principal — a documentação é direta: “All user-initiated calls are free.”

Você ligando para o cliente exige permissão prévia, é cobrado por tempo e nem está disponível em todo lugar. A documentação lista os países cujos números comerciais não podem iniciar chamadas: Estados Unidos, Canadá, Egito, Vietnã e Nigéria. Número brasileiro está entre os suportados.

Diagrama comparando os dois sentidos da chamada na API do WhatsApp e o ciclo da permissão: o cliente ligando para a empresa é gratuito, não exige permissão e abre a janela de 24 horas; a empresa ligando para o cliente exige permissão, é cobrada em pulsos de seis segundos e não está disponível para números de alguns países. O ciclo da permissão vai do pedido à revogação automática após quatro chamadas sem resposta
Receber e ligar são recursos diferentes, com regras que quase não se tocam

O detalhe que muda a estratégia

Este é o achado mais útil da documentação, e ele está numa frase discreta da página de preços: quando um usuário liga para você, a janela de atendimento de 24 horas é iniciada ou renovada — “regardless of if you accept the call or not”.

Leia de novo: mesmo que você não atenda.

Uma ligação perdida do cliente abre a sua janela de atendimento. Isso significa que, se o telefone tocou e ninguém pôde atender, você não perdeu o contato: pode responder por mensagem, com texto livre, sem template.

Para operações que hoje só olham para mensagens, isso é um caminho de reabertura de janela que ninguém está contando. E vira mais valioso ainda a partir de outubro de 2026, quando responder dentro da janela deixa de ser gratuito — porque a chamada recebida continua abrindo a janela sem custo de chamada.

A permissão, e por que ela é o gargalo

Para ligar, você precisa de permissão do usuário. Ela pode ser pedida de três formas: por uma mensagem interativa de formato livre, por um template do tipo call_permission_request, ou concedida automaticamente quando é o próprio usuário quem liga para você.

O que ela é, na prática:

  • A permissão temporária vale 7 dias corridos (168 horas). Existe também a permanente, que não expira.
  • A API expõe o estado em três valores: no_permission, temporary ou permanent. A temporária traz um expiration_timestamp.
  • Se o usuário simplesmente ignorar, o pedido expira ao fim do prazo.

E aqui vêm os limites que decidem tudo:

Limite Valor
Pedidos de permissão 1 a cada 24 horas e 2 a cada 7 dias, por usuário
Chamadas conectadas no máximo 100 a cada 24 horas, por número
2 chamadas seguidas sem resposta o usuário recebe uma mensagem do sistema
4 chamadas seguidas sem resposta a permissão aprovada é revogada automaticamente

Os limites de pedido são reiniciados depois de qualquer chamada conectada.

Repare no desenho: dois pedidos por semana, e quatro chamadas não atendidas queimam a permissão. Isso não é um canal de prospecção. É um canal para quando existe uma conversa em andamento e a ligação resolve algo que o texto não resolveria.

Quem planeja usar chamada da empresa para o cliente como substituto de ligação de call center vai bater nesse teto na primeira semana. E vai bater de um jeito ruim: a revogação automática não avisa antes, e recuperar a permissão exige um novo pedido dentro da cota.

Como a cobrança funciona

A parte que quase ninguém explica: a chamada não é cobrada por minuto, é cobrada em pulsos de seis segundos — e a fração sempre arredonda para cima.

O exemplo é da própria documentação: uma chamada de 56 segundos equivale a 9,33 pulsos e é cobrada como 10 pulsos.

Na prática, isso significa que chamadas muito curtas têm um piso relativo alto. Uma ligação de 3 segundos — o cliente atende, percebe que é engano e desliga — custa um pulso inteiro. Uma operação que faz muitas chamadas curtíssimas paga proporcionalmente mais do que a matemática de minutos sugere.

A tarifa varia por código de país e por faixa de volume mensal, no mesmo desenho de faixas usado nas mensagens: acumulou minutos no mês, muda de faixa. A documentação registra que, quando uma chamada cruza a fronteira entre faixas, ela inteira recebe a tarifa da faixa mais baixa.

Sobre moeda: a tabela de tarifas vigente lista 15 moedas, e o BRL aparece na seção de atualizações com previsão de 1º de julho de 2026 — o que acompanha o movimento geral de faturamento em reais da plataforma.

O que é preciso do lado técnico

Três configurações estão documentadas, e a escolha depende de onde sua telefonia já mora:

  • Padrão: sinalização por Graph API e webhooks, mídia por WebRTC (ICE, DTLS, SRTP), codec de áudio OPUS.
  • SIP + WebRTC: sinalização por SIP sobre TLS, mídia WebRTC. Precisa ser habilitado.
  • SIP + SDES: sinalização SIP sobre TLS, mídia com SDES SRTP.

Além do OPUS, a documentação registra suporte a PCMA e PCMU (G.711), adicionados em março de 2026 — o que facilita a vida de quem vai conectar um PABX ou contact center já existente.

Vídeo aparece na documentação como recurso planejado ou em desenvolvimento, não como algo disponível.

Quando isso faz sentido

Juntando as regras, o desenho de uso que sobrevive a elas é bem específico.

Faz sentido receber. Habilitar o recebimento de chamadas é quase sem contraindicação: é gratuito, funciona em qualquer região onde a Cloud API opera, tira o cliente da fila de texto quando o assunto é complexo e ainda abre a janela de atendimento. O trabalho real aqui é operacional — ter gente para atender, e um plano para quando não houver.

Faz sentido ligar em casos pontuais e de alto valor. Negociação travada, suporte que não anda por texto, confirmação de algo caro. Situações em que a conversa já existe e a ligação é o próximo passo natural.

Não faz sentido como canal de saída em volume. Dois pedidos de permissão por semana e revogação após quatro chamadas não atendidas são limites desenhados justamente para impedir esse uso. Tentar contorná-los é gastar permissão e reputação.

Vale ainda uma consideração que a documentação não faz, mas a operação faz: chamada é síncrona. O ganho do WhatsApp como canal sempre foi o cliente responder quando pode, e um atendente cuidar de várias conversas ao mesmo tempo — o que discutimos em quantos atendentes sua operação precisa. Uma ligação ocupa uma pessoa inteira por vez. Antes de habilitar chamadas de saída, vale saber quem vai atendê-las e o que essa pessoa vai deixar de fazer.

O canal é da Meta; a operação é sua

Repare que quase tudo que decide o resultado aqui não é a chamada em si: é quem atende, em quanto tempo, com qual histórico na tela e o que acontece com a conversa depois que a ligação cai.

Chamada perdida que abre janela de 24 horas só vira venda se alguém vir que ela existiu e responder a tempo. Permissão revogada por quatro ligações sem resposta só é evitada por quem acompanha o que está acontecendo. Isso é operação, não recurso da API.

Com o AtendeChat, o WhatsApp da sua empresa roda com vários atendentes no mesmo número, fila de distribuição, histórico centralizado, funil e relatórios — para que nenhuma conversa aberta por uma ligação perdida morra sem resposta. Somos parceiros oficiais da Meta e conduzimos com você a verificação de negócio, o registro do número e a aprovação dos templates.

Fale com a gente para montar sua operação na API Oficial do jeito certo desde o começo.

Fontes

  1. Meta — Cloud API Calling: disponibilidade, países sem chamada iniciada pela empresa e configurações técnicas
  2. Meta — Obtain user call permissions: duração de 7 dias, limites de pedidos, revogação e status da permissão
  3. Meta — Calling API Pricing: gratuidade das chamadas do usuário, pulsos de seis segundos e faixas por volume

Rode seu WhatsApp na API Oficial da Meta

O AtendeChat é parceiro oficial da Meta: multiatendimento, Kanban, campanhas e IA — dentro das regras.

Leia também