Cloudia

Overview

This node, named "Cloudia," enables sending messages through multiple messaging resources, including WhatsApp Web. Specifically, the Send Options List operation for the WhatsApp Web resource allows users to send a message containing a list of selectable options to a specified phone number. This is useful in scenarios such as customer support, marketing campaigns, or interactive chatbots where you want to present users with predefined choices they can select from.

For example, a business could send a menu of product categories or service options to a customer via WhatsApp, allowing them to respond by selecting one of the options rather than typing free text.

Properties

Name	Meaning
Cloudia API Key	An API key string used for authentication if not using stored credentials. It should be kept secret and is required to authorize requests to the Cloudia service.
Phone Number	The recipient's phone number in international format (e.g., 5511999999999). This is the number to which the options list message will be sent.
Text	The main text message content that accompanies the options list. This is the message shown above the list of options.
Options	A collection of one or more options to include in the list. Each option has: - Option Title: The title or label of the option (required). - Option Description: Additional descriptive text for the option.
Additional Fields	Optional extra fields to customize the message: - Channel Integration ID: Numeric ID specifying the channel integration to use. - Name: Customer's name to personalize the message. - Sent by: Indicates who the message appears to be sent by; options are Attendant (human), Robot (bot), or System.

Output

The node outputs an array of JSON objects corresponding to each input item processed. Each output object contains the response from the Cloudia API after attempting to send the message with the options list. 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.
• An API key credential or equivalent authentication token must be provided either directly in the node or via n8n credentials.
• Network connectivity to the Cloudia API endpoint is necessary.
• No additional external dependencies beyond the Cloudia API.

Troubleshooting

• Common Issues:

  • Invalid or missing API key: Ensure the API key is correctly set and valid.
  • Incorrect phone number format: Use the international format without symbols or spaces.
  • Missing required fields like message text or options: Make sure all required properties are filled.
  • Unsupported resource or operation errors: Verify that the selected resource is "Whatsapp Web" and operation is "Send Options List."

• Error Messages:

  • "Unsupported resource": Occurs if a resource other than the supported ones is selected.
  • "Unsupported operation": Happens when an operation not implemented for the chosen resource is requested.
  • API request failures may return error messages from the Cloudia service indicating issues like invalid parameters or authorization failure.

To resolve errors, double-check property values, ensure proper API key usage, and confirm network connectivity.

Links and References

• Cloudia Official Website (for API documentation and account setup)
• WhatsApp Business API documentation (general reference for message types and formats)
• n8n Documentation on creating custom nodes and using credentials