Skip to main content

​
Event: session_complete

Sent after the call ends and the transcript, summary, and insights are processed.

​
Payload

{
  "event": "session_complete",
  "transcript_id": "string | null",
  "room_id": "string | null",
  "room_name": "string",
  "duration_seconds": 1234,
  "transcript_text": "Full transcript text",
  "summary": "Summary text",
  "exit_reason": "participant_left | stop_phrase | force_leave | idle_timeout",
  "insights": {
    "summary": "...",
    "overall_score": 8,
    "strengths": ["..."],
    "weaknesses": ["..."]
  },
  "insights_error": "string | null"
}

​
Exit Reasons

Exit ReasonDescription
participant_leftThe user left the room, and the bot was the only remaining participant
stop_phraseThe bot detected the configured stop phrase in the conversation and exited
force_leaveThe bot was forcefully stopped via API (POST /v1/bot/{bot_id}/stop)
idle_timeoutThe bot exited due to inactivity (no audio activity for 5 minutes)
Notes:
  • transcript_text is used in webhook payloads (the REST status endpoint returns the transcript as transcript).
  • insights is omitted if insight generation is disabled or fails.
  • insights_error is included only when insight processing fails.
  • exit_reason is included when available (always present for normal completions).

​
Event: bot_join_failed

Sent when a bot fails to join a Daily.co room (e.g., room not found, authentication error).

​
Payload

{
  "event_type": "bot_join_failed",
  "workflow_thread_id": "string",
  "room_url": "https://lunchpaillabs.daily.co/room-name",
  "error_type": "room_not_found | auth_error | unknown",
  "error_message": "Detailed error message from Daily.co",
  "timestamp": "2026-01-12T17:21:30.092034+00:00",
  "duration_seconds": 2
}

​
Error Types

Error TypeDescription
room_not_foundThe Daily.co room doesn’t exist (404 error)
auth_errorAuthentication failed when joining the room
unknownOther errors (network issues, rate limiting, etc.)
Notes:
  • duration_seconds is how long the bot attempted to join before failing.
  • Configure webhooks by passing webhook_callback_url when creating or starting a bot.