Actions76
- Message Actions
- Chat Actions
- Contact Actions
- Group Actions
- Create
- List
- Get
- Delete
- Join
- Get Join Info
- Leave
- Get Picture
- Set Picture
- Delete Picture
- Update Subject
- Update Description
- Get Security Info Admin Only
- Set Security Info Admin Only
- Get Security Messages Admin Only
- Set Security Messages Admin Only
- Get Participants
- Add Participant
- Remove Participant
- Promote Admin
- Demote Admin
- Status Actions
- Channel Actions
- Poll Actions
- Profile Actions
- LID Actions
- File Actions
Overview
This node enables sending an image message through WhatsApp using the Wappfy API. It supports sending images either by providing a direct URL or by supplying Base64-encoded image data. Users can specify the target chat and optionally add a caption to the image.
Common scenarios where this node is useful include:
- Automating marketing campaigns by sending promotional images to customers.
- Sharing product photos or visual updates in customer support chats.
- Broadcasting event invitations or announcements with images to groups or individual contacts.
Example: Sending a product photo to a customer chat by specifying the chat ID and image URL, optionally adding a caption describing the product.
Properties
| Name | Meaning |
|---|---|
| Chat ID | The identifier of the chat to send the image to (e.g., 123456789@c.us for direct, or 123456789@g.us for group). |
| Media Source | The source type of the media file to send. Options: URL (send via a file URL), Base64 (send via Base64 encoded data). |
| File URL | The URL of the image file to send. Required if Media Source is URL. |
| Base64 Data | The Base64 encoded string of the image file. Required if Media Source is Base64. |
| File Name | The name of the file when sending Base64 data. Defaults to "file". |
| MIME Type | The MIME type of the image file (e.g., image/jpeg, image/png). Required. |
| Caption | Optional text caption to accompany the image message. |
Output
The node outputs JSON data representing the response from the Wappfy API after attempting to send the image. This typically includes details about the sent message such as message ID, status, timestamps, or error information if the request failed.
No binary data output is produced by this operation.
Dependencies
Requires a configured Wappfy API credential containing at least:
- Base URL of the Wappfy API instance.
- Instance name identifier.
- An API key or authentication token for authorization.
The node makes HTTP POST requests to the Wappfy API endpoints to send messages.
Troubleshooting
- Invalid Chat ID: If the chat ID is incorrect or does not exist, the API will likely return an error. Verify the chat ID format and existence.
- Incorrect MIME Type: Providing an incorrect or unsupported MIME type may cause the API to reject the file. Use standard MIME types like
image/jpegorimage/png. - Missing Required Fields: Ensure that required fields such as Chat ID, MIME Type, and either File URL or Base64 Data (depending on Media Source) are provided.
- API Authentication Errors: If the API key or credentials are invalid or missing, requests will fail. Confirm that the Wappfy API credentials are correctly set up in n8n.
- Large File Size: Very large images might be rejected or cause timeouts. Consider resizing or compressing images before sending.
Common error messages usually come from the Wappfy API and should be checked in the node's output JSON under error fields.
Links and References
- Wappfy API Documentation (for detailed API usage and supported message types)
- WhatsApp Business API Guide (general reference for WhatsApp messaging concepts)