// guia

Antes de contratar a API do WhatsApp: 8 perguntas para fazer ao fornecedor

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

Balão de conversa com ponto de interrogação ao lado de três propostas, uma delas examinada com uma lupa e marcada com um check verde

Resposta rápida

Antes de assinar com um fornecedor da API oficial do WhatsApp, pergunte de quem é a conta, se o app do celular continua funcionando, quem cobra as mensagens, onde ficam os dados, como fica registrado o consentimento, o que acontece quando algo falha, onde ver se o serviço está no ar e como ligar os seus sistemas e a sua IA. Uma boa resposta é concreta e dá para conferir. No BotoZap, a conta fica no portfólio da sua empresa na Meta, a conexão sai em minutos pelo cadastro oficial da Meta e o app continua funcionando no mesmo número.

Uma clínica com duas recepcionistas atende tudo pelo WhatsApp Business no celular. A dona quer mandar lembretes automáticos e dividir o atendimento entre as duas. Ela recebe três propostas. Todas dizem "API oficial". O preço muda pouco.

O que muda é o que acontece depois da assinatura. E isso só aparece quando você pergunta.

Duas palavras antes de começar. A API é a porta que deixa um sistema mandar e receber mensagens no seu número sem ninguém digitar no celular. O fornecedor (ou provedor) é a empresa que liga o seu número a essa porta e entrega o painel para a equipe.

Abaixo estão as oito perguntas, na ordem em que fazem diferença. Para cada uma: por que importa, como é uma boa resposta e como o BotoZap responde.

1. A conta do WhatsApp fica no nome de quem?

Por que importa: Toda empresa que usa a API tem uma conta do WhatsApp na Meta. O seu número e os seus modelos de mensagem aprovados (os templates) ficam ligados a ela. Se essa conta estiver no nome de outra empresa, quem decide sobre o seu canal de atendimento não é você.

A Meta mudou essa regra. O modelo em que o fornecedor criava a conta no portfólio dele, chamado On-Behalf-Of, aceitou cadastros só até 29/09/2025. As contas antigas deveriam passar para os clientes até 01/10/2025. Os detalhes estão na documentação da Meta sobre o fim desse modelo (abre em nova aba).

Como é uma boa resposta: "A conta fica no portfólio da sua empresa na Meta." Portfólio é o espaço da sua empresa na Meta, onde ficam as páginas e contas do negócio. Não aceite só a frase. Peça para ver a conta do WhatsApp dentro do seu portfólio. E repare se pedem a senha do seu Facebook ou alguma chave de acesso. Uma boa conexão não precisa disso.

Como o BotoZap responde: A conexão é feita pelo cadastro oficial da Meta (o Embedded Signup), numa janela da própria Meta. A conta fica no portfólio da sua empresa, e o BotoZap entra só como parceiro. Você não passa senha nem token (a chave de acesso técnica) para ninguém. O número e os modelos de mensagem são seus. O passo a passo está em como conectar o WhatsApp pelo Embedded Signup.

2. Posso continuar usando o app WhatsApp Business no mesmo número?

Por que importa: Muita empresa vive no app do celular. Se a API obrigar a largar o app, a equipe muda o jeito de trabalhar de um dia para o outro. E as conversas antigas ficam no celular.

Existe uma regra da Meta que pouca gente conhece. Depois que o número conecta, o fornecedor tem 24 horas para pedir os contatos e o histórico do app, e só pode pedir uma vez. Se perder o prazo, a empresa precisa refazer a conexão. O histórico cobre até 180 dias, e fotos, áudios e arquivos vêm só das mensagens dos últimos 14 dias. A regra está na documentação da Meta sobre usuários do app WhatsApp Business (abre em nova aba).

Como é uma boa resposta: "Sim, com a coexistência: o app e a API funcionam juntos no mesmo número." Depois pergunte quando eles pedem contatos e histórico, quanto histórico vem e quem escolhe.

Como o BotoZap responde: Sim, com a coexistência. O app e a API funcionam juntos no mesmo número. Os contatos são pedidos assim que o número conecta. O histórico vem conforme a sua escolha: nada, o último mês ou os últimos 6 meses. Se você não escolher, vem o último mês, dentro do prazo de 24 horas da Meta. Veja mais em coexistência no WhatsApp.

