Actions67
- Account Actions
- Action Actions
- Analytics Actions
- Block Number Actions
- Campaign Actions
- Campaign Group (Release Group) Actions
- Direct Message Actions
- Group Actions
- Media Actions
- Message Template Actions
- Template Folder Actions
- Variable Actions
- Verification Actions
- Workflow (Preset) Actions
Action → Send Message
AI-generatedSummary
Send a message to WhatsApp groups or contacts
Inputs
- releaseId (required) — Select the campaign (required). Use Expression for dynamic IDs.
- accountId — Select the WhatsApp account to use (optional). Leave empty to use accountIds.
- chooseSpecificGroups — Target specific groups instead of all campaign groups.
- groupIds — IDs of target groups; populated based on selected campaign when chooseSpecificGroups is true.
- messageType (required) — Type of message to send (audioMessage, documentMessage, imageMessage, extendedTextMessage, videoMessage).
- genericText — Message text content (used when messageType is extendedTextMessage).
- genericUrl — URL of image/video/audio/document to send (used for media message types).
- genericCaption — Caption/description for media messages.
- genericFileName — Displayed file name for documentMessage.
- genericPtt — Whether to send audio as a push‑to‑talk (voice) message.
- genericOptions — Additional options for sending messages.
- accountIds — JSON array of account IDs to use for bulk sending.
- ephemeralExpiration — Ephemeral expiration time in seconds (for text messages).
- linkPreview — Enable link preview (text messages only).
- mentionAllParticipants — Mention all participants in the message.
- scheduledTo — ISO 8601 timestamp to schedule the message.
- shippingSpeed — Speed of message dispatch (none, custom, fast, normal, slow).
- customSpeedMin — Minimum seconds between sends when shippingSpeed is custom.
- customSpeedMax — Maximum seconds between sends when shippingSpeed is custom.
Output shape
an array of result objects, each representing the outcome for one input item; typical fields include success, error, and any API‑returned data such as message IDs.
If continueOnFail is enabled, failures are returned as error messages within the result object; otherwise the operation throws an error and aborts.
Examples
Example 1: Send a text message to a specific group
releaseId = 123, accountId = 456, chooseSpecificGroups = true, groupIds = ['789'], messageType = 'extendedTextMessage', genericText = 'Olá {{name}}', genericOptions = {"shippingSpeed":"normal"}
Example 2: Send an image to all groups of a campaign
releaseId = 123, messageType = 'imageMessage', genericUrl = 'https://example.com/img.jpg', genericCaption = 'Teste', genericOptions = {"shippingSpeed":"fast"}
Example 3: Bulk send documents to multiple accounts
accountsFrom = 'release', toType = 'groups', toIds = ['group1','group2'], bulkMessages = '[{"type":"documentMessage","documentMessage":{"url":"https://example.com/file.pdf","fileName":"contrato.pdf"}}]', bulkOptions = {"shippingSpeed":"custom","customSpeedMin":5,"customSpeedMax":15}
