Actions20
- Whatsapp Gupshup Actions
- Customer Actions
- Whatsapp Web Actions
Overview
This node, named "Cloudia," enables sending messages through multiple communication channels, including WhatsApp Web. Specifically, for the Whatsapp Web - Send Image operation, it allows users to send an image message to a specified phone number via WhatsApp Web by providing the media URL and related metadata.
Common scenarios where this node is beneficial include:
- Automating customer support by sending images such as product photos or instructions.
- Marketing campaigns that require sending promotional images directly to customers' WhatsApp.
- Notifications with visual content, e.g., tickets, receipts, or event invitations.
Example use case: Automatically send a product image with a caption to a customer who requested more information via WhatsApp.
Properties
| Name | Meaning |
|---|---|
| Cloudia API Key | An API key string used for authentication if not using stored credentials. |
| Phone Number | The recipient's phone number in international format (e.g., 5511999999999). |
| Media URL | The URL of the image to be sent. Must be accessible publicly. |
| Media Filename | The filename to assign to the sent image document. |
| Caption | Optional text caption to accompany the image. |
| Additional Fields | A collection of optional fields: |
| Channel Integration ID | Numeric ID specifying the channel integration to use for sending the message. |
| Name | Customer's name to personalize the message. |
| Sent by | Indicates the sender type shown on the message: Attendant (human), Robot (bot), or System. |
Output
The node outputs a JSON array where each element corresponds to the response from the Cloudia API for each input item processed. The structure of each JSON object depends on the API response but generally includes confirmation of message delivery or error details.
No binary data output is produced by this node.
Dependencies
- Requires access to the Cloudia API service.
- An API key credential or manual API key entry is necessary for authentication.
- Network access to the media URL must be available so the service can fetch the image.
- No additional environment variables are explicitly required beyond the API key.
Troubleshooting
- Invalid or missing API key: Ensure the API key is correctly provided either via credentials or the "Cloudia API Key" property.
- Unsupported resource or operation errors: These occur if the resource or operation parameters are incorrect or not implemented. Verify you selected "Whatsapp Web" as the resource and "Send Image" as the operation.
- Media URL inaccessible: The media URL must be publicly reachable. If the image cannot be fetched, the message will fail.
- Incorrect phone number format: Use the international format without symbols or spaces.
- API request failures: Check network connectivity and Cloudia API status.
Links and References
- Cloudia API Documentation (replace with actual URL)
- WhatsApp Business API Guidelines
- n8n documentation on Creating Custom Nodes