O módulo API Templates (Engajamento > API Templates) serve para criar e gerenciar templates de mensagens transacionais disparadas via API — aquelas que o seu sistema envia automaticamente em resposta a ações do usuário: confirmação de pedido, código de verificação, atualização de entrega, aviso de pagamento.
O conceito
Em vez de o time de desenvolvimento fixar o texto das mensagens no código da aplicação, o conteúdo vive na Inngage como um template identificado (por exemplo, welcome_v1). O sistema chama a API informando apenas o ID do template, o usuário e as variáveis:
POST /v1/send-message
{
"template_id": "welcome_v1",
"user_id": "12345",
"variables": { "name": "John" }
}
Por que isso importa para o time de marketing
- Separação entre conteúdo e código: o texto da mensagem pode ser ajustado na plataforma sem depender de deploy do time de engenharia. Marketing ganha autonomia sobre a voz da marca até nas mensagens transacionais.
- Consistência visual: todos os disparos usam o mesmo template aprovado.
- Variáveis dinâmicas: os templates suportam variáveis no padrão Handlebars/Liquid (como
{{name}}), permitindo personalização completa. - Alta performance e entrega instantânea: o canal é desenhado para mensagens que não podem esperar.
Como usar
- Acesse Engajamento > API Templates e clique em Criar Template.
- Defina o conteúdo e as variáveis do template.
- Compartilhe o ID do template com o time de desenvolvimento, que fará a chamada via API.
- Para detalhes técnicos de integração, use o botão Documentação da API.
Transacional vs. campanha
Uma distinção importante de governança: mensagens transacionais informam sobre uma ação que o usuário realizou (nota fiscal, envio do pedido) e geralmente não exigem opt-in de marketing; campanhas promocionais, sim. Mantenha essa separação — misturar oferta em mensagem transacional pode comprometer a entregabilidade do canal e a confiança do cliente.

