Cloudia icon

Cloudia

Send messages

Actions20

Overview

This node, named "Cloudia," enables sending messages through various resources including WhatsApp via the Gupshup platform. Specifically, the Send Image Template operation under the Whatsapp Gupshup resource allows users to send templated image messages to customers on WhatsApp using predefined templates managed in Gupshup.

Typical use cases include:

  • Sending marketing or notification image templates to customers.
  • Automating customer engagement with personalized image messages.
  • Delivering transactional updates with branded images.

For example, a business can send an order confirmation image template to a customer's WhatsApp number, filling in dynamic parameters like customer name and order details.

Properties

Name Meaning
Cloudia API Key An API key for authenticating requests if not using stored credentials.
Channel Integration ID The numeric ID of the channel integration in Gupshup to which the message will be sent.
Phone Number The recipient's phone number in international format (e.g., 5511999999999).
Name The customer's name to personalize the message.
Template ID The identifier of the WhatsApp message template to use for sending the image.
Template Parameters A collection of values to replace variables defined in the template (supports multiple entries).
Media URL The URL of the image media to be sent as part of the template message.
Additional Fields Placeholder for any extra optional fields (currently empty in this operation).

Output

The node outputs a JSON array where each item corresponds to the response from the Cloudia API after attempting to send a message. Each JSON object contains the API response data indicating success or failure of the message send operation.

No binary data output is produced by this operation.

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 WhatsApp channel integration set up in Gupshup.
  • The template ID and parameters must match those configured in the Gupshup WhatsApp account.

Troubleshooting

  • Invalid API Key or Missing Credentials: If authentication fails, ensure the API key is correct or that credentials are properly configured.
  • Incorrect Channel Integration ID: Verify the channel integration ID exists and is active in Gupshup.
  • Template ID Not Found: Confirm the template ID matches one registered in Gupshup and is approved for use.
  • Missing Required Fields: Ensure all required properties such as phone number, template ID, media URL, and customer name are provided.
  • Network or API Errors: Check network connectivity and Cloudia API status if requests fail unexpectedly.
  • Parameter Mismatch: Template parameters must align with placeholders defined in the template; otherwise, the message may fail or render incorrectly.

Common error messages typically indicate unsupported resources or operations, missing parameters, or API request failures. Reviewing the error message and verifying input properties usually resolves these issues.

Links and References

Discussion