Cativa icon

Cativa

Consume Cativa API

Overview

This node allows you to send push notifications to a user via the Cativa API. It is designed for scenarios where you need to programmatically notify users, such as alerting them about important updates, reminders, or personalized messages within an automated workflow.

Practical examples:

  • Sending a real-time alert to a user when their account status changes.
  • Notifying users of new features or announcements.
  • Delivering custom reminders or confirmations directly to a user's device.

Properties

Name Meaning
Email The email address of the user who will receive the push notification. (Required)
Título The title of the push notification message. (Required)
Descrição The body or description text of the push notification. (Optional)

Output

The output is a JSON object (or array of objects if multiple items are processed). The structure typically includes the result of the push notification operation. If an error occurs and "Continue On Fail" is enabled, the output will include an error field with the error message.

Example output:

{
  "success": true,
  "message": "Push notification sent successfully"
}

Or, in case of error:

{
  "error": "User not found"
}

Dependencies

  • External Service: Requires access to the Cativa API.
  • API Key: You must configure valid Cativa API credentials in n8n under the name cativaApi.

Troubleshooting

  • Common Issues:

    • Missing or invalid API credentials will prevent the node from sending notifications.
    • Providing an incorrect or non-existent email may result in errors like "User not found."
    • Required fields (Email, Título) left empty will cause validation errors.
  • Error Messages:

    • "Authentication successful": Indicates that your API credentials are valid.
    • "User not found": The provided email does not match any user in the system.
    • Other error messages will be returned in the error field if "Continue On Fail" is enabled.

Links and References

  • n8n Documentation
  • Cativa API documentation (contact your Cativa administrator for access)

Discussion