WAREST icon

WAREST

Interact with the WARest WhatsApp REST API

Overview

This node operation sends media messages (images or videos) via WhatsApp using the WARest WhatsApp REST API. It supports sending media either by URL, local path, base64 data URI, or directly from binary data within the workflow. Additional options include adding captions, compressing media, and sending view-once media. This node is useful for automating the distribution of multimedia content to WhatsApp contacts or groups, such as marketing images, product videos, or personal media sharing.

Use Case Examples

  1. Sending a promotional image with a caption to a customer list.
  2. Sharing a video clip to a WhatsApp group automatically.
  3. Sending a view-once photo for secure or temporary viewing.

Properties

Name Meaning
Session Identifier of the WhatsApp session to use for sending the media message.
Recipient / Chat (to) Phone number or JID of the recipient or chat to send the media message to.
Binary File Toggle to enable sending media from a binary property instead of a URL or path.
Media URL, local path, or base64 data URI of the media to send (used if Binary File is false).
Media Binary Property Name of the binary property containing the media data (used if Binary File is true).
Caption Optional caption text to accompany the media message.
Compress Media Option to compress the media before sending to reduce size.
View Once Send the media as a view-once message, which can only be viewed once by the recipient.
Additional Fields Extra options such as sending typing indicators before the message, replying to a specific message ID, or marking the message as forwarded.

Output

JSON

  • json - The JSON response from the WARest API containing details about the sent media message.

Dependencies

  • WARest WhatsApp REST API

Troubleshooting

  • Ensure the session ID is valid and active; invalid sessions will cause failures.
  • If using binary mode, verify the binary property name matches the input data.
  • Check that the recipient phone number or JID is correctly formatted and reachable on WhatsApp.
  • For view-once media, confirm the recipient's WhatsApp client supports this feature.
  • Compression may reduce media quality; disable if quality is critical.

Links

Discussion