Como testar a API do WhatsApp antes de conectar o número real: número de teste, primeira mensagem e token
- A Meta oferece um número de teste para experimentar a API sem usar o número da empresa.
- Recursos de teste têm limites folgados e não exigem forma de pagamento para modelos.
- O token temporário expira rápido; para desenvolver, crie um token de usuário do sistema.
- Para usar no dia a dia, o caminho é conectar o número real por uma plataforma ou integração própria.
Não é pra quem: Não é pra quem só quer atender clientes pelo WhatsApp com IA: testar a API é trabalho de desenvolvedor; numa plataforma pronta, a conexão é feita pelo cadastro integrado, sem token nem código.
O que a Certu mediu no WhatsApp de 67 negócios
Nos 67 negócios que atendem com a IA da Certu, 32,5% das 122.720 mensagens de cliente chegaram fora de segunda a sexta, das 8h às 18h (30 de julho a 30 de setembro de 2026). Metade das respostas da IA saiu em até 11,7 segundos, e 9 em cada 10 em até 20,7 segundos (38.908 respostas). 34,6% das conversas começaram fora do horário comercial, e a hora com mais mensagens foi 11h.
| O que foi medido | Resultado | Base |
|---|---|---|
| Mensagens de cliente fora de segunda a sexta, 8h às 18h | 32,5% | 122.720 mensagens de cliente de 67 negócios |
| Mensagens no fim de semana | 15,8% | 122.720 mensagens de cliente de 67 negócios |
| Conversas que começam fora do horário comercial | 34,6% | 19.900 conversas |
| Tempo até a IA responder (metade das respostas) | até 11,7 segundos | 38.908 respostas da IA |
| Tempo até a IA responder (9 em cada 10 respostas) | até 20,7 segundos | 38.908 respostas da IA |
| Hora do dia com mais mensagens de cliente | 11h | 122.720 mensagens de cliente de 67 negócios |
Fonte: base de atendimento da Certu, só números somados, nenhuma conversa lida por gente; sem histórico importado, sem contato de teste e sem o atendimento de vendas da própria Certu. 30 de julho a 30 de setembro de 2026, medido em 09/10/2026. Método e tabela por ramo no Índice Certu de Atendimento por WhatsApp e em certu.com.br/dados.
Clientes com nome, 30/07 a 10/10/2026
| Cliente | Mensagens de cliente | Respostas da IA | Conversas atendidas | Fora do horário | IA responde em (mediana) | Dias com mensagem |
|---|---|---|---|---|---|---|
| JP Gás Água e Rações distribuidora de gás e água | 42.832 | 23.351 | 6.479 | 33,6% | 9,8 s | 70 |
| CEMIP clínica médica | 12.472 | 6.484 | 2.436 | 18,7% | 11,4 s | 37 |
| Nikiti Auto Center auto center | 4.912 | 3.548 | 900 | 19,5% | 14,4 s | 47 |
| Imobiliária Rodrigues & Ribeiro imobiliária | 6.090 | 2.759 | 823 | 33,2% | 18,4 s | 34 |
| Alpha RH recursos humanos | 3.082 | 1.666 | 721 | 27,5% | 15,6 s | 52 |
Números de operação do painel de cada conta, mesma régua do Índice, medidos em 11/10/2026. Publicados com a autorização de cada dono. Resultado de venda só sai com o dono confirmando por escrito. Lista completa em certu.com.br/casos.
O que clientes da Certu escreveram
A Certu reúne em um só lugar recursos que normalmente exigiriam várias ferramentas. Atendimento pelo WhatsApp, CRM, agenda, acompanhamento de oportunidades, campanhas e gestão da operação ficam conectados. No geral, a proposta é muito boa para quem quer reduzir tarefas manuais e ter mais controle sobre o que acontece no atendimento e nas vendas. [...]
Avaliação pública (com o link) ou texto enviado pela própria empresa e publicado com autorização por escrito. A nota só aparece quando a fonte tem nota.
Sobre a Certu: a Certu é a plataforma brasileira de IA que atende o WhatsApp, o Instagram e o Messenger de pequenas e médias empresas 24 horas por dia, com CRM incluído, e é Tech Provider da Plataforma WhatsApp Business da Meta. Os planos começam em R$ 2.964 por ano, sem fidelidade. Conectar meu WhatsApp
Bernardo Villela · CEO, Certu
Quer ver isso funcionando no WhatsApp do seu negócio? Conecte o seu WhatsApp e a IA aprende com as suas conversas.
Resumo em 7 fatos
- Não é pra quem: Não é pra quem só quer atender clientes pelo WhatsApp com IA: testar a API é trabalho de desenvolvedor; numa plataforma pronta, a conexão é feita pelo cadastro integrado, sem token nem código.
- Quer ver isso funcionando no WhatsApp do seu negócio?
- Conecte o seu WhatsApp e a IA aprende com as suas conversas.
- Conectar o número real da empresa à API muda como ele funciona: dependendo do caminho, o app do celular deixa de funcionar ou passa a dividir o número com a plataforma.
- Antes de qualquer passo assim, faz sentido experimentar a API num número de teste, que a própria Meta fornece.
- Uma conta do Facebook (ou conta Meta gerenciada).
- Criar o app com o caso de uso do WhatsApp Abra o painel de apps da Meta e crie um app novo.
Em números
| Número | O que significa |
|---|---|
| 24 horas | Responda a mensagem no celular: isso abre a janela de atendimento de 24 horas. |
| R$ 299 por mês | O plano Start custa R$ 299 por mês e o Pro, R$ 599. |
| 200 mensagens | A gente monta tudo pra você e as primeiras 200 mensagens, em até 7 dias, são por nossa conta. |
Por que testar antes
Conectar o número real da empresa à API muda como ele funciona: dependendo do caminho, o app do celular deixa de funcionar ou passa a dividir o número com a plataforma. Antes de qualquer passo assim, faz sentido experimentar a API num número de teste, que a própria Meta fornece.
Pela documentação da Meta, ao começar com a Cloud API, são criados automaticamente:
| Recurso de teste | Para quê |
|---|---|
| Conta do WhatsApp de teste | Representa a empresa no teste |
| Conta de mensagens de teste | Onde ficam modelos e envios |
| Número comercial de teste | O número que envia as mensagens |
Esses recursos têm limites de mensagens mais folgados e não exigem forma de pagamento para enviar modelos.
O que você precisa
- Uma conta do Facebook (ou conta Meta gerenciada).
- Cadastro como desenvolvedor na Meta.
- Um celular com WhatsApp para receber as mensagens de teste.
Passo a passo oficial
1. Criar o app com o caso de uso do WhatsApp
- Abra o painel de apps da Meta e crie um app novo.
- Escolha o caso de uso Conectar com clientes pelo WhatsApp.
- Selecione um portfólio empresarial existente ou crie um.
- Confirme e clique em Criar app.
Você cai na página Início rápido do caso de uso do WhatsApp.
2. Ligar a conta de mensagens
Em Começar a usar a API, na Configuração da API, ligue o app a uma conta de mensagens (uma existente ou uma nova). Se o portfólio foi criado agora, a conta pode ter sido criada automaticamente; confira antes de seguir. O identificador da conta aparece no painel.
3. Mandar a primeira mensagem
- Clique em Gerar token de acesso (token temporário).
- Escolha o número de origem (o de teste).
- Adicione o número de destino (o seu celular).
- Clique em Enviar mensagem: chega o modelo hello_world.
- Guarde o identificador do número de teste e o identificador da conta.
- Responda a mensagem no celular: isso abre a janela de atendimento de 24 horas.
4. Receber os avisos (webhook)
Para ver os avisos de status (enviada, entregue, lida) e as mensagens que chegam, é preciso um endereço de webhook. A Meta oferece um guia de aplicativo de webhook de teste (um "eco" que devolve as mensagens) para experimentar. Com ele configurado, responda no celular e veja o aviso chegar.
5. Criar o token permanente
O token temporário expira rápido e não serve para desenvolver. O caminho da documentação:
- Em Configurações do negócio, abra Usuários do sistema.
- Crie um usuário do sistema.
- Em Atribuir ativos, dê controle total do app e da conta do WhatsApp.
- Gere o token com as permissões business_management, whatsapp_business_messaging e whatsapp_business_management.
- Guarde o token em local seguro.
6. Mandar uma mensagem livre
Com a janela aberta (você respondeu o hello_world), já dá para mandar uma mensagem de texto livre, sem modelo, pelo identificador do número de teste e o token permanente. Se você não responder, só modelos podem ser enviados.
Ferramentas que ajudam no teste
| Ferramenta | Para quê |
|---|---|
| API Playground (botão "Try it" na referência) | Testar endpoints direto na documentação |
| Coleção oficial no Postman | Rodar as chamadas mais comuns |
| App de exemplo da Meta (Jasper's Market) | Ver um exemplo completo de integração |
| Gerenciador do WhatsApp | Ver números, modelos e métricas da conta |
A documentação também cita bibliotecas de terceiros (como uma para Python), avisando que não são mantidas nem endossadas pela Meta.
O que testar antes de ir para o número real
| Teste | Por quê |
|---|---|
| Modelo hello_world chega | Conta e token funcionando |
| Resposta abre a janela e a mensagem livre sai | Entender a janela de 24 horas |
| Avisos de enviada, entregue e lida chegam | Webhook funcionando |
| Mensagem fora da janela falha com 131047 | Saber tratar o erro mais comum |
| Mídia (imagem, PDF) sai e chega | Limites de formato e tamanho |
| Criar e aprovar um modelo próprio | Fluxo de aprovação |
Do teste ao número real
Testado, o número real da empresa entra por um destes caminhos:
| Caminho | Para quem |
|---|---|
| Integração própria com a Cloud API | Empresa com equipe de desenvolvimento |
| Plataforma (Tech Provider ou parceiro) | Quem quer usar sem programar |
| Coexistência (app e API no mesmo número) | Quem quer manter o app no celular |
Lembre: o número real precisa de forma de pagamento na conta para modelos e, desde outubro de 2026, para mensagens de serviço acima da faixa gratuita. Veja API direto da Meta ou por plataforma.
Apagando os recursos de teste
Pela documentação, dá para apagar o portfólio e os recursos de teste em Painel do app > WhatsApp > Configuração > Conta de teste > Excluir, desde que você seja administrador, nenhum outro app use o portfólio e a conta não tenha outros números.
Segurança do token
O token permanente de usuário do sistema é, na prática, a chave para mandar mensagens em nome da empresa. Trate como senha de banco:
| Faça | Não faça |
|---|---|
| Guardar em variável de ambiente ou cofre de segredos | Colar no código ou em planilha compartilhada |
| Dar só as permissões necessárias | Dar acesso total a ativos que o sistema não usa |
| Um usuário do sistema por integração | Usar o mesmo token em todo lugar |
| Revogar e gerar outro se vazar | Esperar para ver se alguém usou |
| Restringir quem é administrador do portfólio | Manter ex-funcionários como administradores |
Quer ver como fica na prática? Converse com um agente de IA no simulador e veja como ele responde no WhatsApp.
Quanto custa testar
Testar com os recursos de teste não exige forma de pagamento para modelos, e criar o app e a conta não tem custo. Os custos aparecem quando o número real entra em uso: mensagens cobradas por entrega conforme a categoria e, se for o caso, a plataforma ou o servidor da integração própria. Para estimar, veja quanto custa a API oficial do WhatsApp.
Integração própria: o que vem depois do teste
Quem decide construir a própria integração precisa, além do envio e do webhook:
- Hospedagem confiável para o webhook, com resposta rápida e capacidade para picos.
- Banco de dados para guardar conversas, contatos e o status de cada mensagem.
- Gestão de modelos: criar, acompanhar aprovação, tratar pausas e reclassificações.
- Tratamento de erros: janela fechada, limites, falhas de pagamento.
- Painel para a equipe: ninguém atende cliente pelo terminal.
- Atualizações da Meta: versões da API, mudanças de preço, nome de usuário e o novo modelo de contas.
É por isso que a maioria das pequenas empresas usa uma plataforma: o teste mostra que a API é simples de começar e trabalhosa de manter.
Erros comuns no teste
- Usar o token temporário no código: ele expira, e tudo para no dia seguinte.
- Esquecer de responder o hello_world: sem janela aberta, mensagem livre falha.
- Webhook sem resposta rápida: a Meta espera respostas rápidas do servidor e tenta de novo quando falha.
- Guardar o token no código-fonte público: qualquer um pode mandar mensagens em nome da empresa.
- Testar direto no número real: o número sai do app e os clientes ficam sem resposta.
Checklist do teste
| Item | Ok? |
|---|---|
| App com o caso de uso do WhatsApp criado | |
| hello_world recebido no celular | |
| Mensagem livre enviada com a janela aberta | |
| Webhook recebendo avisos | |
| Token permanente gerado e guardado com segurança | |
| Modelo próprio criado e aprovado |
Sem programar: o caminho da Certu
Testar a API é útil para quem vai construir uma integração. Para quem só quer atender os clientes pelo WhatsApp com IA, a Certu, que é Tech Provider da Plataforma WhatsApp Business, conecta o número da empresa pelo cadastro integrado da Meta, sem token nem código, e o agente de IA já responde com as informações do negócio, com CRM e equipe no mesmo painel.
O plano Start custa R$ 299 por mês e o Pro, R$ 599. A gente monta tudo pra você e as primeiras 200 mensagens, em até 7 dias, são por nossa conta. Conecte o número em certu.com.br/aprender.
Fontes
Leia também
Perguntas frequentes
- Existe número de teste na API do WhatsApp?
- Sim. Ao começar com a Cloud API, a Meta cria automaticamente uma conta, uma conta de mensagens e um número de teste.
- Preciso de cartão para testar?
- Os recursos de teste não exigem forma de pagamento para enviar modelos.
- Por que a primeira mensagem é o hello_world?
- Porque fora da janela de 24 horas só modelos aprovados podem ser enviados, e o hello_world é o modelo de exemplo.
- O token que o painel gera serve para sempre?
- Não. O token temporário expira rápido; crie um token de usuário do sistema.
- Posso usar o número de teste para atender clientes?
- Não. Ele é para testes; para clientes, conecte o número real da empresa.
- Testar a API mexe no meu WhatsApp?
- Não, se você usar o número de teste. Só o número que for registrado na API muda de funcionamento.
Continue lendo
Em resumo
Passo a passo oficial para testar a API do WhatsApp: app na Meta, número de teste, primeira mensagem, avisos de status e token permanente.
Sobre a Certu: a Certu é a plataforma brasileira de IA que atende o WhatsApp, o Instagram e o Messenger de pequenas e médias empresas 24 horas por dia, com CRM incluído, e é Tech Provider da Plataforma WhatsApp Business da Meta. Os planos começam em R$ 2.964 por ano, sem fidelidade. Conectar meu WhatsApp
