Skip to main content
WEBHOOK
session.started
{
  "type": "session.started",
  "idempotencyKey": "<string>",
  "data": {
    "id": "<string>",
    "createdAt": "2023-12-25T00:00:00.000Z",
    "updatedAt": "2023-12-25T00:00:00.000Z",
    "name": "<string>",
    "type": "INBOUND_CALL",
    "status": "PENDING",
    "completedAt": "2023-12-25T00:00:00.000Z",
    "lastHeartbeatAt": "2023-12-25T00:00:00.000Z",
    "startedAt": "2023-12-25T00:00:00.000Z",
    "endedAt": "2023-12-25T00:00:00.000Z",
    "recordAudio": true,
    "isDemo": true,
    "agentId": "<string>",
    "agentVersionId": "<string>",
    "workspaceId": "<string>",
    "personId": "<string>",
    "conversationId": "<string>",
    "conversation": {
      "id": "<string>",
      "createdAt": "2023-12-25T00:00:00.000Z",
      "updatedAt": "2023-12-25T00:00:00.000Z",
      "workspaceId": "<string>",
      "personId": "<string>",
      "name": "<string>",
      "isDemo": true,
      "lastViewedAt": "2023-12-25T00:00:00.000Z",
      "lastViewedBy": "<string>",
      "lastSessionEndedAt": "2023-12-25T00:00:00.000Z",
      "archivedAt": "2023-12-25T00:00:00.000Z",
      "archivedBy": "<string>"
    },
    "person": {
      "id": "<string>",
      "createdAt": "2023-12-25T00:00:00.000Z",
      "updatedAt": "2023-12-25T00:00:00.000Z",
      "workspaceId": "<string>",
      "properties": {},
      "firstSeenAt": "2023-12-25T00:00:00.000Z",
      "lastSeenAt": "2023-12-25T00:00:00.000Z",
      "identifiedAt": "2023-12-25T00:00:00.000Z",
      "deletedAt": "2023-12-25T00:00:00.000Z",
      "email": "[email protected]",
      "phone": "<string>",
      "rootPersonId": "<string>",
      "mergedBy": "<string>",
      "mergedAt": "2023-12-25T00:00:00.000Z",
      "mergeMeta": {}
    },
    "agent": {
      "id": "<string>",
      "createdAt": "2023-12-25T00:00:00.000Z",
      "updatedAt": "2023-12-25T00:00:00.000Z",
      "createdBy": "<string>",
      "updatedBy": "<string>",
      "workspaceId": "<string>",
      "publishedVersionId": "<string>",
      "name": "<string>",
      "description": "<string>",
      "slug": "<string>",
      "status": "DRAFT",
      "sourceTemplateId": "<string>",
      "archivedBy": "<string>",
      "completedBy": "<string>",
      "publishedBy": "<string>",
      "version": {
        "id": "<string>",
        "createdAt": "2023-12-25T00:00:00.000Z",
        "updatedAt": "2023-12-25T00:00:00.000Z",
        "createdBy": "<string>",
        "updatedBy": "<string>",
        "agentId": "<string>",
        "version": -1,
        "workspaceId": "<string>",
        "sourceAgentVersionId": "<string>",
        "themeId": "<string>",
        "incentiveType": "CASH",
        "incentiveAmount": 500050,
        "incentiveCurrencyCode": "USD",
        "maxParticipants": -1,
        "length": "FIVE_MINUTES",
        "languages": [
          "en"
        ],
        "inputMode": [
          "SMS"
        ],
        "knowledgeBaseId": "<string>",
        "followUp": true,
        "limitToKnowledgeBase": true,
        "timezone": "<string>",
        "authentication": "NONE",
        "systemPrompt": "<string>",
        "agentFlowId": "<string>",
        "config": {
          "llm": {
            "provider": "OPENAI",
            "model": "GPT_4O",
            "temperature": 1
          },
          "tts": {
            "provider": "CARTESIA",
            "model": "SONIC_2",
            "voiceId": "<string>"
          },
          "stt": {
            "provider": "DEEPGRAM",
            "model": "NOVA_3"
          }
        }
      },
      "archivedAt": "2023-12-25T00:00:00.000Z",
      "completedAt": "2023-12-25T00:00:00.000Z",
      "publishedAt": "2023-12-25T00:00:00.000Z"
    },
    "messages": [
      {
        "id": "<string>",
        "createdAt": "2023-12-25T00:00:00.000Z",
        "updatedAt": "2023-12-25T00:00:00.000Z",
        "workspaceId": "<string>",
        "conversationId": "<string>",
        "sessionId": "<string>",
        "personId": "<string>",
        "sequenceNumber": -1,
        "content": {
          "role": "user",
          "content": "<string>"
        },
        "languageCode": "<string>",
        "extraMetadata": {
          "toolName": "<string>",
          "arguments": "<string>",
          "output": "<string>",
          "status": "success",
          "startTime": 123,
          "endTime": 123,
          "traceId": "<string>",
          "spanId": "<string>"
        }
      }
    ],
    "completedMeta": {
      "traceId": "<string>"
    }
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
type
enum<string>
required
Available options:
session.started
idempotencyKey
string<cuid2>
required
data
object
required

Response

200

Accepted