ai-agents
ai-agents

Preview Triggers

Read-only "which agent fires here" preview.

Mirrors the trigger-router's matching logic without writing to ai_agent_activity_log and without executing any agent. Returns every candidate in evaluation order plus the skipped triggers with reasons — drives the panel on /ai-agents, the per-card footer on /livechat, and the per-thread modal in chat.

Three event_kinds in v1:

  • incoming_call: ring-time pickup. Calls preview_pickup_matches which mirrors resolve_voice_pickup_trigger. channel_type MUST be a voice channel.
  • incoming_message: any new message (text DM or transcript turn). Calls preview_message_matches via _match_triggers.
  • blockchain: blockchain transfer event. Same path as incoming_message with a synthesized blockchain event_type.

Returns 400 on missing required inputs (see slugs below). Empty matched=[] is a valid response (e.g. workspace has zero blockchain triggers).

post/api/ai-agents/triggers/preview

Request

  • Base URL: https://api.dialogbrain.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.dialogbrain.com/api/ai-agents/triggers/preview
  • Auth: none declared

Request body

event_kind'incoming_call' | 'incoming_message' | 'blockchain' required
channel_typestring nullable
channel_account_idinteger nullable
thread_idinteger nullable
thread_kind'dm' | 'group' | 'channel' | 'livechat' | 'voice_call' nullable
message_textstring nullable
from_idstring nullable
blockchain_tx_dataobject nullable

Response

Successful Response

unsimulated_gatesstring[] required

Changes

No recorded changes to this operation across all 5 revisions of this API.