Cortex Trigger icon

Cortex Trigger

Recebe eventos do Cortex via webhook: mensagens, atualizações de prompt e atribuições de conversa.

Cortex Trigger

AI-generated

Summary

Receive and react to Cortex events via webhook for new messages, agent prompt updates, and conversation assignments, filtered and routed based on configuration.

Inputs

  • Webhook Secret (required) — A secret token used to validate incoming webhook requests. It authenticates the webhook both during setup verification (GET requests) and event reception (POST requests with Bearer token).
  • Events — Select which Cortex events to listen for: 'All Events' to receive all, or specific ones like 'New Message', 'Agent Prompt Updated', and 'Conversation Assigned'. Only matching events trigger the workflow continuation.
  • Saída separada para Prompt Atualizado — Boolean flag that, if enabled, outputs agent prompt update events ('agent_prompt_updated') through a dedicated output separate from the main messages output.
  • Saída separada para Conversa Atribuída — Boolean flag that, if enabled, outputs conversation assignment events ('ai_assignment') through a dedicated output separate from the main messages output.

Output shape

One or more distinct output streams depending on configuration: always includes the main output for new messages and other not separately routed events; optionally includes dedicated outputs for prompt updates and conversation assignments.

The node listens on a webhook path requiring GET requests to validate the webhook using the secret token, and POST requests that carry event data. Incoming events are filtered based on the selected Events parameter. When separate outputs for prompt updates or assignments are enabled, these events are routed to their respective outputs; all other selected events flow to the main output. If event filtering excludes an incoming event, it is acknowledged but not passed onward. Authorization errors or invalid webhook verification tokens respond with HTTP 401/403 as appropriate.

Examples

Example 1: Reacting only to new messages with a single output

Set 'Webhook Secret' to your shared token, choose 'New Message' in Events, leave other outputs disabled. The main output will receive only new message events.

Example 2: Handling prompt updates and conversation assignments via separate outputs

Set 'Webhook Secret', choose 'All Events' or specific events including 'agent_prompt_updated' and 'ai_assignment', enable separate outputs for prompt updated and assignment. The node creates multiple outputs to route each event type accordingly.

Links

Discussion