API Oficial — limitações, erros e perguntas frequentes

O que a API Oficial do WhatsApp não faz, por que uma mensagem pode ser rejeitada e respostas às dúvidas mais comuns.

Limitações que você precisa conhecer#

Limitação	Como lidar
Não há suporte a grupos	Use conversas individuais (ou uma conexão por QR Code para grupos)
A foto do contato não aparece	Comportamento da própria API
Só é possível responder livremente por 24 horas após a última mensagem do cliente	Depois disso, envie um template ou use o chat externo
Para iniciar uma conversa é obrigatório usar template	Tenha templates aprovados para os cenários mais comuns
A API não verifica se o número tem WhatsApp	Confira DDI, DDD e o nono dígito antes de enviar
PNG com transparência vira JPEG com fundo branco	Envie JPEG ou PNG com fundo sólido

Mensagem com X vermelho (rejeitada)#

Quando a Meta recusa uma mensagem, ela aparece com um X vermelho. As três causas mais comuns são:

Janela de 24 horas fechada → envie um template.
Formato de arquivo não aceito → converta para um formato suportado (JPEG, PNG, MP4, PDF, etc.).
Conteúdo fora das políticas da Meta → revise o texto ou a mídia.

Limites de envio e qualidade#

A Meta define níveis (tiers) de quantos contatos novos você pode alcançar por dia. Eles sobem conforme a qualidade da conta. Bloqueios, denúncias de spam e reclamações baixam a qualidade e podem limitar ou suspender o número.

Se aparecer uma restrição:

Consulte o Account Quality (Qualidade da conta) no Meta Business.
Se precisar, abra um chamado no suporte da Meta informando o ID da WABA, o ID do número, o portfólio, prints do erro e o horário aproximado.

Perguntas frequentes#

Preciso de um Gerenciador de Negócios (Business Manager)?: Sim. A conta da API precisa estar vinculada a um portfólio empresarial na Meta.
Minha empresa precisa ser verificada pela Meta?: Na maioria dos casos, sim. Sem verificação, a Meta pode limitar recursos e volume. O status aparece nas Informações da empresa do Meta Business.
O plano Jarvis já inclui as cobranças da Meta?: Não. As mensagens da API Oficial são cobradas pela Meta diretamente da empresa dona da conta (WABA). Os valores variam por país, categoria e tipo de mensagem.
Quanto custa um template?: Depende da categoria (Marketing, Utilidade, Autenticação) e do país. Consulte a tabela oficial de preços da Meta, que é atualizada periodicamente.
As respostas dentro das 24 horas são cobradas?: A Meta anunciou que, a partir de outubro de 2026, mensagens de serviço e utilidade dentro da janela de 24 horas passam a ser cobradas por mensagem, com taxas que variam por país. Acompanhe a página de preços da Meta e use a franquia grátis e o Concatenador a seu favor.
Conversas iniciadas por anúncios Click-to-WhatsApp são gratuitas?: A janela gratuita de 72 horas para conversas vindas desses anúncios continua valendo, segundo a Meta.
Quem aprova os templates?: Exclusivamente a Meta. O Jarvis apenas envia para análise e sincroniza o resultado.
Posso usar o WhatsApp no celular junto com a API?: Sim, pelo modo coexistência.
Posso fazer ligações?: Sim. Na coexistência, as ligações seguem pelo app do celular. Fora dela, há recursos de chamada pela API em integrações de telefonia compatíveis (veja Chamadas).
Posso migrar um número que já uso?: Na maioria dos casos, sim: usando só a API ou em coexistência.
A API garante a entrega de todas as mensagens?: Não. A entrega depende do destinatário, da qualidade da conta e das políticas da Meta.
Posso ter vários atendentes no mesmo número?: Sim. Esse é justamente o papel do Jarvis: vários atendentes, filas e automações no mesmo número oficial.
Posso integrar com meu CRM ou ERP?: Sim, pela API e pelos webhooks do Jarvis.