Nó Mensagem: enviando WhatsApp na automação
O nó Mensagem envia WhatsApp pro contato do evento (cliente do pedido, dono do carrinho, cliente do segmento). É o ponto onde o fluxo materializa a comunicação real com a pessoa.
Você pode usar dois canais:
- WhatsApp via QR Code — mensagem livre, qualquer texto, usa a instância conectada por QR.
- WhatsApp API Oficial (Meta) — mensagem via template aprovado, com variáveis nomeadas.
A escolha depende de qual canal você conectou na conta. Você pode ter os dois e escolher o canal por nó.
QR Code: mensagem livre
Configurando:
- Selecione Canal: WhatsApp (QR Code) no Inspector.
- Escolha a Instância — só aparecem instâncias com status
CONNECTED. - Escreva o corpo da mensagem no campo de texto. Suporta variáveis com sintaxe
{{caminho.do.dado}}.
Exemplo:
Olá {{customer.first_name}}!
Seu pedido #{{order.external_id}} de R$ {{order.total}} foi confirmado e estamos preparando.
Qualquer dúvida é só responder aqui.
A mensagem vai sair do número conectado por QR. Como é mensagem livre, qualquer conteúdo é permitido — mas o risco de banimento pelo WhatsApp aumenta com volume e mensagens não solicitadas.
Risco de bloqueio. Mensagens via QR Code não são reconhecidas pela Meta como uso oficial. O número pode ser banido sem aviso, especialmente com volume alto ou conteúdo percebido como spam. Pra escala, use a API Oficial.
API Oficial: template + mapeamento de variáveis
Configurando:
- Selecione Canal: WhatsApp Oficial (Meta) no Inspector.
- Escolha a Conexão Meta (lista as conexões WABA da sua conta).
- Escolha o Template — só aparecem templates aprovados pela Meta com
parameter_format = NAMED. - Para cada placeholder do template (ex:
{{nome_cliente}},{{numero_pedido}}), mapeie o valor:- Pode ser uma variável do fluxo (
{{order.first_name}}) - Pode ser um valor fixo (qualquer texto)
- Pode combinar (
Olá {{customer.first_name}}!)
- Pode ser uma variável do fluxo (
Auto-mapeamento por IA
Ao selecionar um template, um agente de IA analisa o nome, header e body do template + os placeholders, e sugere automaticamente o mapeamento mais provável (ex: detecta que {{nome_cliente}} deve ser {{customer.first_name}}).
Você revisa as sugestões antes de salvar. Pode aceitar tudo, mudar o que quiser, ou ignorar e mapear manualmente.
Sempre confira as sugestões de IA. Elas são bons palpites baseados no nome dos placeholders, mas podem errar quando o template tem variáveis ambíguas ({{numero}} pode ser pedido, telefone, ou outra coisa).
Por que só NAMED é suportado
Templates com placeholders posicionais ({{1}}, {{2}}, {{3}}) não funcionam no Rishi. O sistema marca esses templates como inválidos e bloqueia a seleção.
Quando criar templates novos pela Meta, sempre use parâmetros nomeados (chamados de "Named parameters" no Business Manager).
Comportamento quando o telefone falta
Se o cliente não tem telefone cadastrado no momento da execução, o nó Mensagem é pulado silenciosamente — não lança erro nem trava o fluxo.
O sistema:
- Registra um
MessageLogcom statusfailedeerror_reason: missing_recipient. - Continua a execução pro próximo nó.
Isso é intencional: assim o resto do fluxo (cupom, tag, webhook) ainda roda mesmo quando a mensagem não pode sair.
Quer evitar essa situação? Use o nó Condições com Tem tag específica ou outro filtro pra pular ramos onde o telefone provavelmente não existe.
Telefone com prefixo Brasil
O sistema prefixa automaticamente o telefone com 55 (Brasil) antes de enviar. Você não precisa cadastrar o DDI nos clientes — o sistema cuida disso.
Se você opera fora do Brasil, fale com o suporte pra ajustar.
Logs de envio
Cada execução do nó Mensagem gera um log com:
- Status (
success,failed) - Motivo da falha, se houver (
missing_recipient,unsubscribed,invalid_receiver,invalid_body,generic) - Timestamp de envio
- Conteúdo final enviado (com variáveis já resolvidas)
Acesse pelo painel de execuções do fluxo ou pela tela de detalhes da instância / conexão Meta.
Casos de borda
- Instância com status BLOCKED ou soft_block ativo → mensagem é descartada silenciosamente. Aparece como
failednos logs. - Template Meta de outra conexão → erro de segurança. Você não pode usar template de uma conexão que não é sua.
- Template Meta com variável em branco no momento do envio → o job lança exception e marca o step como
failed. Sempre teste antes de ativar. - Cliente cancelou recebimento (entrou na lista de unsubscribers) → mensagem não é enviada.
error_reason: unsubscribed.
Comparação: QR Code vs. API Oficial
| Característica | QR Code | API Oficial |
|---|---|---|
| Conteúdo | Texto livre | Templates aprovados |
| Custo por mensagem | Sem custo extra | Pode ter custo Meta (varia por categoria) |
| Risco de ban | Existe — não é uso oficial | Sem risco se seguir as regras Meta |
| Estabilidade | Conexão pode cair | Estável |
| Limite de volume | Risco aumenta com volume | Suporta qualquer volume |
| Mensagens pra contatos novos | Pode mandar | Só template MARKETING aprovado |
| Burocracia inicial | Escanear QR, pronto | Aprovação Meta, CNPJ verificado |
Use QR Code pra automações de baixo volume e início rápido. Use API Oficial pra escala, contatos frios, ou quando o risco de ban não for aceitável.
Próximos passos
- Nó Cupom — gere o código antes da mensagem e referencie com
{{coupon_code}}. - WhatsApp via QR Code — como conectar uma instância.
- WhatsApp API Oficial (Meta) — como conectar uma WABA e gerenciar templates.