ToldGuard Aggregation Trigger icon

ToldGuard Aggregation Trigger

Starts a workflow when a ToldGuard aggregator-only instance emits a ready batch

ToldGuard Aggregation Trigger

AI-generated

Summary

Receives POST callbacks from a ToldGuard aggregator-only instance when a batch is ready, then starts the workflow with a normalized payload. Optionally verifies the callback signature using ToldGuard’s signing secret.

Inputs

  • Signing Secret — Optional output webhook secret from ToldGuard. When set, the node checks the x-toldguard-timestamp and x-toldguard-signature headers against an HMAC-SHA256 signature of the timestamp and request body; missing or invalid signature headers cause an error. Configure the production webhook URL from this node as the aggregator instance’s output webhook.

Output shape

A single item containing the normalized callback payload.

The item includes event, tenant_id, batch_id, conversation_id, message_count, consolidated_text, created_at, updated_at, raw_payload_common, messages, a toldguard metadata object, request headers and query, and the original body under raw. Missing fields receive defaults; event defaults to aggregation.ready, and message_count defaults to the number of messages. The webhook responds with HTTP 200 when received.

Links

Discussion