Cloudia

Overview

This node, named "Cloudia," enables sending messages through various messaging resources, including WhatsApp Web. Specifically, the "Send Options List" operation under the Whatsapp Web resource allows users to send a message containing a list of selectable options to a specified phone number via WhatsApp.

Typical use cases include:

• Customer support scenarios where you want to present multiple predefined choices to a customer.
• Interactive marketing campaigns that require customers to select from a menu of options.
• Automated workflows that guide users through decision trees by offering clickable options.

For example, a business could send a message like "Please choose your preferred service:" with options such as "Order Status," "New Order," and "Speak to Support."

Properties

Name	Meaning
Channel Integration ID	The numeric ID of the channel integration through which the message will be sent. This identifies the specific WhatsApp integration configured in the system.
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).
Text	The main text content of the message to be sent alongside the options list.
Options	A collection of one or more options to include in the options list. Each option has: - Option Title: The title text shown for the option (required). - Option Description: Additional descriptive text.
Additional Fields	Optional additional fields that can override or supplement the main properties, including: - Channel Integration ID - Name

Output

The node outputs an array of JSON objects representing the response from the Cloudia API after sending the message. Each item corresponds to one input item processed.

The json output typically contains details about the message delivery status or any errors returned by the API.

This node does not output binary data.

Dependencies

• Requires access to the Cloudia messaging API.
• Needs either an API key provided directly in the node parameters or configured credentials within n8n.
• The "Channel Integration ID" must correspond to a valid WhatsApp Web integration set up in the Cloudia platform.

Troubleshooting

• Common Issues:

  • Invalid or missing Channel Integration ID: Ensure the ID matches a configured WhatsApp Web channel.
  • Incorrect phone number format: Use international format without spaces or special characters.
  • Missing required fields like customer name or message text.
  • API key authentication failures if the key is invalid or expired.

• Error Messages:

  • "Unsupported resource" or "Unsupported operation": Indicates the selected resource or operation is not implemented or incorrectly specified.
  • API request errors returned from Cloudia, such as authorization errors or validation failures, will appear in the output JSON error field.

• Resolutions:

  • Double-check all required parameters are filled correctly.
  • Verify API key validity and permissions.
  • Confirm the channel integration exists and is active.
  • Use the node’s "Continue On Fail" option to handle errors gracefully during batch processing.

Links and References

• Cloudia Official Website (for API documentation and account setup)
• WhatsApp Business API guidelines (for understanding message templates and options lists)
• n8n Documentation on creating custom nodes and handling API requests