3. O fornecedor cobra alguma coisa por cima da tarifa da Meta?

Por que importa: A Meta cobra pelas mensagens. Quando esse valor passa pela fatura do fornecedor, fica difícil saber quanto é da Meta e quanto é do fornecedor. E fica difícil comparar propostas.

Como é uma boa resposta: "A Meta cobra as mensagens direto de você. A nossa assinatura é separada." Peça para ver onde fica configurado o pagamento das mensagens.

Como o BotoZap responde: O BotoZap não cobra nada por cima da Meta. A Meta cobra as mensagens direto no pagamento configurado na conta da sua empresa, separado da assinatura do BotoZap. Para entender os valores da Meta, veja quanto custa a API oficial do WhatsApp.

4. Onde ficam os meus dados, e consigo exportar tudo?

Por que importa: As conversas com os seus clientes têm nome, telefone e o que eles disseram. Você precisa saber em que país isso fica e por quanto tempo fica guardado. E precisa conseguir puxar os dados para uma planilha, um relatório ou uma auditoria, sem depender de pedido ao suporte.

Como é uma boa resposta: Uma cidade ou um país, uma página pública com as regras de quanto tempo cada dado fica guardado e uma exportação que você mesmo faz, num formato que abre em qualquer planilha.

Como o BotoZap responde: O banco de dados e as filas de processamento ficam em São Paulo. As regras de retenção estão em botozap.com.br/retencao. O administrador da conta exporta contatos (com o registro de consentimento de cada um), conversas e mensagens, em CSV ou JSON, pelo painel ou pela API. CSV abre no Excel e no Google Planilhas. Mais detalhes em segurança e privacidade.

5. Fica registrado quem aceitou receber mensagens?

Por que importa: Se um cliente perguntar por que recebeu uma mensagem, você precisa mostrar que ele aceitou. E quem pediu para parar precisa conseguir voltar sem que alguém da sua equipe tenha que mexer em cadastro.

Como é uma boa resposta: "O consentimento fica registrado em cada contato, você vê no painel e ele sai na exportação." E a pessoa tem um jeito simples de voltar a receber.

Como o BotoZap responde: O consentimento fica registrado por contato e sai junto na exportação. Quem recusou mensagens pode voltar a receber sozinho, pelo botão do pedido de consentimento ou mandando "voltar".

6. O que acontece quando algo falha?

Por que importa: Falha acontece. O sistema da sua agenda fica uma hora fora do ar. Uma mensagem é recusada pela Meta. A questão é se você fica sabendo, se perde alguma coisa e se descobre o motivo.

Aqui entram duas coisas. A primeira é o aviso automático que o fornecedor manda para outro programa seu quando chega uma mensagem (o nome técnico é webhook). É ele que faz a sua agenda ou o seu sistema de pedidos reagir sozinho. A segunda é a recusa de uma mensagem pela Meta.

Como é uma boa resposta: Para os avisos: o fornecedor tenta de novo quando o seu sistema está fora, mostra o histórico do que foi entregue e deixa você reenviar o que ficou para trás. Para as recusas: ele mostra o motivo real, como a Meta mandou, e não um "erro desconhecido".

Como o BotoZap responde: Se o seu sistema estiver fora do ar, o BotoZap tenta entregar o aviso de novo por cerca de 24 horas (até 30 tentativas). Um aviso 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 aviso esgotar as tentativas, ele fica guardado e você mesmo reenvia, pelo painel em Configurações › Operação, pela API ou pelo MCP.

Quando a Meta recusa uma mensagem, você vê o erro real nos dois momentos. Se ela recusa na hora do envio, a resposta traz a mensagem e o código numérico da Meta. Se a mensagem falha depois de aceita, o aviso leva o erro da Meta como veio: código, título, mensagem e detalhes.

7. Como eu sei se o serviço está no ar?

Por que importa: Quando o atendimento para, a primeira pergunta é "o problema é aqui ou é lá?". Sem uma página de status, a resposta depende de alguém do suporte.

Como é uma boa resposta: Uma página pública, que qualquer pessoa da sua equipe abre sem login, com a disponibilidade medida.

Como o BotoZap responde: Em status.botozap.com.br (abre em nova aba), com a disponibilidade medida.

