// guia

Como avaliar um provedor da API do WhatsApp por dentro

Por Fernando, fundador da BotoZap · 21 de novembro de 2026

Camadas de uma plataforma inspecionadas com uma lupa, com um painel de status e uma seta de reenvio de mensagens

Resposta rápida

Por dentro, um provedor da API do WhatsApp se avalia pelo que acontece quando algo dá errado. O webhook tenta de novo? Você vê o histórico e reenvia o que falhou? O erro da Meta chega inteiro? Os dados saem por API? Existe servidor MCP pronto? No BotoZap: novas tentativas por cerca de 24 horas (até 30), histórico de entregas por canal no painel, na API e no MCP, reenvio pelos três, erro da Meta na resposta e no webhook, exportação em CSV ou JSON pela API, MCP pronto e status público.

Você é agência ou dev e vai colocar o WhatsApp de um cliente em produção. A demo mostra a mensagem chegando. Ela não mostra o seu endpoint fora do ar às três da manhã, nem a mensagem que a Meta recusou sem ninguém ver.

Este é o lado técnico da avaliação. A versão para o dono do negócio, com as oito perguntas em linguagem simples, está em Antes de contratar a API do WhatsApp: 8 perguntas para fazer ao fornecedor.

Webhooks: o que acontece quando o seu endpoint cai

Pergunte ao provedor:

  • Por quanto tempo ele tenta de novo, e quantas vezes?
  • Um evento que o seu receptor recusa trava a fila dos outros?
  • Onde você vê o histórico de entregas?
  • O que acontece com o evento que esgotou as tentativas?

Teste na prática: faça o seu receptor devolver erro por um tempo e veja o que chega depois e o que aparece no histórico.

No BotoZap, o webhook tenta de novo por cerca de 24 horas (até 30 tentativas). Um evento recusado não trava os outros. O histórico de entregas fica visível por canal (cada número conectado) no painel, na API e no MCP. Se um evento esgotar as tentativas, ele fica guardado e você reenvia pelo painel (Configurações › Operação), pela API ou pelo MCP. A referência está em Webhooks e Confiabilidade.

O erro da Meta, do jeito que a Meta mandou

O erro aparece em dois momentos. Na hora do envio, quando a Meta recusa o pedido. E depois, quando a mensagem foi aceita e falha na entrega.

Pergunte se o provedor repassa o código numérico da Meta nos dois casos, ou se troca tudo por um "falha no envio". O código é o que você procura na documentação da Meta e o que decide se a sua fila tenta de novo ou para.

No BotoZap, se a Meta recusa na hora, a resposta da API traz a mensagem e o código numérico da Meta. Se a mensagem falha depois de aceita, o webhook leva o erro da Meta como veio: código, título, mensagem e detalhes. A referência está em Erros.

Dados: onde ficam e como saem

Pergunte em que região ficam o banco e as filas, onde estão as regras de retenção e se a exportação sai por API, sem ticket.

No BotoZap, o banco e as filas de processamento ficam em São Paulo. As regras de retenção estão em botozap.com.br/retencao. O administrador exporta contatos (com o registro de consentimento de cada um), conversas e mensagens, em CSV ou JSON, pelo painel ou pela API. Dá para alimentar um BI ou montar uma rotina de backup do cliente. O consentimento de cada contato vem junto. Mais em segurança.

MCP: agente de IA sem escrever o conector

Se o seu cliente quer um agente de IA atendendo ou consultando conversas, pergunte se o provedor tem servidor MCP pronto ou se você vai escrever um.

O BotoZap tem API REST, webhooks e servidor MCP prontos, inclusive para o ChatGPT. O mesmo MCP mostra o histórico de entregas dos webhooks e reenvia eventos. A referência está em MCP.

Status público

Pergunte onde você confere se o serviço está no ar sem abrir chamado. A boa resposta é uma página pública com a disponibilidade medida.

A do BotoZap é status.botozap.com.br (abre em nova aba).

A conta no portfólio do cliente

Propriedade da conta também é assunto técnico. Desde 2025, a Meta não aceita novos cadastros no modelo On-Behalf-Of, em que o provedor criava a conta no portfólio dele. O último dia foi 29/09/2025, e as contas antigas deveriam passar para os clientes até 01/10/2025 (documentação da Meta (abre em nova aba)).

No BotoZap, a conexão é pelo cadastro oficial da Meta (Embedded Signup). A conta do WhatsApp fica no portfólio do cliente, o BotoZap entra como parceiro e ninguém passa senha nem token. Número e templates são do cliente. Veja como conectar pelo Embedded Signup. Se você atende vários clientes, veja alternativa à Evolution API para multi-tenant e como migrar da Evolution API para a API oficial.

Checklist

PontoO que perguntarBotoZap
Novas tentativasPor quanto tempo e quantas vezes?Cerca de 24 horas, até 30 tentativas
IsolamentoUm evento recusado trava os outros?Não trava
HistóricoOnde vejo as entregas?Por canal, no painel, na API e no MCP
ReenvioQuem reenvia o que esgotou?Você, pelo painel, pela API ou pelo MCP
Erro da MetaO código chega inteiro?Na resposta da API e no webhook
ExportaçãoSai por API?CSV ou JSON, pelo painel ou pela API
AgentesTem MCP pronto?Sim, inclusive para o ChatGPT
StatusPágina pública?status.botozap.com.br

Comece pelo número oficial

No BotoZap, o WhatsApp oficial conecta em minutos pelo cadastro oficial da Meta, só API ou em coexistência com o app do celular. A equipe do cliente atende pelo painel, e você integra pela API e pelo MCP. Comece em botozap.com.br.

Na documentação

Perguntas frequentes

Por quanto tempo o BotoZap tenta entregar um webhook?

Por cerca de 24 horas, até 30 tentativas. Um evento recusado não trava os outros.

Como reenvio um webhook que esgotou as tentativas?

O evento fica guardado. Depois de corrigir o receptor, você reenvia pelo painel (Configurações › Operação), pela API ou pelo MCP.

O erro da Meta chega inteiro?

Sim. Se a Meta recusa na hora, a resposta da API traz a mensagem e o código numérico da Meta. Se a mensagem falha depois de aceita, o webhook leva código, título, mensagem e detalhes, como a Meta mandou.

Dá para exportar os dados por API?

Sim. O administrador exporta contatos (com o registro de consentimento), conversas e mensagens, em CSV ou JSON, pelo painel ou pela API.

O BotoZap tem servidor MCP?

Sim. API REST, webhooks e servidor MCP prontos, inclusive para o ChatGPT.