Heliont Messaging Sender icon

Heliont Messaging Sender

Create and send messages via the Heliont messaging hub

Heliont Messaging Sender

AI-generated

Summary

Depending on the selected mode, the node either creates messages and stores them in a queue, sends messages instantly, sends the queued messages, or only sends the queue. You choose the message type (text, image, video, audio, document, sticker, location, contacts, button list, reaction, or status) and provide the relevant fields (body text, media URL, caption, coordinates, etc.). The node processes each input item, builds a message from it, and outputs a result summary plus the original input items.

Inputs

  • mode (required) — Defines the task of this node: add to queue, add & send queue, add & send instantly, or just send queue. Default: 'createMessage'.
  • delaySeconds — How long to wait between sending each message (only applicable for modes that send from a queue). Shown for 'createAndSendQueue' and 'sendQueue'. Default: 0.
  • task (required) — Type of message to send. Shown for modes that create messages (createMessage, sendInstant, createAndSendQueue). Options include text, image, video, audio, document, sticker, location, contacts, button, list, reaction, status_read, status_typing_off, status_typing_on, resultList, resultMap. Default: 'text'.
  • isReply — Whether the message should be marked as a reply. Only the first message in a batch is treated as a reply. Shown for text, image, audio, video, location, contacts, document, sticker, resultList, resultMap, button, list tasks. Default: false.
  • bodyText — Body text for text messages. Shown when task is 'text'. Default: empty.
  • previewUrl — Show a link preview if the message body contains a URL. Shown when task is 'text'. Default: true.
  • bodyInteractive — Body text for button or list messages (max 1024 characters). Shown when task is 'button' or 'list'. Default: empty.
  • mediaUrl — URL of the media to send (image, video, audio, document, sticker). Shown for those media tasks. Default: empty.
  • caption — Caption for image, video, or document messages. Shown for those tasks. Default: empty.
  • filename — Filename for document messages. Shown when task is 'document'. Default: empty.
  • contacts — Contact information to send (full name, organization, phone numbers). Shown when task is 'contacts'. Default: empty object.
  • latitude — Latitude of the location (-90 to 90). Shown when task is 'location'. Default: 0.
  • longitude — Longitude of the location (-180 to 180). Shown when task is 'location'. Default: 0.
  • locationName — Display name for the location. Shown when task is 'location'. Default: empty.
  • buttons — Buttons for button messages (each with an ID and title). Shown when task is 'button'. Default: empty.
  • header — Optional header text for list messages (shown above the list). Shown when task is 'list'. Default: empty.
  • footer — Optional footer text for list messages (shown underneath the list). Shown when task is 'list'. Default: empty.
  • listButtonLabel — Text displayed on the button that opens the list (max 20 characters). Shown when task is 'list'. Default: 'View list'.
  • sections — Sections for list messages (each with a title and rows). Shown when task is 'list'. Default: empty.
  • reactionEmoji — Emoji reaction to send. Shown when task is 'reaction'. Default: '👍'. Options include many emojis such as 👍, ❤️, 😂, 🔥, 😢, 👏, 🎉, 😊, 🙏, 😍, 😎, 😮, 💯, 😡, 🤔, 💔, 😅, 🤯, 🥺, 👀, 😴, 😋, 🤗, 🤩, 😏, 🙄, 😇, 😜, 😤, 😱, 🤤, 🥳, 🤮, 🤒, 🤕, 🤑, 😈, 👑, 🌹, ⭐.

Output shape

The node returns two output arrays:

First array contains a single object summarizing the run; second array contains the original input items unchanged, enabling the workflow to pass data forward.

Examples

Example 1: Send a simple text message instantly.

Set mode to 'sendInstant', task to 'text', provide bodyText, optionally set isReply and previewUrl.

Example 2: Queue multiple media messages and send them later with a delay.

Use mode 'createAndSendQueue' (or separate 'createMessage' then later 'sendQueue'), choose appropriate task (e.g., image), fill mediaUrl and caption, set delaySeconds to control spacing between sends.

Example 3: Send a location with a custom label.

Set task to 'location', provide latitude, longitude, and locationName.

Discussion