Actions20
- Customer Actions
- Whatsapp Web Actions
- Whatsapp Gupshup Actions
Overview
This node, named "Cloudia," enables sending messages through various resources including WhatsApp via the Gupshup platform. Specifically, the Send Video Template operation under the Whatsapp Gupshup resource allows users to send a video message using a predefined WhatsApp template. This is useful for businesses automating customer communication with rich media content such as promotional videos, tutorials, or personalized greetings.
Typical use cases include:
- Sending marketing video templates to customers.
- Delivering onboarding or instructional videos automatically.
- Sharing event invitations or announcements with embedded video content.
Properties
Name | Meaning |
---|---|
Cloudia API Key | An API key string used for authentication if not using stored credentials. |
Channel Integration ID | Numeric ID representing the specific channel integration to which the message will be sent. |
Phone Number | The recipient's phone number in international format (e.g., 5511999999999). |
Name | The name of the customer receiving the message. |
Template ID | Identifier of the WhatsApp message template to use for sending the video. |
Template Parameters | A collection of parameters to fill variables defined within the chosen template. Each parameter has a value. |
Media URL | URL pointing to the video media file to be sent as part of the template message. |
Additional Fields | Optional additional fields that can be added; currently no predefined options are listed. |
Output
The node outputs an array of JSON objects corresponding to each input item processed. Each JSON object contains the response from the Cloudia API after attempting to send the video template message. The exact structure depends on the API response but generally includes status information about the message delivery.
No binary data output is produced by this node.
Dependencies
- Requires access to the Cloudia API service.
- Needs either an API key provided directly in the "Cloudia API Key" property or configured credentials within n8n.
- The "Channel Integration ID" must correspond to a valid integration set up in the Cloudia platform.
- Internet access to the media URL hosting the video file is necessary.
Troubleshooting
- Invalid API Key or Missing Credentials: If the API key is incorrect or missing, the request will fail authentication. Ensure the API key is correct or credentials are properly configured.
- Incorrect Channel Integration ID: Using an invalid or inactive channel integration ID will cause message sending to fail. Verify the ID in the Cloudia dashboard.
- Malformed Phone Number: The phone number must be in the correct international format without spaces or special characters.
- Template ID or Parameters Mismatch: If the template ID does not exist or required parameters are missing/incorrect, the API will reject the request.
- Media URL Issues: The media URL must be publicly accessible and point directly to a supported video file. Broken links or unsupported formats will cause errors.
- Unsupported Resource or Operation: The node throws errors if an unsupported resource or operation is selected.
Links and References
- Gupshup WhatsApp API Documentation
- WhatsApp Business API Templates
- Cloudia Platform Documentation (generic placeholder link)