PRO Send BaleMessage - Captain icon

PRO Send BaleMessage - Captain

Node to Send BaleMessage

PRO Send BaleMessage - Captain

AI-generated

Overview

This node sends BaleMessage messages to users as part of a campaign. It supports selecting a campaign and BaleMessage provider, composing a message with dynamic content, optionally attaching a file URL, and managing message sending behavior such as waiting until all messages are sent, tagging users, and controlling message frequency per mobile number. It is useful for automated messaging workflows where personalized messages need to be sent to multiple users with campaign tracking and tagging.

Use Case Examples

  1. Sending personalized BaleMessage texts to users in a marketing campaign.
  2. Attaching media files to messages sent to users.
  3. Using tags to manage user states and control message frequency per mobile number.

Properties

Name Meaning
Select a Campaign Select a campaign from the list to associate the messages with.
BaleMessage Provider Select the BaleMessage provider from the list to send messages through.
BaleMessage Name Name of the BaleMessage campaign to identify the message batch.
BaleMessage Message The text content of the BaleMessage to send, supports dynamic expressions.
File URL (Optional) URL of an optional file (image, video, etc.) to attach to the message.
Wait Until All Messages Sent. Boolean flag to wait until all messages are sent before continuing workflow execution.
Tag Settings Settings to check for a tag on users, add it if missing, and specify when to remove it (days, hours, minutes).
Once Per Mobile Number Boolean flag to send the message only once per mobile number.
When Can Users Receive Again (In days, 0 for never)? Number of days after which users can receive the message again if 'Once Per Mobile Number' is enabled.
Ignore FC Boolean flag to ignore FC (possibly a filter or condition) when sending messages.
Ignore DND Boolean flag to ignore Do Not Disturb settings when sending messages.
Users String of users to send messages to; if blank, uses users from the previous node.

Output

JSON

  • usersAndText
    • ``
      * userId - User identifier to whom the message is sent.
      * text - The personalized text message content sent to the user.
      * fileUrl - Optional file URL attached to the message.
      * outputResult - Result output related to the user message sending.
  • baleMessageName - Name of the BaleMessage campaign used.
  • campaign_id - Identifier of the selected campaign.
  • providerTitle - Selected BaleMessage provider title.
  • tagName - Tag name used for tagging users.
  • once - Flag indicating if message is sent once per mobile number.
  • onceDaysToRemove - Days after which users can receive the message again.
  • uuid - Unique identifier for the message batch.
  • ignoreFC - Flag to ignore FC condition.
  • ignoreDND - Flag to ignore Do Not Disturb settings.
  • executionId - Execution ID of the workflow run.
  • workflowName - Name of the workflow executing the node.
  • tagToRemoveDays - Days after which the tag is removed.
  • tagToRemoveHours - Hours after which the tag is removed.
  • tagToRemoveMinutes - Minutes after which the tag is removed.

Dependencies

  • Requires environment variables CDP_URL and UNEXO_API_KEY for API access to campaign and messaging services.

Troubleshooting

  • Common issues include API request failures due to network or authentication errors. The node retries requests up to 3 times with delays.
  • If the message text contains dynamic expressions, ensure the expressions are valid and the referenced data exists in the input.
  • Waiting for all messages to be sent may cause delays; ensure the external service is responsive.
  • Error messages related to authorization indicate missing or invalid API keys; verify environment variables are set correctly.

Links

Discussion