Actions90
- Sessions Actions
- Messages - Sending Actions
- Chats Actions
- Messages - Actions Actions
- Groups Actions
- List Groups
- Group Info
- Get Invite Link
- Revoke Invite Link
- Join via Link
- Preview via Link
- Create Group
- Delete Group
- Update Group Description
- Toggle Announcement Mode
- List Participants
- Add Participants
- Remove Participants
- Demote Participants
- Approve Join Request
- Reject Join Request
- List Join Requests
- Get Group Picture
- Set Group Picture
- Delete Group Picture
- Leave Group
- Update Group Name
- Lock Group Edits
- Promote Participants
- Profile Actions
- Server Actions
- Miscellaneous Actions
Overview
This node operation sends one or more files as messages through a specified WhatsApp session using the WARest WhatsApp REST API. It supports sending files via URLs, local paths, data URIs, or binary data from the workflow. Users can specify the recipient(s), add optional captions, and reply to specific messages. This operation is useful for automating file sharing in WhatsApp chats, such as sending images, documents, or other media files to contacts or groups.
Use Case Examples
- Automatically send product brochures as files to customers after a form submission.
- Share event photos with a WhatsApp group by uploading images from a local directory.
- Send multiple files with captions to a contact list for marketing campaigns.
Properties
| Name | Meaning |
|---|---|
| Session | The WhatsApp session identifier to use for sending files. It can be selected from a list of active sessions or entered manually. |
| Recipient / Chat (to) | The phone number(s) or JID(s) of the recipient(s) to whom the files will be sent. Multiple recipients can be specified as a comma-separated list. |
| Files | A collection of one or more files to send. Each file can be specified by URL, local path, or data URI, or by using binary data from the workflow. Optional filename overrides, captions, and reply message options are supported. |
| Caption | An optional caption text to include with the files being sent. |
| Additional Fields | Optional additional message fields 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 files and message status.
Dependencies
- WARest WhatsApp REST API
Troubleshooting
- Ensure the session ID is valid and active; otherwise, the API call will fail.
- Verify that the recipient phone numbers or JIDs are correctly formatted and registered on WhatsApp.
- When using binary files, confirm that the binary property name matches the workflow's binary data property.
- If sending multiple files, ensure each file entry is correctly specified with either a URL/path or binary data.
- Check for required permissions and API key validity for the WARest API credentials.
Links
- WARest API Documentation - Official documentation for the WARest WhatsApp REST API used by this node.
