Cloudia

Send messages

Actions20

Overview

This node integrates with the Cloudia platform to send WhatsApp messages using the Gupshup service. Specifically, the "Send Location Template" operation allows users to send a location-based message template to a specified phone number via WhatsApp. This is useful for businesses that want to share precise location information (such as store addresses, event venues, or meeting points) with customers in a structured and templated format.

Practical examples include:

Sending a store location to a customer who requested directions.
Sharing an event venue location as part of a confirmation message.
Providing a pickup point location for delivery or ride services.

Properties

Name	Meaning
Cloudia API Key	An API key for authenticating requests to Cloudia. Fill this if not using stored credentials.
Channel Integration ID	The numeric ID of the channel integration through which the message will be sent.
Phone Number	The recipient's phone number in international format (e.g., 5511999999999).
Name	The name of the customer receiving the message.
Template ID	The identifier of the WhatsApp message template to use.
Template Parameters	A collection of parameters to fill variables defined in the message template.
Address Name	The name/title of the location being sent (e.g., "Cloudia").
Address Location	The full address string of the location (e.g., "Av. Paulista 171, Pavimento 4 - Bela Vista...").
Latitude	The latitude coordinate of the location.
Longitude	The longitude coordinate of the location.
Additional Fields	Placeholder for any extra optional fields (currently empty).

Output

The node outputs a JSON array where each element corresponds to the response from the Cloudia API for each input item processed. The JSON structure contains the API response data confirming the message sending status or error details if the request failed.

No binary data output is produced by this node.

Dependencies

Requires access to the Cloudia API with a valid API key or configured credentials.
Needs the Channel Integration ID configured in Cloudia for WhatsApp messaging.
The node uses HTTP POST requests to Cloudia endpoints to send messages.
No additional environment variables are explicitly required beyond the API key or credentials.

Troubleshooting

Common issues:
- Invalid or missing API key: Ensure the API key is correctly provided either in the node property or credentials.
- Incorrect Channel Integration ID: Verify the ID matches the one configured in Cloudia for WhatsApp.
- Invalid phone number format: Use international format without spaces or special characters.
- Template ID mismatch: Confirm the template ID exists and is approved in the Cloudia/Gupshup system.
- Missing required location fields (name, address, latitude, longitude): All must be provided for the location template.
Error messages:
- "Unsupported resource" or "Unsupported operation": Indicates a misconfiguration in the node's Resource or Operation selection.
- API errors returned from Cloudia will be included in the output JSON under error if "Continue On Fail" is enabled.

To resolve errors, double-check all required fields, ensure API credentials are valid, and confirm template and integration IDs are correct.