Cloudia icon

Cloudia

Send messages

Overview

This node, named "Cloudia," enables sending messages through multiple messaging resources, including WhatsApp Web. Specifically, the Whatsapp Web - Send Text operation allows users to send plain text messages to a specified phone number via a configured channel integration.

Common scenarios for this node include:

  • Sending notifications or alerts to customers on WhatsApp.
  • Automating customer engagement by sending personalized messages.
  • Integrating WhatsApp messaging into workflows for marketing or support.

For example, a business could use this node to automatically send appointment reminders or promotional messages to customers' WhatsApp numbers.

Properties

Name Meaning
Channel Integration ID The numeric ID of the WhatsApp 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 credentials are not used.
Phone Number The recipient's phone number in international format (e.g., 5511999999999).
Text The actual text content of the message to be sent.
Additional Fields Optional additional fields that can include Channel Integration ID and Name again for flexibility.

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 message sending operation, typically including status information returned by the API.

If the operation fails for any item and "Continue On Fail" is enabled, the output for that item will contain an error field with the error message.

No binary data output is produced by this node.

Dependencies

  • Requires access to the Cloudia API service.
  • Needs either an API key provided directly in the node parameters or configured credentials within n8n for authentication.
  • The node makes HTTP POST requests to Cloudia endpoints corresponding to the selected resource and operation.
  • Proper configuration of the WhatsApp channel integration ID is necessary to route messages correctly.

Troubleshooting

  • Common Issues:

    • Invalid or missing Channel Integration ID may cause message sending failures.
    • Incorrect phone number format can lead to delivery errors.
    • Missing or invalid API key/credentials will result in authentication errors.
    • Unsupported resource or operation selections will throw errors.
  • Error Messages:

    • "Unsupported resource: <resource>": The selected resource is not implemented or recognized.
    • "Unsupported operation: <operation>": The chosen operation does not exist for the selected resource.
    • API errors returned from Cloudia will be included in the output; check these for details like invalid parameters or quota limits.
  • Resolutions:

    • Verify all required fields are filled correctly.
    • Ensure the API key or credentials are valid and have sufficient permissions.
    • Confirm the phone number is in the correct international format without extra characters.
    • Check that the Channel Integration ID corresponds to an active WhatsApp channel in Cloudia.

Links and References

  • Cloudia Official Website (for API documentation and account setup)
  • WhatsApp Business API guidelines (for understanding phone number formatting and messaging rules)
  • n8n Documentation on creating and using credentials (for setting up API keys securely)

Discussion