Nó Send (WhatsApp)

O nó Send (whatsapp_send) entrega mensagens WhatsApp pelas instâncias conectadas. Escolha um operation template para o tipo de mensagem — texto, template Meta, imagem, vídeo, documento, áudio, localização, cartão de contato, sticker, enquete, lista, botões ou reação.

Encontre-o na paleta WhatsWave em Automações.

Figura 1: Nó Send — operation template e campos de destino

O que faz

Cada operação mapeia para um path de API dedicado (por exemplo /instances/message/send-text, /instances/message/send-template). Mensagens de lista e botões usam formato interativo Meta e exigem janela de atendimento ao cliente de 24 horas aberta (ou template aprovado para iniciação outbound).

Campos compartilhados (maioria das operações)

Estes campos aparecem em quase toda operação de envio:

Use variáveis: {{trigger.body.phone}}, {{contact_1.contact.phone_number}}.

Operation templates

Text / message (wa_op_text)

Endpoint: POST /instances/message/send-text

Template — Meta API (wa_op_template)

Endpoint: POST /instances/message/send-template

Use para mensagens fora da janela de 24h. Liste nomes aprovados com o nó Meta Templates.

Image / Video / Document (wa_op_image, wa_op_video, wa_op_document)

Endpoint: POST /instances/message/send-media

Audio (wa_op_audio)

Endpoint: POST /instances/message/send-audio

Location (wa_op_location)

Endpoint: POST /instances/message/send-location

Contact card (wa_op_contact)

Endpoint: POST /instances/message/send-contact

Sticker (wa_op_sticker)

Endpoint: POST /instances/message/send-sticker

Poll (wa_op_poll)

Endpoint: POST /instances/message/send-poll

List (wa_op_list)

Endpoint: POST /instances/message/send-list

Buttons (wa_op_buttons)

Endpoint: POST /instances/message/send-buttons

Reaction (wa_op_reaction)

Endpoint: POST /instances/message/send-reaction

Dicas e boas práticas

• Escolha a operação primeiro. Os campos são filtrados por template — você só vê entradas relevantes (campos de imagem em Image, não em Text).
• Use templates Meta para outbound frio. Texto livre, listas e botões falham fora da sessão de 24h, a menos que o cliente tenha enviado mensagem recentemente.
• Sempre passe números E.164. Inclua código do país sem + ou espaços: 5511999999999.
• Defina instance_id com múltiplas linhas. Evita enviar pelo número WhatsApp errado.
• Faça upload de mídia no editor quando possível — mediaStoragePath é resolvido automaticamente; URLs públicas devem ser HTTPS e acessíveis pela Meta.
• Inspecione {{send_1.status}} no histórico de execução antes de encadear nós CRM ou Return em caso de falha.

Exemplos de uso

Exemplo 1 — Confirmação de pedido (webhook + template)

Trigger: Webhook — pedido e-commerce pago.

Fluxo:

1. Send — operação Template (Meta API)
   • number: {{trigger.body.phone}}
   • template_name: order_shipped
   • components: [{ "type": "body", "parameters": [{ "type": "text", "text": "{{trigger.body.order_id}}" }] }]
2. CRM — upsert do card na coluna "Shipped"
3. Return — { "sent": true, "status": "{{send_1.status}}" }

Exemplo 2 — Handoff de agente com mídia

Trigger: Webhook — ticket de suporte com URL de anexo.

Fluxo:

1. Send — Text: "We received your request #{{trigger.body.ticket_id}}"
2. Send — Document: mediaUrl = {{trigger.body.pdf_url}}, caption = "Your invoice"
3. Conversations — Transfer para responsável de {{trigger.body.agent_name}}

Exemplo 3 — Menu interativo dentro da janela de 24h

Trigger: Webhook — mensagem recebida já armazenada.

Fluxo:

1. Send — List
   • title: "How can we help?"
   • sections: JSON com linhas "Sales", "Support", "Billing"
2. Condition — ramifica com base na resposta capturada em workflow de webhook de follow-up

FAQ

Por que minha mensagem de lista/botões falhou?

Provavelmente fora da janela de atendimento de 24h. Mude para template Meta ou aguarde o cliente enviar mensagem primeiro.

Preciso configurar headers Authorization?

Não. O template injeta Bearer {{api_token}} automaticamente.

Posso enviar para PSID Instagram neste nó?

O campo number aceita PSID quando a instância selecionada suporta Instagram. Para fluxos só Instagram, prefira o nó Instagram.

Qual a diferença entre Send e Message queue?

Send entrega imediatamente. Message queue agenda entrega via scheduled_at e vincula o item ao workflow atual — veja nó Message queue.

Como referencio o message ID para uma reação?

Use a saída do nó Messages ou campo do payload do webhook e passe para messageId na operação Reaction.

Artigos relacionados

• Visão geral WhatsWave
• Nó Message queue
• Nó Meta Templates
• Variáveis em workflows