Skip to main content
templates:* gerencia modelos; whatsapp:send, sms:send, etc. disparam. Ter templates:create não basta para enviar.
Cada escopo libera um tipo de operação em Templates. Use só o que sua integração precisa.

​
Como enviar a chave

Recomendado
Alternativo
A API Key pertence a um workspace. Você não acessa outro workspace com a mesma chave.

​
Duas famílias de escopo

Ter templates:create não basta para enviar. No disparo, cada canal pedido precisa do escopo de envio daquele canal.

​
Combinações comuns

Só disparar

whatsapp:send, sms:send, email:send, rcs:send, etc. (conforme canais usados)

Só gerenciar modelos

templates:read, templates:create, templates:update, templates:delete

App completo

Todos os templates:* + escopos de envio dos canais do template

Só consultar

templates:read
Lista de escopos vazia na criação = acesso ADMIN. Em produção, restrinja sempre.

​
Escopos de gestão (templates:*)

Listar templates e buscar detalhe por ID.
Criar template novo no workspace.
Editar template existente (canais, textos, padrões de variáveis, traduções).
Excluir template.

​
Escopos de envio (por canal)

Na operação Enviar por template, valide o escopo de cada canal em channels: Status de entrega (enviado, entregue, falhou) vem dos webhooks do canal, não de um webhook de envio de template. Status de aprovação Meta (aprovado, rejeitado, pausado, categoria) vem dos eventos template.*, veja Eventos dos webhooks.

​
Erros comuns

Detalhe na referência da API na aba Templates.

​
Próximos passos