For the complete documentation index, see llms.txt. This page is also available as Markdown.

Message Sending Node

Send outbound WhatsApp messages from a Workflow using text, templates, or template fallback.

The Message Sending node sends outbound messages from a Workflow.

Use it when your automation needs to notify a user, trigger a template message, or recover from the WhatsApp 24-hour window with an approved template.


🛠️ How It Works

When the Workflow reaches this node, Zaia sends a message through the selected connection.

You choose the send mode and the connection. The available behavior depends on the connection type.


📲 Supported Connection Types

WhatsApp (Official)

Official WhatsApp connections support three send modes:

  • Text

  • Template

WhatsApp (Waha)

Waha connections support text only.

Templates and template fallback are not available on Waha.


⚙️ Send Modes

Text

Zaia sends a regular message.

Use this mode when the recipient is already inside an active 24-hour WhatsApp window.

Template

Zaia sends an approved WhatsApp template directly.

Use this mode when you need to start a conversation or send a pre-approved message outside the 24-hour window.

Text with template fallback

Zaia tries to send a regular message first.

If WhatsApp rejects the message because the 24-hour window expired, Zaia sends the configured template instead.

⚠️ The fallback only runs for the specific WhatsApp window-expired error. Other delivery errors do not trigger template fallback.


🧩 Template Configuration

When the selected connection is WhatsApp (Official), Zaia loads only templates that are:

  • Approved in Meta

  • Available for that connection

  • Valid for the linked WhatsApp account

Zaia builds the template fields dynamically from Meta's template schema. This includes:

  • Body variables

  • Header variables

Required fields in Workflows

In the Workflow node, all required template fields must be filled before you save the configuration.

This ensures the node is ready to execute without missing data.


🖼️ Image headers

Templates with an image header accept:

  • A public URL

  • A stored file

  • A data URL

Before sending, Zaia converts the image into the format accepted by the WhatsApp API.


✅ Validations

Zaia validates template data before sending.

This includes size and format limits for fields such as:

  • Body text

  • Header text

  • OTP values

  • Button URL suffixes

If the data exceeds Meta's limits, the node blocks the send until the values are fixed.


🔒 Restrictions

  • Templates only work with active and correctly configured WhatsApp (Official) connections.

  • The selected template must exist and be approved in Meta.

  • If the template cannot be resolved or validated, the message is blocked.

  • Waha connections cannot send templates.


📌 Example Use Cases

  • Send a reminder after a payment event.

  • Trigger an approved reactivation template after the 24-hour window closes.

  • Notify a customer from a Workflow without relying on an Agent tool.


✅ Key Takeaway

Use the Message Sending node when your Workflow must deliver WhatsApp messages directly.

For Official WhatsApp, you can choose between text, templates, or controlled fallback. For Waha, use regular text only.

Last updated