WhatsApp Business Platform
WhatsApp Business Platform
Recursos

Ligações da API de Nuvem

Updated: 10 de mar de 2026

Visão geral

A API de Ligações Comerciais do WhatsApp permite que você inicie e receba ligações de usuários do WhatsApp usando o protocolo de voz sobre IP (VoIP).

Proposta de valor (concisa)

Ligação do WhatsApp Business: conexão global de confiança, multimodal e completa.
ValorDescrição
Comunicação unificada
Um número. Mensagem e ligação. No mundo todo.
Elementos de marca e confiança
Elementos de marca integrados, confiáveis e globais
Relacionamento com o cliente
Aumente a perdurabilidade. Aprofunde o toque pessoal.
Vendas e suporte
Unifique o marketing e o suporte. Implemente o upsell.
Recursos avançados
Vídeo, compartilhamento de tela e personalização total de ligações.
Transferência de ligação
Ligação no WhatsApp Melhore as taxas de desistência.
Conveniência para o cliente
Acesso universal e gratuito para os clientes.
Manutenção de registros
Uma thread. Registro centralizado de longo prazo.

Benefícios para usuários finais

ValorDescrição
Acesso universal
Conexão global simples, gratuita e familiar.
Segurança aprimorada
Mais segurança devido à verificação/confiança integrada da plataforma.
Histórico centralizado
Um tópico unificado para todo o histórico de voz e texto.
Correio de voz integrado
Um correio de voz* que pode ser lido no contexto da conversa.
Aviso legal: * recurso planejado ou em desenvolvimento. Se precisar de mais informações, entre em contato com a Meta ou com seu parceiro.

Proposta de valor (detalhada)

Com a API de Ligações Comerciais do WhatsApp, as empresas podem integrar as ligações de voz e vídeo* diretamente à estratégia de engajamento do cliente, oferecendo um canal de comunicação confiável, unificado e completo.
Recurso Benefício para a empresa
Comunicação unificada
Um número. Todas as comunicações. Multimodal. Use um único número do WhatsApp verificado para todas as mensagens e ligações (entradas e saídas), permitindo um fluxo perfeito entre conversa e ligação, e até mesmo conversar enquanto estiver em uma ligação.
Elementos de marca e confiança
Elementos de marca integrados, confiáveis e globais. O WhatsApp oferece suporte nativo à identidade da marca com recursos de segurança e verificação. Isso garante confiança instantânea globalmente, eliminando a necessidade de provedores de confiança de terceiros específicos para regiões.
Relacionamento com o cliente
Aumente a perdurabilidade. Aprofunde o toque pessoal. Um único ponto de contato para comunicação de entrada e saída melhora o toque pessoal, aumenta a retenção de clientes e garante fidelidade duradoura do cliente.
Vendas e suporte
Unifique marketing e suporte. Implemente o upsell. Centralize o gerenciamento de leads unindo canais de suporte e marketing, o que otimiza as operações e abre oportunidades para upsell e venda cruzada de produtos.
Recursos avançados
Mais do que uma ligação. Receba vídeos, compartilhamento de tela e controle avançado. Além da voz, as empresas podem interagir com os clientes por meio de ligações de vídeo e compartilhamento de tela para oferecer suporte e serviços mais detalhados e valiosos. As empresas também controlam a experiência de ligação ao configurar o horário de atendimento, gerenciar a visibilidade do ícone de ligação, enviar botões de ligação com expiração e usar deep links de ligação.
Transferência de ligação
Ligação no WhatsApp. Melhorar as taxas de desistência. Ao migrar as ligações para o WhatsApp, as empresas podem oferecer aos clientes uma experiência de conversa mais rica, além de usar modelos de mensagens interativas para melhorar o encaminhamento e reduzir os custos do suporte apenas por voz.
Conveniência para o cliente
Sempre gratuito e universal. Ofereça aos seus clientes uma forma de comunicação conveniente e acessível globalmente que seja gratuita para uso.
Manutenção de registros
Um fio. Registro centralizado e de longo prazo. Mantenha uma única conversa persistente de texto e voz com o cliente, o que serve como um registro centralizado de longo prazo para referência.
Aviso legal: * recurso planejado ou em desenvolvimento. Se precisar de mais informações, entre em contato com a Meta ou com seu parceiro.

Arquitetura

Image (Clique com o botão direito do mouse na imagem e escolha "Abrir em uma nova aba" para ampliar a imagem)

Configurações possíveis de sinalização e mídia

Configuração padrão após habilitar as ligações SIP com WebRTC SIP com mídia SDES
Protocolo de sinalização
Graph APIs + Webhooks
SIP (precisa de habilitação explícita)
SIP (precisa de habilitação explícita)
Transporte de sinalização
HTTPS
TLS
TLS
Protocolo de mídia
WebRTC (ICE + DTLS1 + SRTP)
WebRTC (ICE + DTLS + SRTP)
SDES SRTP (precisa de habilitação explícita)
Codec de áudio2
OPUS
OPUS
OPUS
Observações
  1. Você pode usar SDES em vez de ICE+DTLS com a Graph API + sinalização de Webhook
  2. Outros codecs de áudio compatíveis: PCMA, PCMU

Começar

Etapa 1. Pré-requisitos

Antes de começar a usar a API de Ligações, verifique o seguinte:
  1. O número comercial está em uso com a API de Nuvem (e não com o app WhatsApp Business)
  2. Inscreva o app no campo de webhook calls (a menos que você planeje usar SIP)
  3. O mesmo app deve estar inscrito na conta do WhatsApp Business do seu número de telefone comercial.
  4. Esse app deve ter permissões de mensagens (whatsapp_business_messaging) para o número comercial
  5. A empresa deve ter um limite diário de pelo menos 2.000 destinatários únicos para mensagens. Para saber mais, leia sobre como ampliar os recursos da sua conta.
  6. Habilitar recursos de ligação no número de telefone comercial

