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 Document Template operation under the Whatsapp Gupshup resource allows users to send templated document messages to customers using predefined templates on the Gupshup WhatsApp channel.

Typical use cases include:

  • Automating customer communication by sending standardized document templates (e.g., invoices, contracts) via WhatsApp.
  • Integrating WhatsApp messaging into workflows for notifications or confirmations that require document attachments.
  • Personalizing messages with template parameters to dynamically fill variables in the document template.

Example: Sending a contract document template to a customer’s WhatsApp number with their name and other dynamic fields filled in.

Properties

Name Meaning
Cloudia API Key An API key string used for authentication if not using stored credentials.
Channel Integration ID Numeric ID of the WhatsApp channel integration where the message will be sent.
Phone Number The recipient's phone number in international format (e.g., 5511999999999).
Name Customer's name to personalize the message.
Template ID Identifier of the document template to send.
Template Parameters A collection of key-value pairs to replace variables defined in the template.
Media URL URL pointing to the media/document file to be sent along with the template message.
Additional Fields Optional additional fields for extended configuration (empty by default).

Output

The node outputs an array of JSON objects representing the response from the Cloudia API for each input item processed. Each object contains the result of the send operation, typically including status information about the message delivery.

If the operation involves sending media (documents), the output does not contain binary data but confirms the successful dispatch referencing the media URL.

Dependencies

  • Requires access to the Cloudia API service.
  • Needs either an API key provided directly in the node property or configured credentials within n8n.
  • The Channel Integration ID must correspond to a valid WhatsApp channel set up in Cloudia/Gupshup.
  • Internet access to the specified Media URL is necessary for the document to be fetched and sent.

Troubleshooting

  • Invalid API Key or Missing Credentials: Ensure the API key is correct and has permissions to send messages.
  • Incorrect Channel Integration ID: Verify the channel ID matches an active WhatsApp integration.
  • Malformed Phone Number: Use the international format without spaces or special characters.
  • Template ID Not Found: Confirm the template ID exists and is approved in the Gupshup WhatsApp account.
  • Media URL Inaccessible: Check that the media URL is publicly accessible and points to a supported document type.
  • Unsupported Resource or Operation Errors: These occur if the resource or operation names are misspelled or not implemented; verify selections in the node UI.

Links and References

This summary is based solely on static analysis of the provided source code and property definitions.

Discussion