Cloudia

Overview

This node integrates with the Cloudia messaging platform to send various types of messages. Specifically, for the Whatsapp Web resource and the Send Document operation, it allows users to send document files directly to a specified WhatsApp phone number via the Cloudia API.

Typical use cases include:

• Sending invoices, contracts, or any PDF documents to customers through WhatsApp.
• Delivering brochures or product catalogs as documents.
• Automating document delivery in customer support or sales workflows.

For example, a business could automatically send a purchase receipt PDF to a customer’s WhatsApp number after an order is completed.

Properties

Name	Meaning
Channel Integration ID	The numeric ID of the channel integration through which the message will be sent.
Name	The name of the customer who will receive the message.
Cloudia API Key	An optional API key for authenticating with the Cloudia service if not using stored credentials.
Phone Number	The recipient's phone number in international format (e.g., 5511999999999).
Media URL	The publicly accessible URL of the document file to be sent.
Media Filename	The filename to assign to the document when sending (e.g., "invoice.pdf").
Caption	Optional text caption to accompany the document.
Additional Fields	A collection allowing additional optional fields such as alternative Channel Integration ID or customer name.

Output

The node outputs a JSON array where each item corresponds to the response from the Cloudia API for each input item processed. The structure of each output JSON object depends on the Cloudia API response but generally includes confirmation details about the sent message.

No binary data is output by this node; all responses are JSON objects representing the status or result of the send operation.

Dependencies

• Requires access to the Cloudia messaging API.
• Needs either an API key provided directly in the node property or configured via n8n credentials.
• The node makes HTTP POST requests to Cloudia endpoints corresponding to the selected resource and operation.
• Proper network connectivity to the Cloudia API endpoint is necessary.

Troubleshooting

• Common Issues:

  • Invalid or missing API key: Ensure the API key is correctly set either in the node or credentials.
  • Incorrect phone number format: Use international format without spaces or special characters.
  • Invalid or inaccessible media URL: The document URL must be publicly accessible and valid.
  • Missing required properties like Channel Integration ID or Media Filename.

• Error Messages:

  • Unsupported resource or Unsupported operation: Occurs if the resource or operation parameter is incorrect or not implemented.
  • API request failures: May return errors related to authentication, invalid parameters, or server issues. Check the error message returned by the Cloudia API for specifics.

• Resolution Tips:

  • Double-check all required fields are filled and formatted correctly.
  • Verify that the media URL is reachable and points to a valid document.
  • Confirm that the API key has sufficient permissions.
  • Enable "Continue On Fail" in the node settings to handle errors gracefully during batch processing.

Links and References

• Cloudia Messaging API Documentation (example placeholder, replace with actual URL if available)
• WhatsApp Business API guidelines for sending media messages
• n8n documentation on creating custom nodes and handling API requests