Integrate Telvoi into
Your Own Systems

Connect your call data to your CRM, e-commerce platform, or custom software with REST API and Webhook support.

API Reference

All requests are made via https://api.telvoi.com/v1 base URL. Authentication via Bearer token.

List Users

# GET /users — List all users
curl -X GET \
  https://api.telvoi.com/v1/users \
  -H "Authorization: Bearer {API_KEY}" \
  -H "Content-Type: application/json"

# Success response (200 OK)
{
  "data": [
    {
      "id": "usr_abc123",
      "name": "John Smith",
      "extension": 101,
      "status": "online"
    }
  ],
  "total": 8
}

Configure Webhook

# POST /webhooks — Register webhook endpoint
curl -X POST \
  https://api.telvoi.com/v1/webhooks \
  -H "Authorization: Bearer {API_KEY}" \
  -d '{
    "url": "https://your-server.com/hook",
    "events": [
      "call.started",
      "call.answered",
      "call.ended",
      "call.missed"
    ]
  }'

# Telvoi will POST to this URL:
{
  "event": "call.started",
  "call_id": "cdr_222",
  "from": "+15001234567",
  "timestamp": "2026-05-19T13:45:00Z"
}

Supported Events

EventDescriptionUse Case
call.startedTriggered when a call startsCRM popup, open customer record
call.answeredTriggered when a call is answeredCreate ticket, start timer
call.endedTriggered when a call endsSave CDR, add note to CRM
call.missedTriggered on missed callSend Slack/email notification
user.statusTriggered when user status changesUpdate dashboard, shift tracking

Quick Start

Node.js / JavaScript

Integration in minutes with npm package. TypeScript support included.

npm install @telvoi/sdk

Python

PyPI package. Quickly add to your Django, FastAPI or Flask project.

pip install telvoi

REST (Any Language)

Standard HTTP REST API. Download our Postman collection and test immediately.

Download Postman Collection

Need Integration Support?

Our technical team accompanies you throughout your integration process.