yuvraj3335 Truto Webhook Workflow Debugger
Mission
Build an event timeline from configuration, logs, and run records. Identify whether the issue is missing trigger, disabled config, payload/condition mismatch, delivery failure, provider/API failure, or runtime error.
Inputs
Use profile, webhook ID, workflow ID, workflow run ID, notification destination ID, account ID, event name, target URL, sync job run ID, and time window.
Webhooks
truto webhooks list -p "$PROFILE" -o json --no-color
truto webhooks get "$WEBHOOK_ID" -p "$PROFILE" -o json --no-color
truto logs --log-type webhook --webhook-id "$WEBHOOK_ID" --start "$START" --end "$END" --limit 100 -p "$PROFILE" -o json --no-color
For sync job delivery:
truto logs --log-type rapid_bridge --webhook-id "$WEBHOOK_ID" --start "$START" --end "$END" --limit 100 -p "$PROFILE" -o json --no-color
truto sync-job-runs get "$SYNC_JOB_RUN_ID" -p "$PROFILE" -o json --no-color
Workflows
truto workflows list -p "$PROFILE" -o json --no-color
truto workflows get "$WORKFLOW_ID" -p "$PROFILE" -o json --no-color
truto workflow-runs list --workflow-id "$WORKFLOW_ID" --status "$STATUS" -p "$PROFILE" -o json --no-color
truto workflow-runs get "$WORKFLOW_RUN_ID" -p "$PROFILE" -o json --no-color
Notifications
truto notification-destinations list -p "$PROFILE" -o json --no-color
truto notification-destinations get "$DESTINATION_ID" -p "$PROFILE" -o json --no-color
Test Policy
These send external events. Run only after explicit approval:
truto webhooks test --id "$WEBHOOK_ID" -p "$PROFILE" -o json --no-color
truto notification-destinations test --id "$DESTINATION_ID" -p "$PROFILE" -o json --no-color
Diagnosis
- Config is active and target URL/destination is correct.
- Expected event name exists and matches filters/conditions.
- Logs show whether an event was created, attempted, retried, delivered, or rejected.
- Delivery failure includes status code and response summary.
- Workflow run failed due to condition mismatch, step config, provider/API call, or runtime error.
- Sync job finished and produced destination payload before webhook delivery was expected.
Output
Return event timeline, missing or failing stage, evidence, whether a safe test is allowed, and next fix.