Skip to main content

​
Usage

This page explains how to use Burki Voice AI as an end user, admin, or developer.

​
Web Dashboard

The web dashboard at burki.dev/dashboard is the main interface for managing your voice AI system.

​
Common Tasks

  • Log in with your credentials or Google account
  • Create or edit assistants: Set up personalities, assign phone numbers, and configure integrations
  • View call history: Access transcripts, recordings, and analytics
  • Manage billing: Add funds, view usage, and configure auto top-up
  • Manage team: Add team members, set roles, and manage permissions

​
Phone Call Flow

Burki handles real phone calls through your configured telephony provider.

​
Inbound Call Flow

  1. Customer calls your number assigned to an assistant
  2. Burki answers and plays the greeting message
  3. Real-time transcription converts speech to text
  4. AI generates response based on the conversation context
  5. Text-to-speech converts the response to natural speech
  6. Customer hears response with sub-second latency
  7. Call is recorded and available in the dashboard

​
Outbound Call Flow

  1. API request triggers an outbound call
  2. Burki dials the target number
  3. Same conversation flow once connected
  4. Webhook notification sent with call status

​
API Usage

Burki exposes a RESTful API for programmatic access.

​
Authentication

All API requests require a Bearer token: 
curl -X GET "https://api.burki.dev/api/v1/assistants/" \
     -H "Authorization: Bearer YOUR_API_KEY"

​
Common Operations

GET /api/v1/assistants/

POST /api/v1/assistants/
Content-Type: application/json

{
  "name": "Support Bot",
  "llm_provider": "openai",
  "llm_model": "gpt-4o"
}

GET /api/v1/calls/

POST /api/v1/messaging/sms/send
Content-Type: application/json

{
  "to": "+1234567890",
  "from": "+0987654321",
  "body": "Hello from Burki!"
}
For the complete API reference, see API Reference.

​
User Roles

​
Admin

  • Set up organization and billing
  • Invite and manage team members
  • Configure all assistants
  • Access all analytics and reports

​
Member

  • Create and manage assigned assistants
  • View call history and transcripts
  • Configure phone numbers

​
Viewer

  • View dashboards and analytics
  • Listen to call recordings
  • Read transcripts

​
Live Monitoring

​
Live Transcript

Watch calls in real-time:
  1. Go to Calls → Live
  2. Select an active call
  3. See transcript updates as they happen

​
Analytics Dashboard

Monitor key metrics:
  • Total calls (today, this week, this month)
  • Average call duration
  • Success rate
  • Cost breakdown

​
Next Steps

Configuration

Detailed configuration options

API Reference

Full API documentation