Skip to main content

​
Por que este canal importa

Quando você manda a mesma comunicação em mais de um canal (ex.: “seu pedido saiu para entrega” no WhatsApp e no e-mail), copiar e colar texto em três lugares vira erro e retrabalho. Template é o contrato único: você define uma vez o conteúdo por canal, usa variáveis ({{name}}, {{1}}, …) e na hora do disparo só manda ID do template + valores — a Notifique monta cada canal e coloca na fila.

​
O que você encontra no painel

  • Biblioteca de templates — criar e editar o bloco WhatsApp (texto, botões, mídia), SMS (texto curto) e E-mail (assunto + HTML).
  • Detecção de variáveis — o painel lê o que você digitou e sugere as chaves; na API você espelha isso no objeto variables.
  • Valores padrão e regras de contato — para não quebrar envio quando falta dado (ver guia de variáveis).
  • Instância / domínio padrão — o workspace pode ter padrões para não repetir instanceId e from a cada chamada.

​
O que você encontra na API

  • CRUD de templates — listar, buscar, obter, criar, atualizar e excluir com escopos templates:read, templates:create, templates:update, templates:delete.
  • Envio — POST /v1/templates/send com nome ou ID do template, channels (ex.: ["whatsapp","email"]), to (até 100 destinatários — telefones E.164 e/ou e-mails) e variables.
  • Enriquecimento automático — se você manda só o telefone em to mas pede também e-mail, a API pode buscar o contato no workspace e completar o canal que faltava (e o inverso), quando os dados existirem na ficha.
  • Resposta 202 — mensagens enfileiradas; acompanhe status pelos fluxos de cada canal (API + webhooks).
Variáveis, chaves fixas do contato e CRUD detalhado: Variáveis disponíveis e CRUD.

​
Regras que evitam surpresa na integração

  • Cobrança — o custo é por canal e por destinatário (WhatsApp, e-mail, SMS, RCS têm pesos diferentes). A operação é atômica: se não houver crédito/saldo para toda a requisição, nada é enviado e a API retorna 403 (INSUFFICIENT_CREDITS).
  • Canais na chamada — o template pode ter 3 canais configurados, mas só entram os que você listar em channels.
  • Remetentes — sem instanceId / from, entram os padrões do workspace; se não houver padrão, 400.
  • SMS — texto final (depois das variáveis) precisa ter 9–160 caracteres; mensagem idêntica ao mesmo número em menos de 1 minuto pode retornar 409 (SMS_DUPLICATE_RECENT).
  • Escopos de envio — para cada canal em channels, a chave precisa de whatsapp:send, sms:send e/ou email:send.

​
Próximos passos