Skip to main content
Template é a carta pronta da sua operação: você monta uma vez, usa {{name}}, {{pedido}} e dispara em SMS, WhatsApp, e-mail e outros canais na mesma chamada.

​
O que é Template na Notifique?

É o modelo multicanal do workspace: um único registro com blocos por canal (sms, whatsapp, email, etc.). Na hora do envio, a Notifique mescla variáveis, valida escopos e créditos, e enfileira cada canal pedido. Você pode:
  • Criar e editar templates no painel ou API (templates:*)
  • Disparar para até 100 destinatários por chamada (POST /v1/templates/send)
  • Personalizar com {{chave}}, dados do contato e variableDefaults
  • Traduzir por idioma (localeTranslations) quando o contato tem preferência
  • Combinar canais livres (SMS, e-mail…) com WhatsApp oficial sincronizado com a Meta
Pense numa pasta com versões da mesma mensagem, uma para cada canal, que você envia todas de uma vez.
Instagram e Widget (chat no site) existem na plataforma, mas não entram em templates. Use a API de cada canal para esses casos.

​
Canais suportados

  • WhatsApp, telefone E.164 (whatsapp)
  • SMS, telefone E.164 (sms)
  • Telegram, chat_id ou @username (telegram)
  • E-mail, endereço de e-mail (email)
  • RCS, telefone E.164 (rcs)
  • Push, ID do dispositivo (push)
  • Voz, telefone E.164 com + (voice)
Cada template liga 1 a 7 canais. No envio, channels deve ser subconjunto dos canais habilitados no template.

​
Quando usar?

Funciona muito bem para confirmação multicanal, campanhas recorrentes e mensagens personalizadas com variáveis. Para um único envio pontual em um canal, pode mandar direto na API do canal (SMS, e-mail, etc.) sem criar template.

​
Como funciona na prática

  1. Crie o template, ligue só os canais necessários
  2. Escreva cada bloco com {{chave}} e valores padrão se quiser
  3. Dispare com template, channels, to e variables
  4. A API responde 202 com IDs por canal (messageIds, smsIds, emailIds, …)
  5. Entrega de cada canal → webhooks do canal (message.*, sms.*, …)
  6. Aprovação Meta do WhatsApp oficial → webhooks template.* (veja abaixo)
Cada envio gasta créditos por destinatário e por canal. Se não houver saldo para toda a requisição, nada é enviado (INSUFFICIENT_CREDITS).

​
WhatsApp oficial e a Meta

Esta é a parte que liga templates internos do Notifique ao catálogo oficial da Meta (Cloud API).

​
Dois tipos de template WhatsApp

Na linha oficial, fora da janela de 24h após resposta do cliente, só entra mensagem com template aprovado pela Meta. Na linha não oficial, isso não se aplica.

​
Sincronização com os servidores da Meta

Você não precisa duplicar tudo por canal. O fluxo usual:
  1. Criar interno no Notifique (SMS + e-mail + bloco WhatsApp)
  2. Trazer da Meta, sincronizar catálogo já aprovado na WABA
  3. Vincular o bloco WhatsApp do interno a um modelo existente na Meta, ou
  4. Publicar o interno na Meta e aguardar aprovação
O nome interno (alerta_pedido) pode ser diferente do metaName na Meta (order_update). No envio oficial, a Meta usa o modelo aprovado no catálogo dela. Vários números oficiais na mesma conta Business compartilham o mesmo catálogo de templates. Guia completo (sync, vínculo, publicação, status, erros): Templates oficiais Meta.

​
Status de aprovação

Acompanhe no painel ou via webhook: Eventos: template.submitted, template.status_changed, template.category_changed. Detalhes: Eventos dos webhooks.
Editar só no Notifique sem espelhar na Meta não muda o que o cliente vê no WhatsApp oficial. O texto entregue vem da definição aprovada na Meta.

​
O que você encontra no painel

  • Biblioteca de templates com detecção de variáveis
  • Valores padrão e traduções por idioma
  • Badge Meta e status colorido em templates oficiais
  • Sincronizar templates com a Meta na instância oficial
  • Padrões de workspace: instância WhatsApp, domínio de e-mail, app Push, número de voz

​
O que você encontra na API

  • Gestão: templates:read, templates:create, templates:update, templates:delete
  • Envio: escopo de cada canal em channels (whatsapp:send, sms:send, …)
  • Detalhes na referência da API na aba Templates

​
Próximos passos