8. Dá para ligar o meu sistema e o meu agente de IA?

Por que importa: O atendimento conversa com outras ferramentas: agenda, sistema de pedidos, planilha de vendas. E talvez você queira um assistente de IA ajudando a responder. Se o fornecedor só tem o painel, tudo isso vira trabalho manual.

Como é uma boa resposta: Uma API documentada, os avisos automáticos para os seus sistemas e um servidor MCP pronto. MCP é um padrão que deixa um assistente de IA, como o ChatGPT, usar as funções de outro sistema.

Como o BotoZap responde: API REST, webhooks e servidor MCP prontos, inclusive para o ChatGPT. Quem opera usa o painel e a caixa de conversas. Quem constrói usa a API e o MCP. As duas coisas funcionam juntas no mesmo número.

As oito perguntas numa tabela

PerguntaBoa respostaBotoZap
De quem é a conta?No portfólio da sua empresa na MetaNo seu portfólio, pelo cadastro oficial da Meta, sem passar senha nem token
O app continua?Sim, com coexistênciaSim. Contatos pedidos na conexão, histórico de nada a 6 meses, à sua escolha
Cobra por cima da Meta?A Meta cobra direto de vocêA Meta cobra na sua conta, separado da assinatura
Onde ficam os dados?Local definido, regras públicas, exportação suaSão Paulo, regras de retenção, CSV ou JSON pelo painel ou pela API
Consentimento registrado?Por contato e exportávelPor contato, sai na exportação, a pessoa volta a receber sozinha
Quando algo falha?Novas tentativas, histórico, reenvio e erro realCerca de 24 horas de tentativas, histórico por canal, reenvio por você, erro da Meta como veio
Está no ar?Página pública de statusstatus.botozap.com.br (abre em nova aba)
Liga com IA e sistemas?API, webhooks e MCPAPI REST, webhooks e MCP, inclusive para o ChatGPT

Como usar as perguntas

Mande as oito por escrito para cada fornecedor e compare as respostas lado a lado. Resposta concreta mostra que o fornecedor já pensou no assunto. Resposta vaga também diz muito.

Se hoje você usa uma ferramenta não oficial, veja Z-API ou API oficial e como migrar da Evolution API para a API oficial. Se você atende várias empresas, veja como revender WhatsApp oficial.

Conectar o seu número leva minutos

No BotoZap, você conecta o WhatsApp oficial em minutos, pelo cadastro oficial da Meta. Pode manter o app no mesmo número, com a coexistência. A conta fica no portfólio da sua empresa e a equipe atende pelo painel. Comece em botozap.com.br.

Na documentação

Perguntas frequentes

O fornecedor pode criar a conta do WhatsApp no portfólio dele?

Não para cadastros novos. A Meta encerrou o modelo On-Behalf-Of: o último dia para cadastrar nesse modelo foi 29/09/2025, e as contas antigas deveriam passar para os clientes até 01/10/2025. Peça para ver a conta do WhatsApp dentro do seu portfólio na Meta.

Contratar a API obriga a largar o app WhatsApp Business?

Não. Com a coexistência, o app e a API funcionam juntos no mesmo número. No BotoZap, a conexão é feita pelo cadastro oficial da Meta e você escolhe manter o app.

O histórico do celular vem para o painel?

Sim, conforme a sua escolha: nada, o último mês ou os últimos 6 meses. Se você não escolher, vem o último mês. A Meta dá 24 horas depois da conexão para esse pedido, o histórico cobre até 180 dias e os arquivos de mídia vêm só das mensagens dos últimos 14 dias.

O BotoZap cobra as mensagens da Meta?

Não. A Meta cobra as mensagens direto no pagamento configurado na conta da sua empresa, separado da assinatura do BotoZap.

Onde ficam os dados no BotoZap?

O banco de dados e as filas de processamento ficam em São Paulo. As regras de retenção estão em botozap.com.br/retencao, e o administrador exporta contatos, conversas e mensagens em CSV ou JSON, pelo painel ou pela API.

O que é MCP?

É um padrão que deixa um assistente de IA, como o ChatGPT, usar as funções de outro sistema. O BotoZap tem servidor MCP pronto, além de API REST e webhooks.