Criar template
POST/templates
Cria um template na Meta. Ele nasce com status PENDING e a aprovação leva de
alguns minutos a algumas horas — o resultado chega pelo webhook
message_template_status_update.
Antes de mandar para a Meta, validamos os componentes localmente e devolvemos
422 invalid_request com o campo issues apontando o problema. Isso evita o
ciclo lento de submeter, esperar e ser rejeitado.
O que é validado
- Variáveis sem exemplo declarado
- Exemplos com valor vazio
- Lacunas na numeração posicional (
{{1}},{{3}}sem{{2}}) - Mistura de formato posicional e nomeado no mesmo template
- Mais de uma variável no header de texto
- Qualquer variável no footer
- Botão de URL com variável e sem exemplo de URL
- Identificador inválido em variável nomeada
parameterFormatdeclarado que contradiz o texto
A partir da biblioteca da Meta
Em vez de components, você pode mandar libraryTemplateName com o nome de um
item de GET /templates/library. Aí o texto é o da Meta e não passa por
validação nenhuma daqui — o que você informa é só o que o modelo pede (URL do
botão, telefone). Os dois caminhos são excludentes: mandar os dois é 422.
Request
Responses
- 201
- 401
- 403
- 409
- 422
- 429
Template criado, aguardando aprovação.
Token ausente, malformado, desconhecido ou revogado (authentication), ou
conta suspensa (tenant_inactive).
O recurso informado não pertence à sua conta (forbidden), ou o caminho está
na lista de bloqueio do espelho (forbidden_endpoint), ou a sua API key é restrita a
alguns números e a operação é da conta inteira (forbidden).
Nenhuma conta empresarial conectada e wabaId omitido (no_waba).
Payload reprovado na validação (invalid_request, com o detalhamento em
issues) ou recusado pela Meta (meta_error, com o corpo original em
meta).
Limite de requisições excedido (rate_limit).
Response Headers
Segundos a aguardar antes de tentar de novo.
Categoria do limite aplicada — send, media ou default.
Qual balde os outros headers descrevem — key (a API key), session (o painel) ou account (o teto da conta).
Teto de requisições da categoria na janela atual.
Requisições restantes na janela atual.