Os nodes de SEND da Poli são responsáveis por enviar mensagens diretamente para contatos da sua base.
Existem duas modalidades de envio:

1. Mensagens de texto simples → ideais para quando a conversa já está ativa.
2. Mensagens via Template → obrigatórias para iniciar conversas em canais WABA (WhatsApp Business API).

A diferença entre os nodes está em como o destinatário é identificado:

• Pelo número de telefone (phone number).
• Pelo UUID do contato (contact_uuid).

Pré-requisitos

Antes de utilizar os nodes de envio, você precisará de:

• Token de acesso → obtido neste tutorial.
• Account UUID → obtido via List Accounts.
• Account Channel UUID → obtido via List Channels.
• Contact UUID (caso use o envio por contato) → obtido via List and Search Contacts.
• Template UUID (caso envie mensagem por template) → obtido via List Templates.

⚠ Atenção importante sobre o canal WABA (WhatsApp Business API):

• Para enviar a primeira mensagem de uma conversa, é obrigatório o uso de Templates.
• Mensagens de texto só funcionam se já houver uma conversa ativa dentro da janela de 24h.

Templates Oficiais vs Não Oficiais

Existem dois tipos de Templates:

1. Template oficial do WhatsApp (WABA):
2. • Só pode ser enviado se você estiver conectado em um canal oficial (WABA).
   • Usado para iniciar conversas de forma validada e dentro das políticas do WhatsApp.
3. Template não oficial:
4. • Só pode ser enviado por canais não oficiais.
   • Usado em cenários internos/testes ou quando não há conexão com o WABA.

⚠ Se você tentar enviar um template oficial em canal não-oficial, ou um template não-oficial em canal oficial, a mensagem não será entregue.

Nodes de SEND disponíveis no n8n

Atualmente, existem quatro tipos principais de envio: dois para texto e dois para templates.

1. Send Message By Phone

• Função: Envia uma mensagem de texto simples para um número de telefone.
• Parâmetros necessários:
• • Account UUID
  • Phone number (com DDD)
  • Account Channel UUID
• Conteúdo da mensagem: Definido no campo Text.
• Observação importante: Não funciona como primeira mensagem em canais WABA — use Template nesse caso.

2. Send Message By Contact UUID

• Função: Envia uma mensagem de texto simples para um contato já existente, usando o seu UUID.
• Parâmetros necessários:
• • Account UUID
  • Contact UUID
  • Account Channel UUID
• Conteúdo da mensagem: Definido no campo Text.
• Observação importante: Mesma regra do WABA → se for a primeira mensagem, deve ser enviada via Template.

3. Send Template Message By Phone Number

• Função: Envia uma mensagem via Template para um número de telefone.
• Parâmetros necessários:
• • Account UUID
  • Phone number (com DDD)
  • Account Channel UUID
  • Template UUID
• Campos opcionais:
• • Header parameters (texto, data/hora, etc.)
  • Body parameters (texto dinâmico dentro do corpo da mensagem)
• Quando usar: Sempre que precisar iniciar uma conversa em canal WABA.
• Validação do Template:
• • Se o Template for oficial, deve ser enviado em canal oficial WABA.
  • Se o Template for não oficial, deve ser enviado em canal não oficial.

4. Send Template Message By Contact UUID

• Função: Envia uma mensagem via Template para um contato já existente, usando o seu UUID.
• Parâmetros necessários:
• • Account UUID
  • Contact UUID
  • Account Channel UUID
  • Template UUID
• Campos opcionais:
• • Header parameters (personalização no cabeçalho da mensagem)
  • Body parameters (texto dinâmico no corpo)
• Quando usar: Ideal para contatos já cadastrados no sistema, mas que precisam receber a primeira mensagem em canal WABA.
• Validação do Template:
• • Template oficial → canal oficial WABA.
  • Template não oficial → canal não oficial.