Actions11
- Message Actions
- Group Actions
- Contact Group Actions
- Instance Actions
Overview
This node integrates with the Waapify API to send WhatsApp messages and media. Specifically, for the Group resource with the Send Media operation, it allows sending media files (images, videos, documents, etc.) to a WhatsApp group chat. Users provide the target group ID, the media URL, and optionally a caption and filename.
Common scenarios include:
- Broadcasting promotional images or videos to a customer group.
- Sharing documents or multimedia content within team or community groups.
- Automating media sharing workflows triggered by other events in n8n.
Example: Automatically send a product brochure PDF to a sales team WhatsApp group whenever a new product is added to your inventory system.
Properties
| Name | Meaning |
|---|---|
| Group ID | The unique identifier of the WhatsApp group to which the media will be sent. |
| Message | Optional caption text accompanying the media file. |
| Media URL | The direct URL of the media file to send (required). |
| Filename | Optional filename used when sending document-type media (e.g., PDFs). |
Output
The node outputs an array of JSON objects representing the response from the Waapify API for each input item processed. Each output item corresponds to one message sent and contains the API's response data, which typically includes status information about the message delivery.
No binary data is output by this node; all results are returned as JSON metadata.
Dependencies
Requires an active Waapify API account with valid credentials including:
- Base URL of the Waapify API endpoint.
- Instance ID.
- Access token for authentication.
The node uses HTTP requests to communicate with the Waapify API.
Proper configuration of these credentials in n8n is necessary before use.
Troubleshooting
Common issues:
- Invalid or missing Group ID can cause message sending failures.
- Incorrect or inaccessible Media URL will prevent media delivery.
- Missing or expired API credentials will result in authentication errors.
- Network connectivity problems may cause request timeouts.
Error messages:
- Errors returned from the Waapify API are prefixed with
Waapify API Error:followed by the specific message. - HTTP status codes are included in error details to help diagnose issues (e.g., 401 Unauthorized, 404 Not Found).
- Errors returned from the Waapify API are prefixed with
Resolutions:
- Verify that the Group ID matches an existing WhatsApp group accessible by the Waapify instance.
- Ensure the Media URL is publicly accessible and points directly to the media file.
- Check and update API credentials if authentication fails.
- Use the "Continue On Fail" option in n8n to handle errors gracefully during batch processing.
Links and References
- Waapify API Documentation (for detailed API usage and parameters)
- WhatsApp Group Messaging Best Practices
- n8n HTTP Request Node Documentation (for understanding underlying HTTP calls)