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

https://api.telzino.com

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

Set SIP Registration Resellers

⌘I

API Reference

Agents

Call Logs

Organizations

Sessions

Billing

List Call Logs

Path Parameters

Query Parameters

Call Log Object

Core Fields

Transcript Data

Call Timing

Session Metadata

Recording

Timestamps

AI Summary Format

API Reference

Agents

Call Logs

Organizations

Sessions

Billing

​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