Getting Started

​

Overview

Burki separates account and organization setup from assistant configuration. Your organization owns billing, team members, shared phone numbers, and assistant resources. Each assistant then chooses telephony, speech-to-text, reasoning, and text-to-speech providers, plus optional tools, webhooks, and knowledge sources. This guide walks through creating the org, inviting collaborators, and selecting managed versus bring-your-own provider modes so you can standardize patterns across teams without re-implementing telephony or streaming audio. Expect to spend most of your time on provider credentials, model selection, and call behavior—not on wiring raw carrier APIs. When you are ready to automate provisioning, use the REST API and webhooks documented in the API reference.

---

​

Account Setup

​

Creating Your Organization

When you sign up for Burki, an organization is automatically created for you. Organizations help you:

• Manage multiple assistants under one account
• Invite team members with different roles
• Track usage and billing across all assistants
• Share resources like phone numbers and knowledge bases

​

Adding Team Members

1. Go to Settings → Team
2. Click “Invite Member”
3. Enter their email and select a role:
   • Admin: Full access to all settings and billing
   • Member: Can create and manage assistants
   • Viewer: Read-only access to dashboards and analytics

---

​

Provider Configuration

Burki supports two modes for AI providers. You can use either mode or mix them.

​

Burki Cloud (Managed)

With Burki Cloud, we handle all provider integrations:

​

BYO (Bring Your Own Keys)

Use your own API keys for full control over costs:

​

Hybrid Mode

Mix BYO and Burki Cloud based on your needs:

---

​

Telephony Setup

​

Start with Browser Practice

Eligible new workspaces can practice an assistant in the browser before connecting a telephone number. Check your workspace’s allowance and follow the Quickstart. Browser trial time does not include a free telephone number; existing grants keep their own terms.

​

Purchasing Additional Numbers

1. Go to Phone Numbers → Purchase
2. Search by country, area code, or pattern
3. Compare prices across providers (Twilio, Vonage, Telnyx)
4. Click “Purchase” to add to your account

​

Bringing Your Own Numbers

If you have existing phone numbers with Twilio, Vonage, or Telnyx:

1. Go to Settings → Provider Keys
2. Add your telephony provider credentials
3. Go to Phone Numbers → Sync
4. Your numbers will appear and can be assigned to assistants

---

​

Wallet & Billing

​

Adding Funds

1. Go to Billing → Wallet
2. Click “Add Funds”
3. Enter the amount and complete payment via Stripe

​

Setting Up Auto Top-up

Never run out of credits:

1. Go to Billing → Auto Top-up
2. Set your threshold (e.g., when balance drops below $10)
3. Set your top-up amount (e.g., add $50)
4. Save your payment method

​

Funded Usage Readiness

Review the selected configuration’s quote and available balance in Usage & billing. Calls can reserve funds before starting, and provider usage can settle afterward. Browser trial time does not automatically turn into paid usage. Before directing customer traffic, resolve carrier and provider checks, publish the reviewed assistant version, and complete an authorized telephone test. An imported or assigned number alone does not establish readiness.

---

​

API Integration

If you’re integrating via API or SDK, you’ll need your API key:

---

​

Next Steps