Message Sending Node

O node Message Sending envia mensagens de saída pelo WhatsApp ou Instagram a partir de um Workflow.

Use-o para notificar um usuário, responder de forma privada a um comentário do Instagram ou enviar uma mensagem direta no Instagram.

🛠️ Como Funciona

Quando o Workflow chega a este node, a Zaia envia uma mensagem pela conexão selecionada.

Você escolhe uma connection. O tipo de conexão determina os campos disponíveis e os modos de envio.

📲 Tipos de Conexão Suportados

WhatsApp (Official)

Conexões WhatsApp Official suportam:

Text
Template
Text with template fallback

WhatsApp (Waha)

Conexões Waha suportam apenas texto.

Templates e fallback de template não estão disponíveis no Waha.

Instagram

Conexões Instagram suportam apenas texto.

O destino é um ID do Instagram, não um número de telefone. Escolha um tipo de destino:

Comment — envia uma resposta privada usando um ID de comentário do Instagram.
User — envia uma mensagem direta usando um scoped user ID do Instagram.

⚙️ Modos de Envio

Text

A Zaia envia uma mensagem regular.

Use este modo quando o destinatário já estiver dentro de uma janela ativa de 24 horas do WhatsApp.

Template

A Zaia envia diretamente um template aprovado do WhatsApp.

Use este modo quando precisar iniciar uma conversa ou enviar uma mensagem pré-aprovada fora da janela de 24 horas.

Text with template fallback

A Zaia tenta enviar primeiro uma mensagem regular.

Se o WhatsApp rejeitar a mensagem porque a janela de 24 horas expirou, a Zaia envia o template configurado como alternativa.

⚠️ O fallback só é acionado para o erro específico de janela do WhatsApp expirada. Outros erros de entrega não acionam o fallback de template.

📍 Destino no Instagram

Ao selecionar uma conexão Instagram, a Zaia oculta o campo de número de telefone e define o modo de envio como Text.

Selecione o tipo de destino e forneça o ID correspondente:

Para Comment, forneça o ID do comentário.
Para User, forneça o scoped user ID do Instagram.

O ID de destino pode incluir variáveis do Workflow. A Zaia as resolve quando o Workflow é executado.

O Instagram não suporta templates ou fallback de template neste node.

🧩 Configuração de Template

Quando a conexão selecionada é WhatsApp (Official), a Zaia carrega apenas templates que estejam:

Aprovados na Meta
Disponíveis para aquela conexão
Válidos para a conta do WhatsApp vinculada

A Zaia monta os campos do template dinamicamente a partir do schema de template da Meta. Isso inclui:

Variáveis de Body
Variáveis de Header

Campos obrigatórios em Workflows

No node do Workflow, todos os campos obrigatórios do template devem ser preenchidos antes de salvar a configuração.

Isso garante que o node esteja pronto para ser executado sem dados faltando.

🖼️ Headers de imagem

Templates com header de imagem aceitam:

Uma URL pública
Um arquivo armazenado
Uma data URL

Antes de enviar, a Zaia converte a imagem para o formato aceito pela API do WhatsApp.

✅ Validações

A Zaia valida a conexão selecionada antes de enviar.

A conexão deve existir, pertencer ao workspace atual e estar ativa.

Para o Instagram, a Zaia também exige:

Uma conta e token do Instagram configurados.
Um tipo de destino.
Um ID de destino.
Modo de envio Text.

Se um valor obrigatório estiver ausente, a Zaia interrompe o Workflow antes do envio.

A Zaia também valida os dados do template do WhatsApp antes de enviar.

Isso inclui limites de tamanho e formato para campos como:

Texto do body
Texto do header
Valores de OTP
Sufixos de URL de botão

Se os dados excederem os limites da Meta, o node bloqueia o envio até que os valores sejam corrigidos.

🔒 Restrições

Templates só funcionam com conexões WhatsApp (Official) ativas e configuradas corretamente.
O template selecionado deve existir e estar aprovado na Meta.
Se o template não puder ser resolvido ou validado, a mensagem é bloqueada.
Conexões Waha não podem enviar templates.
Mensagens no Instagram exigem uma conexão Instagram ativa.
Mensagens no Instagram não usam números de telefone, templates ou fallback de template.

📌 Exemplos de Uso

Enviar um lembrete após um evento de pagamento.
Acionar um template de reativação aprovado após o fechamento da janela de 24 horas.
Enviar uma resposta privada no Instagram após receber um comentário.

✅ Ponto-Chave

Use o node Message Sending quando seu Workflow precisar entregar uma mensagem diretamente.

O WhatsApp usa números de telefone. O Instagram usa um ID de comentário ou scoped user ID. O Instagram envia apenas texto.