Quando os templates não aparecem novo BSP, a causa quase sempre está em etapas anteriores da migração: número não verificado, PIN pendente ou nome da empresa ainda não aprovado.
Esse bloqueio trava o go-live e gera retrabalho para a equipe técnica. A sincronização de templates depende de uma sequência hierárquica de pré-requisitos no WhatsApp Business Platform.
Por que os templates não aparecem no novo provedor do WhatsApp?
O erro mais comum na migração é pular etapas de verificação. O número do remetente precisa estar verificado, o PIN validado e o nome da empresa aprovado antes de qualquer template sincronizar.
Se algum desses passos ficou pendente, a API oficial do WhatsApp não lista os templates no novo BSP. A ordem correta é: verificar número, confirmar PIN, aprovar nome da empresa e só então configurar webhooks.
Equipes que diagnosticam cada bloqueio com sequência segura de testes reduzem o tempo de inatividade e evitam escalar problemas à Meta sem evidência clara.
Teste cada pré-requisito isoladamente antes de abrir chamado. Verifique se o número está verificado no painel, se o PIN foi confirmado e se o nome da empresa passou na revisão. Só depois investigue a fila de templates e a configuração de webhooks.
Antes de avançar no diagnóstico, vale revisar se a base da sua operação está sólida. Em migrações de plataforma, erros de configuração de identidade são comuns — veja nosso guia sobre Identity header no SIP: leitura prática para engenheiros de voz para evitar retrabalho em camadas adjacentes.
Checklist para diagnosticar bloqueios de templates no novo provedor
Templates não aparecem novo BSP quando a sequência de validação da conta não foi concluída na ordem correta. Para uma equipe técnica em migração, o diagnóstico depende de testar cada camada isoladamente, sem pular etapas.
Para diagnosticar bloqueios de templates com segurança, siga esta sequência de testes. Cada item tem critério objetivo de aprovação ou reprovação.
- Status do número na API oficial do WhatsApp: Acesse o painel do provedor e confirme se o número está verificado, pendente ou banido. Número em status diferente de verificado bloqueia a exibição de qualquer template, mesmo os já aprovados anteriormente.
- PIN de dois fatores e nome comercial: Confirme se o PIN foi aceito e se o nome exibido está aprovado. Nome reprovado impede a criação de novos modelos de mensagem e pode ocultar templates existentes no painel.
- Status individual do template: Verifique se o template específico está aprovado, rejeitado ou pendente. Template rejeitado exige correção de conteúdo e nova submissão antes de aparecer na lista ativa.
- Webhooks e eventos de entrega: Teste se o webhook está recebendo eventos de delivery e read. Webhook silencioso indica falha de configuração que também afeta a sincronização de status dos templates entre a Meta e o provedor.
- Escalação ao provedor: Após validar os quatro passos anteriores sem sucesso, abra ticket com logs de API, IDs de template, timestamps e o código exato do erro HTTP retornado. Evidências completas aceleram a análise do suporte.
Se o erro persistir após o passo 5, o bloqueio pode estar na Meta, não no provedor. Nesse caso, reúna o protocolo do ticket e solicite revisão manual pela equipe de suporte da Meta, anexando as evidências coletadas.
Se o problema persistir após validar a sequência de pré-requisitos, o bloqueio pode estar relacionado à política de mensagens da plataforma. Entenda o que pode causar restrições no artigo sobre Política de mensagens do WhatsApp: o que pode causar bloqueio e confira se sua conta está em conformidade.
Outro ponto que costuma passar despercebido é a configuração da origem verificada. Se o remetente não aparece corretamente no celular do destinatário, a entrega de templates pode ser impactada. Veja os 12 pontos para testar quando a Origem Verificada não aparece no celular e elimine essa variável do seu diagnóstico.
Tabela: o que fazer em cada cenário de bloqueio
Um template só aparece no gerenciador quando toda a cadeia anterior está validada. Se o número, o PIN ou o nome da empresa falharam, o template nem chega a ser avaliado. A tabela abaixo mostra exatamente onde está o bloqueio e qual ação desbloqueia o go-live.
templates não aparecem novo BSP é uma falha de sequência na migração para a API oficial do WhatsApp: número não verificado, PIN pendente, nome da empresa não aprovado, template rejeitado ou webhook não configurado. O template é o último elo da cadeia, não o primeiro problema.
| Cenário de bloqueio | Causa provável | Ação recomendada para a equipe técnica | Quando escalar |
|---|---|---|---|
| Número não verificado | Token SMS ou chamada não confirmado na conta do WhatsApp Business | Concluir a verificação no painel do provedor e aguardar confirmação antes de avançar | Após 3 tentativas com código correto, abrir chamado com o provedor |
| PIN pendente | PIN de dois fatores não informado ou expirado durante o cadastro | Reenviar o PIN e validar dentro da janela de validade, registrando o horário exato | Se o reenvio falhar, verificar se a conta foi criada com e-mail válido |
| Nome da empresa não aprovado | Nome incompleto, com caracteres especiais ou fora da política da Meta | Revisar o nome conforme as diretrizes oficiais e reenviar para aprovação | Após 2 rejeições, escalar para o suporte do provedor com o ID da conta |
| Template rejeitado | Conteúdo com palavras bloqueadas, falta de variável ou formato incorreto | Corrigir o texto, adicionar variáveis obrigatórias e reenviar para revisão | Rejeições repetidas exigem revisão da política de mensagens da Meta |
| Webhook não configurado | URL do webhook inválida ou sem resposta ao teste de verificação | Configurar a URL no painel e testar com o payload de exemplo da API oficial | Se o teste falhar, verificar firewall… |
Como testar a sincronização de templates sem afetar o atendimento?
Para a equipe técnica no meio da migração para a API oficial do WhatsApp, o bloqueio mais comum é a ausência dos templates no novo BSP. Antes de qualquer ação em produção, isole a validação em um ambiente controlado. Isso permite diagnosticar se a falha está na configuração da conta, na sincronização com o provedor ou no processamento interno do sistema, sem expor clientes ativos a mensagens de erro ou atrasos.
- Configurar um número de teste dedicado — Cadastre um número interno exclusivo para validação na API oficial do WhatsApp. Esse número não deve estar vinculado a nenhum fluxo de atendimento real, servindo apenas como destinatário fixo para os testes de sincronização.
- Conferir a listagem de templates no painel do provedor — Antes de disparar qualquer mensagem, verifique se os templates aprovados aparecem no painel do novo BSP. Se a lista estiver vazia ou desatualizada, o problema está na sincronização entre a conta da Meta e o provedor, não na sua aplicação.
- Disparar um template de teste para o número interno — Envie um template aprovado com variáveis preenchidas e botões configurados. Observe se a mensagem chega ao número de teste com o conteúdo correto, incluindo formatação, quebras de linha e elementos interativos.
- Monitorar o status de entrega na API oficial — Acompanhe o ciclo completo no painel: de “enviada” para “entregue” e depois “lida”. Se o status travar em “enviada”, há falha na rota de entrega ou no webhook de confirmação.
- Validar webhooks com payloads simulados — Envie eventos de teste para o endpoint configurado e confirme se o sistema processa corretamente os callbacks de entrega, leitura e falha. Isso garante que a sincronização funciona ponta a ponta, mesmo quando os templates não aparecem no ambiente visual do provedor.
O que é um BSP e qual o papel dele na sincronização de templates?
BSP (Business Solution Provider) é um parceiro certificado pela Meta que fornece acesso à API oficial do WhatsApp. Ele gerencia a conexão entre sua operação e os servidores da Meta, envia templates e recebe webhooks de status.
Quando os templates não aparecem novo BSP, o problema raramente está no template em si. A falha geralmente está na configuração da conta no provedor ou em etapas anteriores da migração, como número não verificado ou PIN pendente.
O BSP funciona como intermediário técnico: ele autentica sua empresa, gerencia permissões e roteia mensagens. Se a configuração do BSP estiver incorreta, a sincronização de templates falha silenciosamente, sem erro visível no painel.
Para verificar se o BSP está configurado corretamente, confirme que o número foi verificado, o PIN foi aceito e o nome da empresa está aprovado na Meta. Qualquer pendência nessa cadeia impede que os templates sejam exibidos no gerenciador.
Erros comuns incluem usar credenciais de ambiente de teste em produção, esquecer de ativar webhooks ou configurar o DNS errado. Esses erros geram atrasos no go-live e exigem retrabalho na integração com a API oficial do WhatsApp.
Quais erros comuns impedem a sincronização de templates e como evitá-los?
Os cinco erros abaixo concentram a maioria dos bloqueios de sincronização. Cada um tem correção direta e verificável antes de abrir chamado com o provedor.
- Pular a verificação do número. O número precisa confirmar o PIN de seis dígitos antes do template ser criado. Sem essa etapa, o gerenciador fica vazio. Refazer o fluxo de verificação no painel do BSP costuma resolver.
- Ignorar o status do template. Todo template passa por análise da Meta antes de ficar ativo. Status como PENDING ou REJECTED impedem o uso. Consulte o campo
statusna API oficial do WhatsApp para saber exatamente onde está o bloqueio. - Configurar webhooks incorretamente. Sem o webhook de status registrado, sua equipe não recebe atualizações de aprovação ou rejeição. O template pode até ser aprovado, mas o sistema não sincroniza. Valide o endpoint e o token de verificação.
- Não aguardar a aprovação da Meta. Tentar usar um template recém-enviado antes da aprovação gera erro de envio. O tempo de análise varia; o status na API é a única fonte confiável. Evite reenviar o mesmo template repetidamente.
- Usar API não oficial ou QR Code. Integrações por QR Code ou BSPs não certificados não têm acesso ao gerenciador de templates da Meta. Essas conexões quebram a sincronização e podem levar ao bloqueio permanente do número. A migração para a API oficial do WhatsApp é pré-requisito para operar com templates.
Erros de validação e webhook são os mais comuns em migrações. Documente cada etapa da configuração para reduzir retrabalho. Antes de escalar ao provedor, teste o status do número, o PIN e a URL do webhook isoladamente.
Como escalar o problema para o provedor ou para a Meta?
Depois de esgotar o checklist e os testes de sincronização sem sucesso, o próximo passo é abrir um chamado estruturado. O escalamento só faz sentido quando o bloqueio persiste com evidências documentadas e a equipe técnica já descartou falhas locais de configuração.
- Envolva a equipe técnica antes de abrir o chamado — Confirme com os responsáveis por infraestrutura e integração se número, PIN, nome da empresa e webhooks foram validados na sequência correta. Um template bloqueado pode ser sintoma de uma etapa anterior ainda pendente, e o suporte do provedor costuma pedir essa verificação logo na primeira resposta.
- Reúna os identificadores da conta e dos templates — Capture o ID do template, o status exibido no gerenciador, o ID da conta WhatsApp Business e o número de telefone associado. Sem esses dados, o suporte não consegue rastrear o problema e o chamado perde dias em idas e vindas.
- Registre logs e capturas de tela — Inclua o horário da tentativa, o código de erro retornado pela API oficial do WhatsApp e prints do painel do BSP. Evidências visuais aceleram a triagem e ajudam a diferenciar falha de sincronização de bloqueio de política.
- Abra o chamado no canal correto — Para questões de infraestrutura, sincronização ou bloqueios de templates no ambiente do provedor, use o suporte do seu BSP. Para políticas de mensagens, revisão de conteúdo ou aprovação na API oficial do WhatsApp, a Central de Ajuda da Meta é o canal adequado.
- Acompanhe o progresso com marcos claros — Pergunte ao suporte qual é o próximo passo esperado e em quanto tempo ele deve ocorrer. Se o chamado ficar parado por mais de um dia útil, retome o contato com o protocolo em mãos e solicite escalamento interno.
Fontes e referências
Segundo as referências institucionais abaixo, a validação técnica deve considerar a documentação primária de cada padrão e serviço.
- Visão geral da WhatsApp Cloud API — Meta for Developers
Perguntas frequentes
Quando templates não aparecem novo BSP, a causa pode ser o nome da empresa não aprovado?
Sim. O nome da empresa não aprovado impede a exibição de templates no gerenciador do WhatsApp. A sincronização depende de uma sequência hierárquica de pré-requisitos no WhatsApp Business Platform. Antes de abrir chamado, confirme se o nome da empresa está aprovado no painel do provedor, pois isso bloqueia o go-live.
Quais critérios usar para avaliar se o bloqueio de templates não aparecem novo BSP está no número ou no PIN?
Avalie pela ordem da cadeia: o número precisa estar verificado antes do PIN ser validado. Acesse o painel do provedor e confira o status do número. Se estiver diferente de 'verificado', o bloqueio está aí. Se o número estiver verificado, o próximo passo é checar se o PIN de seis dígitos foi confirmado.
Templates não aparecem novo BSP: qual a diferença entre falha de configuração no BSP e template rejeitado pela Meta?
Falha de configuração no BSP envolve etapas anteriores, como número não verificado, PIN pendente ou webhook não configurado. Template rejeitado é um problema no próprio template, com status PENDING ou REJECTED na API oficial. O diagnóstico exige testar cada camada isoladamente, sem pular etapas, para identificar onde está o bloqueio.
Templates não aparecem novo BSP: preciso investir em um número de teste dedicado para diagnosticar?
Sim, é recomendado. Configurar um número de teste dedicado permite isolar a validação em ambiente controlado, sem expor clientes ativos a erros. Esse número não deve estar vinculado a fluxos reais de atendimento. O investimento é baixo e evita retrabalho, pois ajuda a diagnosticar se a falha está na conta, no provedor ou no sistema.
Como implementar a sincronização de templates no novo BSP sem pular a verificação do número?
Siga a sequência hierárquica: primeiro verifique o número na API oficial, depois confirme o PIN de seis dígitos. Só então o template pode ser criado. Pular a verificação do número deixa o gerenciador vazio. Refazer o fluxo de verificação no painel do BSP costuma resolver o bloqueio de templates que não aparecem.
Como testar a sincronização de templates no novo BSP sem afetar o atendimento real?
Isole a validação em um ambiente controlado. Cadastre um número interno exclusivo para validação na API oficial, sem vínculo com fluxos de atendimento real. Isso permite diagnosticar se a falha está na configuração da conta, na sincronização com o provedor ou no processamento interno, sem expor clientes ativos a mensagens de erro.
