Docs - AI phone agents for SMB

# Get call logs for an agent
curl "https://api.telzino.com/v1/agents/123e4567-e89b-12d3-a456-426614174000/call-logs?page=1&limit=50" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "data": [
    {
      "id": "log-123e4567-e89b-12d3-a456-426614174000",
      "agent_id": "123e4567-e89b-12d3-a456-426614174000",
      "room_name": "sipRoom-_123e4567-e89b-12d3-a456-426614174000_1704067800",
      "transcript_text": "[0.50s] agent: Hello! How can I help you today?\n[3.20s] user: I have a question about my order.\n[5.10s] agent: I'd be happy to help with your order. What's your order number?",
      "transcript_json": [
        {
          "text": "Hello! How can I help you today?",
          "speaker": "agent",
          "timestamp": 0.5,
          "is_partial": false,
          "created_at": 0.5
        },
        {
          "text": "I have a question about my order.",
          "speaker": "user",
          "timestamp": 3.2,
          "is_partial": false,
          "created_at": 3.2
        },
        {
          "text": "I'd be happy to help with your order. What's your order number?",
          "speaker": "agent",
          "timestamp": 5.1,
          "is_partial": false,
          "created_at": 5.1
        }
      ],
      "entry_count": 15,
      "call_duration": 180,
      "call_started_at": "2024-01-15T14:30:00.000Z",
      "call_ended_at": "2024-01-15T14:33:00.000Z",
      "session_data": {
        "room_name": "sipRoom-_123e4567...",
        "agent_id": "123e4567-e89b-12d3-a456-426614174000",
        "total_entries": 15,
        "final_entries": 15,
        "caller_id": "+14155551234"
      },
      "summary_text": "Order Status Inquiry\n\nCustomer called to check on order #12345. Agent confirmed the order was shipped and provided tracking number.\n\n**Action Items:**\n- ✓ Provided tracking number to customer\n- None pending\n\n**Sentiment:** Positive",
      "recording_url": "https://telzino-recordings.s3.amazonaws.com/calls/123e4567.ogg",
      "created_at": "2024-01-15T14:33:05.000Z",
      "updated_at": "2024-01-15T14:33:10.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 245,
    "totalPages": 5,
    "hasNext": true,
    "hasPrev": false
  }
}

GET

agents

{agentId}

call-logs

# Get call logs for an agent
curl "https://api.telzino.com/v1/agents/123e4567-e89b-12d3-a456-426614174000/call-logs?page=1&limit=50" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "data": [
    {
      "id": "log-123e4567-e89b-12d3-a456-426614174000",
      "agent_id": "123e4567-e89b-12d3-a456-426614174000",
      "room_name": "sipRoom-_123e4567-e89b-12d3-a456-426614174000_1704067800",
      "transcript_text": "[0.50s] agent: Hello! How can I help you today?\n[3.20s] user: I have a question about my order.\n[5.10s] agent: I'd be happy to help with your order. What's your order number?",
      "transcript_json": [
        {
          "text": "Hello! How can I help you today?",
          "speaker": "agent",
          "timestamp": 0.5,
          "is_partial": false,
          "created_at": 0.5
        },
        {
          "text": "I have a question about my order.",
          "speaker": "user",
          "timestamp": 3.2,
          "is_partial": false,
          "created_at": 3.2
        },
        {
          "text": "I'd be happy to help with your order. What's your order number?",
          "speaker": "agent",
          "timestamp": 5.1,
          "is_partial": false,
          "created_at": 5.1
        }
      ],
      "entry_count": 15,
      "call_duration": 180,
      "call_started_at": "2024-01-15T14:30:00.000Z",
      "call_ended_at": "2024-01-15T14:33:00.000Z",
      "session_data": {
        "room_name": "sipRoom-_123e4567...",
        "agent_id": "123e4567-e89b-12d3-a456-426614174000",
        "total_entries": 15,
        "final_entries": 15,
        "caller_id": "+14155551234"
      },
      "summary_text": "Order Status Inquiry\n\nCustomer called to check on order #12345. Agent confirmed the order was shipped and provided tracking number.\n\n**Action Items:**\n- ✓ Provided tracking number to customer\n- None pending\n\n**Sentiment:** Positive",
      "recording_url": "https://telzino-recordings.s3.amazonaws.com/calls/123e4567.ogg",
      "created_at": "2024-01-15T14:33:05.000Z",
      "updated_at": "2024-01-15T14:33:10.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 245,
    "totalPages": 5,
    "hasNext": true,
    "hasPrev": false
  }
}

Path Parameters

agentId

string

required

The agent ID to retrieve call logs for (UUID format)

Query Parameters

