Actions13
- Chatwoot Integration Actions
- Instance Actions
- Message Actions
- Parser Actions
- Webhook Actions
Overview
This node operation "Send Media URL to Group" allows sending media messages (image, audio, video, or document) to a WhatsApp group using a direct URL to the media file. It is useful for automating the distribution of multimedia content to WhatsApp groups without needing to upload files manually. Typical use cases include sharing promotional images, audio announcements, videos, or documents with team members or community groups.
For example, you can send an image hosted on a public URL to a specific WhatsApp group along with an optional caption describing the content.
Properties
| Name | Meaning |
|---|---|
| Group JID | The unique identifier of the WhatsApp group in the format 120363123456789012@g.us. |
| Media URL | The publicly accessible URL of the media file to be sent to the group. |
| File Name | The name of the file as it will appear in the message (e.g., image.jpg). |
| Media Type | The type of media being sent. Options: Image, Audio, Video, Document. |
| Caption | Optional text caption to accompany the media message in the group chat. |
Output
The node outputs JSON data representing the result of the send operation. This typically includes confirmation details such as message IDs or status indicators confirming that the media was sent successfully to the specified WhatsApp group.
If the node supports binary data output (not explicitly shown here), it would represent the media content or related metadata, but this operation focuses on sending media via URL and does not output binary data.
Dependencies
- Requires access to the MegaAPI WhatsApp service to send messages.
- Needs proper authentication configured in n8n to connect to the MegaAPI service (e.g., API key or token).
- The media URL must be publicly accessible by the MegaAPI service to fetch and send the media.
- The WhatsApp group JID must be valid and the bot/service must have permission to send messages to that group.
Troubleshooting
- Invalid Group JID: If the group JID is malformed or the bot is not part of the group, the message will fail to send. Verify the group JID format and membership.
- Media URL inaccessible: If the media URL is private, broken, or unreachable, the media cannot be fetched. Ensure the URL is correct and publicly accessible.
- Unsupported Media Type: Sending a media type not supported by WhatsApp or the API may cause errors. Use only the supported types: image, audio, video, or document.
- File Name Issues: Providing an invalid or missing file name might cause the message to fail or display incorrectly.
- API Errors: Network issues or authentication failures with the MegaAPI service will prevent sending messages. Check credentials and network connectivity.
- Common error messages will indicate the nature of the failure, such as "Unknown message operation" if the operation parameter is incorrect, or connection/authentication errors from the API.
Links and References
- WhatsApp Group JID Format Explanation
- MegaAPI WhatsApp Service Documentation (generic placeholder, replace with actual link if available)
- n8n Documentation on Creating Custom Nodes