Woztell Trigger icon

Woztell Trigger

Handle events via webhooks

Overview

This node acts as a webhook trigger for Woztell events, allowing workflows to start when specific events occur in the Woztell platform. It listens for incoming HTTP POST requests on a configurable webhook path and processes event data sent by Woztell.

Common scenarios include:

  • Automating responses or actions based on messages or notifications received via Woztell.
  • Filtering events by channel or event type to trigger workflows only for relevant updates.
  • Integrating Woztell communication events into broader automation pipelines.

For example, you could use this node to start a workflow whenever a new message arrives in a particular Woztell channel or when a specific type of event occurs, such as a user joining a chat.

Properties

Name Meaning
Webhook Path The URL path segment where the webhook listens for incoming POST requests.
Event The type of event to listen for; currently only "Woztell Event" is supported.
Filter Fields Optional filters to restrict triggering:
- Channel ID Only trigger if the incoming event's channelId matches this value.
- Event Type Only trigger if the incoming event's eventType matches this value.

Output

The node outputs the JSON payload received from the webhook request under the json field. This payload represents the event data sent by Woztell.

If filter fields are set, the node validates that the incoming event matches these filters before outputting the data. If the event does not match, it throws an error and does not proceed.

No binary data output is produced by this node.

Dependencies

  • Requires an active HTTP endpoint accessible by Woztell to send webhook POST requests.
  • No external API keys or credentials are required within the node itself.
  • The webhook path must be correctly configured and publicly reachable for Woztell to deliver events.

Troubleshooting

  • Error: "ChannelId is not valid"
    Occurs when a channelId filter is set but the incoming event's channelId does not match. Verify the filter value and ensure the webhook receives events from the expected channel.

  • Error: "EventType is not valid"
    Happens when an eventType filter is set but the incoming event's eventType differs. Check the filter configuration and confirm the event types sent by Woztell.

  • Webhook not triggering
    Ensure the webhook URL (including the path) is correctly registered with Woztell and publicly accessible. Also, verify that Woztell is sending events to the correct URL.

  • No output despite receiving events
    Confirm that filter fields are either unset or correctly match the incoming event data.

Links and References

Discussion