Cloudia icon

Cloudia

Send messages

Overview

This node, named "Cloudia," enables sending messages through different messaging resources, including WhatsApp Web. Specifically, the Send Location operation under the Whatsapp Web resource allows users to send a geographic location message to a specified phone number via WhatsApp.

Typical use cases include:

  • Sharing a meeting point or event location with customers.
  • Sending delivery or pickup addresses directly to clients.
  • Providing directions or store locations in customer support conversations.

For example, a business can automatically send a customer's order pickup location after confirming an order, improving communication efficiency and customer experience.

Properties

Name Meaning
Cloudia API Key An API key string for authenticating requests if not using stored credentials.
Phone Number The recipient's phone number in international format (e.g., 5511999999999).
Address Location The textual address description to be sent along with the location coordinates.
Latitude The latitude coordinate of the location to send.
Longitude The longitude coordinate of the location to send.
Additional Fields A collection of optional fields:
- Channel Integration ID Numeric ID specifying the channel integration to send the message through.
- Name Customer's name to personalize the message.
- Sent by Indicates who the message should appear as sent by; options are: Attendant, Robot, 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 location message.

The exact structure depends on the API response but generally includes status information about the message delivery.

No binary data is produced by this node.

Dependencies

  • Requires access to the Cloudia API service.
  • Needs either an API key provided directly in the node property or configured credentials within n8n.
  • Network connectivity to the Cloudia API endpoint.
  • No additional external libraries beyond those bundled with the node.

Troubleshooting

  • Common Issues:

    • Missing or invalid API key: Ensure the API key is correctly set either in the node or credentials.
    • Incorrect phone number format: Use international format without symbols or spaces.
    • Invalid or missing latitude/longitude values: Provide valid numeric coordinates.
    • Unsupported resource or operation errors: Confirm that the selected resource is "Whatsapp Web" and operation is "Send Location."
  • Error Messages:

    • "Unsupported resource: whatsapp-web" or "Unsupported operation: send-location": This indicates a misconfiguration in resource or operation selection.
    • API request failures may return error messages from the Cloudia API, such as authentication errors or rate limits. Check API key validity and usage quotas.
    • If continueOnFail is enabled, errors will be returned in the output array as { error: "message" }.

Links and References

Discussion