Actions50
- Account Actions
- Call Actions
- Chat Actions
- Contact Actions
- Group Actions
- Instance Actions
- Media Actions
- Message Actions
- Session Actions
- User Actions
Overview
This node enables sending an image message via WhatsApp using the WSAPI WhatsApp API. It is designed to send images to individual contacts or groups by specifying their WhatsApp IDs. This functionality is useful in scenarios such as:
- Sending product photos or promotional images to customers.
- Sharing event flyers or invitations in group chats.
- Delivering visual content like screenshots or diagrams during support conversations.
For example, a user can automate sending a welcome image with a caption to new customers or share a photo update in a team group chat.
Properties
| Name | Meaning |
|---|---|
| To | The recipient's WhatsApp ID. For individual contacts, this is the phone number with country code (no plus sign) followed by @s.whatsapp.net (e.g., 1234567890@s.whatsapp.net). For groups, use the group ID followed by @g.us. |
| Media URL | Publicly accessible HTTP or HTTPS URL of the image file to send. Supported formats include JPG and PNG. |
| Caption | Optional text caption to accompany the image. Supports emojis and formatting. |
| Mentions | (Advanced Option) Comma-separated list of phone numbers (without @) to mention/tag in the message. |
| Reply To Message ID | (Advanced Option) ID of an existing message to which this image message will be sent as a reply. |
| Is Forwarded | (Advanced Option) Boolean flag indicating if the message should be marked as forwarded. |
| View Once | (Advanced Option) Boolean flag indicating if the image should disappear after being viewed once. Only applicable for image and video messages. |
Output
The node outputs JSON data representing the result of the send image operation. This typically includes metadata about the sent message such as message ID, status, timestamps, and any server response details confirming successful delivery.
No binary data output is produced by this node.
Dependencies
- Requires an active connection to the WSAPI WhatsApp API service.
- An API key credential must be configured in n8n to authenticate requests.
- The media URL must be publicly accessible over HTTP or HTTPS; private or local URLs are not supported.
- Proper permissions on the WhatsApp account to send media messages.
Troubleshooting
- Invalid Recipient ID: If the "To" field is incorrectly formatted or the contact/group ID does not exist, the API may return an error. Ensure the phone number includes the country code without "+" and uses the correct suffix (
@s.whatsapp.netfor contacts,@g.usfor groups). - Media URL Not Accessible: If the media URL is not publicly reachable or the file format is unsupported, the message will fail to send. Verify the URL is correct and points directly to an image file.
- Missing API Credentials: The node requires valid API credentials. Errors related to authentication indicate missing or invalid API keys.
- View Once Option Misuse: Setting "View Once" on unsupported message types or operations other than image/video may cause errors.
- Reply To Message ID Invalid: Providing a non-existent message ID for replying will cause the operation to fail.