Etapa 2. Configurar recursos de ligação opcionais

A API de Ligações Comerciais do WhatsApp oferece diversos recursos que afetam quando e como os recursos de ligação são exibidos para os usuários no seu perfil do WhatsApp
  • O controle de ligações recebidas permite impedir que usuários façam ligações usando seu perfil empresarial
  • Com o horário de ligação da empresa, você não perde ligações nem direciona os usuários a enviar mensagens quando a central de atendimento está fechada
  • As solicitações de retorno de ligação oferecem aos usuários a opção de pedir um retorno quando você não atende ou a central de atendimento está fechada

Etapa 3. Fazer e receber ligações

Você pode testar a integração de Ligações do WhatsApp usando números de teste público e uma conta do WhatsApp Business no sandbox.
A ligação da API de Nuvem oferece dois caminhos de iniciação:
  • Ligações iniciadas pelo usuário: ligações feitas de um usuário do WhatsApp para a empresa
  • Ligações iniciadas pela empresa: ligações feitas da sua empresa para um usuário do WhatsApp

Contas de teste e de sandbox

As contas de sandbox estão disponíveis apenas para Parceiros de Tecnologia.
As contas de sandbox e os números de teste públicos permitem que você teste a integração da API de Ligações do WhatsApp com limitações de ligação flexíveis. Especificamente para contas de sandbox e números de teste públicos, o limite de ligações iniciadas pela empresa é menos rigoroso a fim de facilitar a integração e os testes.

Limites (por par empresa + usuário do WhatsApp)

  • As contas de sandbox podem enviar 25 permissões de ligação por dia e 100 por semana (em comparação com 1 por dia e 2 por semana para contas de produção)
  • Quando as ligações iniciadas pela empresa ficam sem resposta ou são recusadas
    • Cinco ligações consecutivas sem resposta resultam em uma mensagem do sistema para reconsiderar uma permissão aprovada (em comparação com duas ligações consecutivas sem resposta para contas de produção)
    • Dez ligações consecutivas sem resposta resultam na revogação automática de uma permissão aprovada (em vez de quatro ligações consecutivas sem resposta para contas de produção)
Você pode receber um número de teste público depois de concluir o fluxo para Começar.
Sua empresa não precisa ter um limite diário de mensagens de dois mil destinatários únicos para testar os recursos da API de Ligações ao usar números de teste públicos e contas de sandbox.
As ligações estão desabilitadas por padrão nos números de teste. Você deve configurar os recursos de ligação nas definições de ligação do número de telefone antes de usar a API de Ligações em um número de teste.

Disponibilidade

Ligações iniciadas pelo usuário

As ligações iniciadas pelo usuário estão disponíveis em todas as localizações em que a API de Nuvem está disponível.

Ligações iniciadas pela empresa

As ligações iniciadas pela empresa estão disponíveis em todas as localizações onde a API de Nuvem está disponível, exceto os seguintes países:
  • EUA
  • Canadá
  • Egito
  • Vietnã
  • Nigéria
Observação: o código do país no número de telefone comercial deve estar nesta lista com suporte. O número de telefone do consumidor pode ser de qualquer país em que a API de Nuvem esteja disponível.

Próximas etapas

Use os guias abaixo para integrar recursos de ligação no seu app:

Registro de alterações

Esta tabela serve como um local central para acompanhar as atualizações de recursos relacionadas à API de Ligações Comerciais do WhatsApp
Data Título Descrição
23 de março de 2026
Suporte para o codec de áudio G.711 (PCMA, PCMU)
Nova seção para a configuração do codec de áudio G.711 (PCMA/PCMU) nas configurações de ligação, incluindo diretrizes sobre transcodificação, qualidade do áudio e considerações de largura de banda. Saiba mais sobre as configurações de codec de áudio.
27 de janeiro de 2026
As restrições de ligação com base no feedback dos usuários entram em vigor
19 de dezembro de 2025
Atualização no limite de ligações iniciadas pela empresa
O número de ligações iniciadas pela empresa por usuário foi aumentado de 10 para 100 por dia.
10 de dezembro de 2025
Introduzimos restrict_to_user_countries para as configurações de ícone de ligação
Agora, é possível controlar em quais países o ícone de ligação deve ficar visível. Saiba mais sobre as configurações de país do ícone de ligação.
13 de outubro de 2025
  • Atualização no limite de ligações iniciadas pela empresa
  • Adição da seção "Teste e sandbox" à documentação
O número de ligações iniciadas pela empresa por usuário foi aumentado de 5 para 10 por dia.
As contas de teste e de sandbox foram adicionadas à documentação
29 de setembro de 2025
Guia de integração do Asterisk
24 de setembro de 2025
Propagação de contexto a partir de botões de ligação e deep links
Especifique uma string opaca em botões de ligação ou deep links de ligação para ajudar a rastrear a origem das ligações iniciadas pelo usuário. Saiba mais
8 de setembro de 2025
Atualização sobre ligações da API de Status de Integridade
A API de Status de Integridade agora inclui um novo campo can_receive_call_sip para ajudar você a fazer o autodiagnóstico de problemas relacionados à configuração de SIP
5 de setembro de 2025
Incluímos novas restrições para baixa taxa de atendimento de ligações
As restrições para baixa taxa de atendimento de ligações entram em vigor hoje. Para saber mais, consulte Restrições de ligação para baixas taxas de ligações atendidas
21 de julho de 2025
Webhooks de atualização de configurações da conta
Receba webhooks quando as configurações forem atualizadas. Saiba mais.
Você achou esta página útil?
Ícone de polegar para cima
Ícone de polegar para baixo