Cloudia icon

Cloudia

Send messages

Actions20

Overview

This node, named "Cloudia," enables sending messages through multiple messaging resources, including WhatsApp Web. Specifically, the Send Video operation under the Whatsapp Web resource allows users to send video files as messages to specified phone numbers via WhatsApp Web.

Typical use cases include:

  • Automating video message delivery for customer support or marketing campaigns.
  • Sending instructional or promotional videos directly to customers' WhatsApp accounts.
  • Integrating video messaging into workflows that require multimedia communication.

For example, a business could automatically send a product demo video to a customer after they request more information, improving engagement and customer experience.

Properties

Name Meaning
Cloudia API Key An API key string used for authentication 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 video file to be sent.
Media Filename The filename to assign to the video when sent (e.g., "promo.mp4").
Caption Optional text caption accompanying the video message.
Additional Fields A collection of optional fields:
- Channel Integration ID Numeric ID specifying the channel integration to use for sending the message.
- Name Customer's name to personalize the message.
- Sent by Indicates the sender type shown on the message: options are Attendant (human), Robot (bot), or System.

Output

The node outputs an array of JSON objects representing the response from the Cloudia API for each input item processed. Each object contains details about the message sending result, such as success status or error information.

If the operation involves binary data (like video), the node does not output the binary content itself but sends it via the provided media URL. Therefore, the output JSON primarily reflects metadata and API response details rather than raw media data.

Dependencies

  • Requires access to the Cloudia API service.
  • Needs either an API key provided directly in the "Cloudia API Key" property or configured credentials within n8n.
  • Internet access to the media URL hosting the video file is necessary.
  • No additional environment variables are explicitly required beyond standard n8n setup.

Troubleshooting

  • Invalid Phone Number Format: Ensure the phone number is in the correct international format without spaces or special characters.
  • Media URL Inaccessible: The media URL must be publicly accessible; otherwise, the video cannot be fetched and sent.
  • Missing Required Fields: The node requires Phone Number, Media URL, and Media Filename for sending videos. Omitting these will cause errors.
  • API Authentication Errors: If the API key is missing or invalid, the request will fail. Verify the API key correctness and presence.
  • Unsupported Operation or Resource: The node throws errors if an unsupported resource or operation is selected. Confirm you are using "Whatsapp Web" as the resource and "Send Video" as the operation.
  • Network Issues: Connectivity problems with the Cloudia API endpoint can cause timeouts or failures.

Links and References

Discussion