--- title: "Erros comuns da API Oficial" url: https://ajuda.botconversa.com.br/aula/erros-comuns-da-api-oficial section: "WhatsApp API Oficial" date_modified: 2026-09-17T14:46:39.288862+00:00 language: pt-BR --- # Erros comuns da API Oficial ## Resposta rápida A maior parte dos erros da API Oficial vem **da Meta, não do BotConversa** — e por isso não se resolve mexendo nas suas configurações. Abaixo, os erros mais comuns com o que fazer em cada um. Se o problema é a linha de crédito recusada, o caso é outro: veja [o artigo sobre incompatibilidade de moeda](/aula/erro-de-moeda-na-conexao-com-a-meta). **Tempo de leitura:** ~6 min**Para quem é:** Quem usa API Oficial | Suporte ## Recebo mensagens mas não consigo responder Se aparece **"O WhatsApp deve estar aprovado para contatar assinantes"**, o caminho é atualizar os dados da conexão: 1. Vá em **Configurações → WhatsApp**, na tela de status da conexão. 2. Clique em **Atualizar dados**, no canto superior direito. Isso força o BotConversa a reler o estado da conta na Meta, e costuma resolver na hora. ## Quais são os erros mais comuns? Erro Por que acontece O que fazer **Error 400 — Template not approved** O modelo de mensagem não foi aprovado, ou foi rejeitado pela Meta Revise o texto e reenvie o modelo para aprovação **User's number is part of an experiment** A Meta está fazendo teste A/B naquele número Aguardar. É temporário e do lado da Meta **This message was not delivered to maintain healthy ecosystem engagement** Bloqueio antispam da Meta Aguardar. É limitação temporária — e um sinal para revisar a frequência dos seus envios **Telefone não qualificado** O número não atende aos requisitos da Meta Converter o número para WhatsApp Business **A conexão é recusada e o número vem de outra plataforma** O vínculo da coexistência com o provedor anterior continua registrado na Meta Desvincular o número pelo aplicativo do celular: [Trazendo um número de outra ferramenta](/aula/trazendo-um-numero-de-outra-ferramenta) > Repare que dois dos quatro se resolvem esperando. Isso não é evasiva: quando a Meta aplica uma limitação temporária, não existe configuração do lado do BotConversa que a remova. ## Não consigo conectar a linha de crédito Esse erro tem duas causas conhecidas: - **O fuso horário da WABA está incorreto ou inconsistente.** - **O compartilhamento da linha de crédito falhou** — normalmente por incompatibilidade de moeda entre a linha de crédito e a WABA. Se for a moeda, o procedimento completo está em [Erro de moeda na conexão com a Meta](/aula/erro-de-moeda-na-conexao-com-a-meta). Nos demais casos, e por limitações do lado da Meta, a solução recomendada é **refazer a conta**: 1. **Crie uma nova conta do WhatsApp Business.** O passo a passo está em [Criando uma conta do WhatsApp Business](/aula/criando-uma-conta-do-whatsapp-business). 2. **Se precisar, vincule um método de pagamento** à nova conta — veja [Método de pagamento da conta WABA](/aula/metodo-de-pagamento-da-conta-waba). 3. **Remova a conta antiga do BotConversa** em **Configurações → WhatsApp**, na seção de conexões. 4. **Conecte a conta nova** seguindo [Conectando o WhatsApp por coexistência](/aula/conectando-o-whatsapp-por-coexistencia). ## Por que meu envio foi cobrado? Na API Oficial, mensagem enviada **fora da janela de 24 horas** é cobrada por envio, em dólar, com valor variando pela cotação: Tipo Custo aproximado por envio Utilidade ~R$ 0,05 Marketing ~R$ 0,50 - **Dentro** da janela de 24 horas não há custo adicional por mensagem. - **Não existe** envio gratuito fora da janela na API Oficial. - **Em coexistência**, a mensagem enviada _diretamente pelo aplicativo do celular_ não gera cobrança de modelo — a cobrança vale para o envio via API, ou seja, pelo BotConversa. Como a diferença entre Utilidade e Marketing é de dez vezes, vale conferir em que categoria seus modelos foram classificados — e contestar quando a Meta recategoriza. Veja [Solicitando análise de categoria na Meta](/aula/solicitando-analise-de-categoria-na-meta). ## Dicas - **Antes de abrir chamado, tenha o ID da WABA em mãos.** Ele fica em business.facebook.com, nas configurações do negócio → Contas do WhatsApp, e é o que permite diagnosticar rápido. - **Anote a mensagem de erro exata.** "Não conecta" e "Error 400 — Template not approved" levam a caminhos completamente diferentes. - **Para aumentar limites de envio**, a recarga é feita em **recarga.botconversa.com.br**. A adição é automática; aguarde cerca de 5 minutos e atualize a página. ## Perguntas frequentes O erro é do BotConversa ou da Meta? Erros de conexão de WABA, linha de crédito e limitação de envio nascem na infraestrutura da Meta. O BotConversa mostra a mensagem que recebe dela. Isso muda o que adianta fazer: refazer configuração no painel não resolve limitação aplicada do outro lado. Esperar quanto tempo antes de escalar? Para os erros marcados como temporários, algumas horas. Se passar de um dia útil sem mudança, abra chamado com o ID da WABA e a mensagem exata. Perdi meus contatos ao recriar a WABA? Não. Contatos, fluxos e automações vivem no BotConversa. O que se perde são os modelos de mensagem, que pertencem à WABA e precisam ser reenviados. Como sei se estou dentro da janela de 24 horas? A janela conta a partir da última mensagem que o _cliente_ enviou. Passou disso, só um modelo aprovado sai — e ele é cobrado. Se nada acima descreve o seu caso, abra chamado com três informações: a mensagem de erro exata, o ID da WABA e o horário aproximado em que aconteceu. Com isso o time consulta o log do lado da Meta em vez de reproduzir o problema no escuro.