Skip to main content

​
Overview

This document defines the event model.
All events in this document are append-only, immutable, and ordered by timestamp.

​
🔔 Webhook vs Internal Events (IMPORTANT)

Not all events are sent to Antler. We separate events into two categories:

​
1️⃣ Webhook Events (Sent to Antler)

Only the following events are pushed to the Antler webhook.
eventwhen it firespayload
submit_formFounder submits application + pitch deckFounder & pitch deck metadata
report_generatedConversation completed and report is generatedFull conversation payload
These events are business-critical and power Antler’s downstream workflows.

​
2️⃣ Internal Events (Tracking & Monitoring Only)

All other events are NOT sent to Antler. They are used internally for:
  • Funnel tracking
  • Debugging
  • Reliability monitoring
  • Conversation analytics
Examples: create_attempt, link_opened, candidate_ready, tracy_joined, face_detected, speech_detected, etc.

​
Webhook Payloads

Only the following events will be sent to Antler Webhook.

​
Event: submit_form

Triggered when the founder submits the pitch deck. 
{
  "event_name": "submit_form",
  "timestamp": "2025-12-09T14:10:00Z",
  "founder_first_name": "John",
  "founder_last_name": "Smith",
  "founder_name": "John Smith",
  "founder_email": "founder@startup.com",
  "founder_phone": "+84901234567",
  "founder_role": "CEO",
  "founder_linkedin": "https://linkedin.com/in/founder",
  "founder_current_location": "Ho Chi Minh City, Vietnam",
  "co_founders": {
    "co_founder_1": {
      "co_founder_first_name": "Jane",
      "co_founder_last_name": "Doe",
      "co_founder_role": "CTO",
      "co_founder_email": "jane@startup.com",
      "co_founder_linkedin": "https://linkedin.com/in/janedoe",
      "co_founder_phone": "+84901234568"
    },
    "co_founder_2": {
      "co_founder_first_name": "Alex",
      "co_founder_last_name": "Lee",
      "co_founder_role": "COO",
      "co_founder_email": "alex@startup.com",
      "co_founder_linkedin": "https://linkedin.com/in/alexlee",
      "co_founder_phone": "+84901234569"
    }
  },
  "tokenized_link": "https://antler.qode.world/interview/abc123",
  "pitch_deck_url": "https://storage.qode.ai/pitchdeck.pdf",
  "cohort": "SEA-AI-3"
}
The co_founders field is a dynamic object where each key (co_founder_1, co_founder_2, …) represents a co-founder. Each co-founder object contains: co_founder_first_name, co_founder_last_name, co_founder_role, co_founder_email, co_founder_linkedin, and co_founder_phone. This field is null if no co-founders are provided.

​
Event: report_generated

Triggered when the interview is completed and the report is ready. 
{
  "event_name": "report_generated",
  "founder_email": "founder@startup.com",
  "conversation_id": "uuid",
  "cohort": "SEA-AI-3",
  "timestamp": "2025-12-09T14:46:59Z",
  "conversation_data": {
    "conversation_id": "uuid",
    "date": "2025-12-09T14:00:00.000Z",
    "founder_first_name": "John",
    "founder_last_name": "Smith",
    "founder_name": "John Smith",
    "founder_email": "founder@startup.com",
    "founder_role": "CEO",
    "founder_phone": "+84901234567",
    "founder_linkedin": "https://linkedin.com/in/founder",
    "founder_current_location": "Ho Chi Minh City, Vietnam",
    "co_founders": {
      "co_founder_1": {
        "co_founder_first_name": "Jane",
        "co_founder_last_name": "Doe",
        "co_founder_role": "CTO",
        "co_founder_email": "jane@startup.com",
        "co_founder_linkedin": "https://linkedin.com/in/janedoe",
        "co_founder_phone": "+84901234568"
      },
      "co_founder_2": {
        "co_founder_first_name": "Alex",
        "co_founder_last_name": "Lee",
        "co_founder_role": "COO",
        "co_founder_email": "alex@startup.com",
        "co_founder_linkedin": "https://linkedin.com/in/alexlee",
        "co_founder_phone": "+84901234569"
      }
    },
    "tokenized_link": "https://antler.qode.world/interview/abc123",
    "cohort": "SEA-AI-3",
    "source": "Antler",
    "status": "COMPLETED",
    "ps_summary": "...",
    "cap_table": "...",
    "pitch_deck": "https://example.com/deck.pdf",
    "elevator_pitch": "...",
    "problem": "...",
    "solution": "...",
    "traction": "...",
    "commercial": "...",
    "market_size": "...",
    "why_now": "...",
    "competition": "...",
    "why_you": "...",
    "why_antler": "...",
    "fundraising_status": "...",
    "availability": "...",
    "passport_and_visa": "...",
    "video_url": "https://cdn.example.com/video.mp4",
    "transcript": "Tracy: Welcome!...\nFounder: Thanks..."
  }
}
This payload contains the entire conversation output, allowing Antler to:
  • Run evaluation pipelines
  • Store records
  • Trigger investment or screening workflows

​
Field Definitions

​
Core Identifiers

  • conversation_id Unique identifier for the conversation (unique for each attempt). Create a new conversation_id if the founder retries again.
  • founder_email Founder email address used for identification and notifications.

​
Event Metadata

  • event_name Canonical event name emitted by Qode (example: submit_form, report_generated).
  • timestamp UTC timestamp indicating when the event occurred.

​
Co-founders

The co_founders field is a dynamic object supporting multiple co-founders. Each co-founder is keyed as co_founder_1, co_founder_2, etc. Each co-founder object contains:
fieldtypedescription
co_founder_first_namestringFirst name of co-founder
co_founder_last_namestringLast name of co-founder
co_founder_rolestringRole of co-founder
co_founder_emailstringEmail of co-founder
co_founder_linkedinstringLinkedIn URL of co-founder
co_founder_phonestringPhone number of co-founder

​
Canonical Event Model

Each row represents a canonical event emitted during the conversation lifecycle.
eventdescriptionsent to Antler
submit_formFounder uploads a pitch deck and submits a form✅ Yes
create_interview_linkReturns a unique conversation link❌ No
link_openedCandidate opens the conversation link❌ No
create_attemptA new attempt starts❌ No
tracy_joinedAI interviewer joins the room❌ No
camera_permissionCamera permission requested, granted, or blocked❌ No
mic_permissionMicrophone permission requested, granted, or blocked❌ No
has_speaker_deviceSpeaker device detected❌ No
has_camera_deviceCamera detected❌ No
has_mic_deviceMicrophone detected❌ No
device_check_passedAll device permissions granted❌ No
device_check_failedDevice check failed (missing permissions or devices)❌ No
candidate_readyCandidate clicks Start❌ No
face_detectedFace detection status update❌ No
speech_detectedSpeech detection / warm-up status❌ No
first_questionFirst interview question begins❌ No
candidate_endCandidate finishes the interview❌ No
attempt_endTracy ends the interview❌ No
tracy_leftTracy leaves the room❌ No
abandonCandidate abandons the interview❌ No
expireInterview session expires (timeout)❌ No
connection_failureConnection failure detected❌ No
skip_generate_reportReport generation skipped❌ No
report_generatedInterview completed, report generated✅ Yes