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 video messages through WhatsApp using the Wappfy API. It supports sending videos either by providing a direct URL or by uploading Base64-encoded video data. Users can specify the target chat and optionally add captions to the video message.
Common scenarios where this node is beneficial include:
- Automating marketing campaigns by sending promotional videos to customers.
- Sharing event highlights or tutorials in group chats.
- Broadcasting video updates or announcements to multiple contacts.
Practical example:
- A business wants to send a product demo video to a customer’s WhatsApp chat automatically after they sign up on their website. The node sends the video by specifying the customer's chat ID and the video file URL, optionally adding a caption describing the product.
Properties
| Name | Meaning |
|---|---|
| Chat ID | Identifier of the WhatsApp chat to send the video to (e.g., 123456789@c.us for direct chat or 123456789@g.us for group). |
| Media Source | Source type of the video file: either URL (a direct link to the video) or Base64 (Base64 encoded video data). |
| File URL | URL of the video file to send (required if Media Source is URL). |
| Base64 Data | Base64 encoded string of the video file (required if Media Source is Base64). |
| File Name | Name of the video file (used when Media Source is Base64; default is "file"). |
| MIME Type | MIME type of the video file (e.g., video/mp4, required). |
| Caption | Optional text caption to accompany the video message. |
Output
The node outputs JSON data representing the response from the Wappfy API after attempting to send the video message. This typically includes details about the sent message such as message ID, status, timestamps, or error information if the request failed.
If multiple input items are processed, the output is an array of JSON objects corresponding to each item.
The node does not output binary data for this operation.
Dependencies
Requires access to the Wappfy API with valid credentials including:
- Base URL of the Wappfy API instance.
- Instance name identifier.
- An API key credential for authentication.
The node must be configured with these credentials in n8n before use.
Troubleshooting
Invalid Chat ID: If the chat ID is incorrect or the bot is not part of the chat/group, the API may return an error. Verify the chat ID format and membership.
Incorrect MIME Type: Sending a video with an unsupported or incorrect MIME type may cause failures. Ensure the MIME type matches the actual video format.
Media Source Mismatch: Providing a URL when Base64 data is expected or vice versa will cause errors. Double-check the selected media source and corresponding property.
API Authentication Errors: Missing or invalid API key will result in authentication failures. Confirm that the API key credential is correctly set.
Network Issues: Connectivity problems to the Wappfy API endpoint can cause timeouts or request failures. Check network access and API availability.
Error messages returned by the node generally reflect the underlying HTTP response from the Wappfy API and should be reviewed accordingly.
Links and References
- Wappfy API Documentation (for detailed API usage and supported operations)
- WhatsApp Business API Overview (general background on WhatsApp messaging APIs)