Valeia - Set Webhook icon

Valeia - Set Webhook

Set the webhook URL for receiving messages

Overview

This node, named "Valeia - Set Webhook," is designed to configure a webhook URL for the Valeia service. It allows users to specify a URL where Valeia will send incoming message notifications. This is useful in scenarios where you want to integrate Valeia's messaging events with your n8n workflows by receiving real-time updates via webhooks.

For example, if you run an application that needs to react immediately when a new message arrives in Valeia, you can use this node to set the webhook URL pointing to an n8n webhook endpoint. Once set, Valeia will push message notifications to that URL, triggering further automation.

Properties

Name Meaning
Webhook URL The URL where Valeia will send incoming message notifications. Must be a valid HTTPS URL.

Output

The node outputs an array of JSON objects, each representing the response from the Valeia API after setting the webhook URL. The structure of the output JSON corresponds to the API's response and typically includes confirmation or status details about the webhook registration.

If an error occurs during the request, and the node is configured to continue on failure, the output JSON will contain an error field with the error message.

Dependencies

  • Requires an active API authentication credential for the Valeia service.
  • Makes an authenticated HTTP PUT request to the Valeia API endpoint: https://valeian8n.whitelabel.lat/api/users/webhook.
  • The node expects the environment to have network access to the Valeia API.

Troubleshooting

  • Common issues:

    • Invalid or unreachable webhook URL: Ensure the URL is correct, publicly accessible, and uses HTTPS.
    • Authentication failures: Verify that the API key or credentials provided are valid and have necessary permissions.
    • Network connectivity problems: Confirm that the n8n instance can reach the Valeia API endpoint.
  • Error messages:

    • If the API returns an error, it will be thrown as a node operation error unless "Continue On Fail" is enabled, in which case the error message is included in the output JSON under the error property.
    • Typical errors might include invalid webhook URL format, unauthorized access, or server errors from the Valeia API.

Links and References

Discussion