page

integer

default:"1"

Page number for pagination (1-indexed)

limit

integer

default:"50"

Number of items per page (max 100)

# Get call logs for an agent
curl "https://api.telzino.com/v1/agents/123e4567-e89b-12d3-a456-426614174000/call-logs?page=1&limit=50" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "data": [
    {
      "id": "log-123e4567-e89b-12d3-a456-426614174000",
      "agent_id": "123e4567-e89b-12d3-a456-426614174000",
      "room_name": "sipRoom-_123e4567-e89b-12d3-a456-426614174000_1704067800",
      "transcript_text": "[0.50s] agent: Hello! How can I help you today?\n[3.20s] user: I have a question about my order.\n[5.10s] agent: I'd be happy to help with your order. What's your order number?",
      "transcript_json": [
        {
          "text": "Hello! How can I help you today?",
          "speaker": "agent",
          "timestamp": 0.5,
          "is_partial": false,
          "created_at": 0.5
        },
        {
          "text": "I have a question about my order.",
          "speaker": "user",
          "timestamp": 3.2,
          "is_partial": false,
          "created_at": 3.2
        },
        {
          "text": "I'd be happy to help with your order. What's your order number?",
          "speaker": "agent",
          "timestamp": 5.1,
          "is_partial": false,
          "created_at": 5.1
        }
      ],
      "entry_count": 15,
      "call_duration": 180,
      "call_started_at": "2024-01-15T14:30:00.000Z",
      "call_ended_at": "2024-01-15T14:33:00.000Z",
      "session_data": {
        "room_name": "sipRoom-_123e4567...",
        "agent_id": "123e4567-e89b-12d3-a456-426614174000",
        "total_entries": 15,
        "final_entries": 15,
        "caller_id": "+14155551234"
      },
      "summary_text": "Order Status Inquiry\n\nCustomer called to check on order #12345. Agent confirmed the order was shipped and provided tracking number.\n\n**Action Items:**\n- ✓ Provided tracking number to customer\n- None pending\n\n**Sentiment:** Positive",
      "recording_url": "https://telzino-recordings.s3.amazonaws.com/calls/123e4567.ogg",
      "created_at": "2024-01-15T14:33:05.000Z",
      "updated_at": "2024-01-15T14:33:10.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 245,
    "totalPages": 5,
    "hasNext": true,
    "hasPrev": false
  }
}

Call Log Object

Core Fields

Field	Type	Description
`id`	string	Unique call log identifier (UUID)
`agent_id`	string	Agent that handled the call
`room_name`	string	Room identifier for the call

Transcript Data

Field	Type	Description
`transcript_text`	string	Plain text version with timestamps (e.g., `[0.50s] agent: Hello!`)
`transcript_json`	array	Structured transcript entries (see below)
`entry_count`	integer	Total number of transcript entries
`summary_text`	string	AI-generated summary of the call (Markdown format)

transcript_json entry structure:

{
  "text": "Message content",
  "speaker": "agent" | "user" | "system",
  "timestamp": 0.5,
  "is_partial": false,
  "created_at": 0.5
}

System entries are logged for events like call transfers, webhook executions, and call end reasons.

Call Timing

Field	Type	Description
`call_duration`	integer	Call duration in seconds
`call_started_at`	datetime	When the call started (ISO 8601)
`call_ended_at`	datetime	When the call ended (ISO 8601)

Session Metadata

Field	Type	Description
`session_data`	object	Additional session information
`session_data.caller_id`	string	Caller’s phone number (e.g., `+14155551234`)
`session_data.total_entries`	integer	Total transcript entries (including partials)
`session_data.final_entries`	integer	Final (non-partial) transcript entries

Recording

Field	Type	Description
`recording_url`	string	URL to call recording (if `enable_recording` was true)

Recording URLs are pre-signed S3 URLs. They may expire after a period of time. Store recordings in your own storage if you need permanent access.

Timestamps

Field	Type	Description
`created_at`	datetime	When the log was created
`updated_at`	datetime	When the log was last updated

AI Summary Format

The summary_text field contains an AI-generated summary in Markdown format:

Topic in 3-5 words

1-2 sentence summary of the call.

**Action Items:**
- ✓ Completed action
- Pending follow-up

**Sentiment:** Positive | Neutral | Negative

List STT Providers Get Call Recording

​Path Parameters

​Query Parameters

​Call Log Object

​Core Fields

​Transcript Data

​Call Timing

​Session Metadata

​Recording

​Timestamps

​AI Summary Format

Path Parameters

Query Parameters

Call Log Object

Core Fields

Transcript Data

Call Timing

Session Metadata

Recording

Timestamps

AI Summary Format