Erro ao criar template de autenticação no WhatsApp (code 10, subcode 2388185)

​

Qual é o erro exato?

Não é possível criar o modelo de mensagem Esta conta do WhatsApp Business não tem permissão para criar um modelo de mensagem.

{
  "error": {
    "message": "Application does not have permission for this action",
    "type": "OAuthException",
    "code": 10,
    "error_subcode": 2388185,
    "is_transient": false,
    "fbtrace_id": "AbCdEf123..."
  }
}

​

Por que isso acontece?

1. Verificação de negócio por um dos caminhos oficiais de escala (as “scaling paths” da Meta): verificação de negócio direta (Business Verification), verificação via parceiro Meta (partner-led) ou o programa Quality Messaging.
2. Volume/tier mínimo de mensageria. Contas em tier inicial não conseguem enviar mensagens de autenticação. A Meta cita, como referência, algo em torno de 2.000 mensagens entregues a usuários únicos em 30 dias (fora da janela de 24h, com templates de boa qualidade).

• Não é o conteúdo do template. O mesmo texto, corpo e botão em outra categoria passa; só AUTHENTICATION é recusada.
• Não é um bug ou estado da sua conta específica. O erro reproduz em contas WABA diferentes, sempre só na categoria AUTHENTICATION.
• Não é restrição do Brasil. O gate vale para qualquer país; o authentication_international que aparece em alguns lugares é uma faixa de tarifação, não um bloqueio.

​

Como diagnosticar?

curl -X POST "https://graph.facebook.com/v25.0/{WABA_ID}/message_templates" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "otp_test",
    "language": "pt_BR",
    "category": "AUTHENTICATION",
    "message_send_ttl_seconds": 60,
    "components": [
      { "type": "BODY", "add_security_recommendation": true },
      { "type": "FOOTER", "code_expiration_minutes": 5 },
      { "type": "BUTTONS", "buttons": [{ "type": "OTP", "otp_type": "COPY_CODE" }] }
    ]
  }'

​

Como checar a elegibilidade sem criar nada?

• Tier de mensagens (o sinal mais limpo). É a mesma escada que a UI da Meta mostra: 250 → 2.000 → 10.000 → 100.000 → ilimitado. Tier 250 (inicial) costuma significar autenticação bloqueada; a partir de 2.000 a conta muito provavelmente já é elegível. Não existe um tier de “1.000” (esse número, comum em blogs de parceiros, está desatualizado).
• health_status. GET /{PHONE_NUMBER_ID}?fields=health_status retorna can_send_message por entidade (PHONE_NUMBER, WABA, BUSINESS, APP) como AVAILABLE, LIMITED ou BLOCKED. Um BUSINESS em LIMITED ou BLOCKED costuma indicar verificação de negócio pendente.
• Templates de autenticação já existentes. GET /{WABA_ID}/message_templates?category=AUTHENTICATION&fields=name,status. Se já existe algum, a conta consegue criar. A lista vazia não prova o contrário, então só vale como sinal quando há resultado.

​

Como resolver?

1. Conclua a verificação de negócio por um dos três caminhos de escala: Business Verification direta, verificação via parceiro Meta ou o programa Quality Messaging. Sem verificação de negócio, a autenticação continua bloqueada.
2. Suba o tier de mensagens. O gate real é o volume. Enquanto a conta estiver no tier inicial (250), a categoria tende a permanecer bloqueada. A referência da Meta gira em torno de 2.000 mensagens entregues a usuários únicos em 30 dias, com boa qualidade e fora da janela de 24h.
3. Aguarde a liberação automática. Quando a conta se torna elegível, a categoria costuma liberar em cerca de 6 horas, sem nenhuma ação manual.

​

O que NÃO resolve o erro?

• Editar o conteúdo do template. Como o bloqueio é de categoria, e não de conteúdo, mudar o texto, o corpo ou o botão não muda o resultado. O erro 2388185 continua.
• Entregar o OTP como template UTILITY com botão de copiar código. É proibido e tende a ser rejeitado. O botão OTP (copy-code / one-tap) é exclusivo de AUTHENTICATION. O botão COPY_CODE que existe em UTILITY e MARKETING é o de cupom (copiar código de desconto), não de OTP, e a Meta recusa a combinação com code: 100 / error_subcode: 2388180. A própria documentação de categorização é explícita: “Only authentication templates can be used to send a one-time passcode for identity verification. Marketing and utility templates cannot be used for this purpose.”

​

Como a Zapster ajuda?

​

Perguntas frequentes

​

Fontes oficiais da Meta

• Limites de mensagens (messaging limits), a escada de tiers que funciona como gate real.
• Categorização de templates (template categorization), com a regra de que só templates de autenticação enviam OTP.
• Thread da comunidade Meta sobre o erro 2388185, com vários relatos do mesmo code: 10 / error_subcode: 2388185.

​

Próximos passos

• Conectando uma instância WABA
• Enviando mensagens WABA
• Número 555 da Meta e o erro 131037