Base · template n8n
Núcleo TN para WhatsApp
Um lugar só para configurar o WhatsApp: todos os templates TN enviam e recebem por aqui, com modo teste, horário comercial e lista de "não quero mais receber" já prontos.
O que faz
São 3 workflows:
| Workflow | Função |
|---|---|
| [TN] Núcleo · Instalação | Cria as 4 tabelas internas (Data Tables) usadas pelos templates. Roda uma vez. |
| [TN] Núcleo · Enviar WhatsApp | Sub-workflow que envia toda mensagem, pela Evolution API ou pela WhatsApp Cloud API (Meta). |
| [TN] Núcleo · Roteador de entrada | Recebe todas as mensagens que chegam e entrega ao template que está esperando aquela resposta. |
Proteções que já vêm ligadas:
- Modo teste ligado de fábrica: nada é enviado até você desligar. Com
numero_testepreenchido, todas as mensagens vão para o seu celular, marcadas com o destino original. - Janela de envio: lembrete, cobrança e pesquisa só saem nos dias e horários configurados. Respostas a quem escreveu saem a qualquer hora.
- PARE / VOLTAR: quem manda PARE sai da lista de mensagens automáticas na hora (boa prática e LGPD); VOLTAR reativa.
- Número com e sem o 9: o WhatsApp às vezes devolve o número sem o nono dígito, ou sob um identificador interno (LID). O casamento de números já trata isso.
O que você precisa
- n8n 2.x com Data Tables (testado no n8n 2.36.7), self-hosted ou n8n Cloud.
- Um destes:
- Evolution API v2 com uma instância conectada, ou
- WhatsApp Cloud API: app na Meta, número verificado,
Phone number IDe token permanente.
Cuidados (LGPD)
tn_optoutguarda quem pediu para não receber. Não apague essa tabela.- Mensagem automática não deve carregar diagnóstico, exame ou valor de dívida detalhado.
- Informe na sua política de privacidade que você usa WhatsApp para lembretes e atendimento.
Limites conhecidos
- Evolution API usa uma conexão não oficial do WhatsApp. O número pode ser bloqueado pelo WhatsApp, sobretudo com envio em massa para quem não conhece a empresa. Para operação crítica, prefira a Cloud API oficial.
- Na Cloud API, mensagem que a empresa inicia fora da janela de 24 h só vai com modelo aprovado pela Meta (cada template traz os textos sugeridos). A Meta cobra por mensagem de modelo.
- Contas que o WhatsApp migrou para LID e não informam o número real chegam sem telefone. O Roteador entrega assim mesmo ao fluxo padrão, mas pendências por número não casam.
- Se a Cloud API mandar várias mensagens na mesma chamada, o Roteador trata a mais recente.