Getting Started

Set up your Burki account and configure AI providers

This guide covers account setup and provider configuration. If you haven’t created an account yet, start with the Quickstart guide.

---

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:

1. Select Burki Cloud Mode

   When creating or editing an assistant, choose “Burki Cloud” for each provider section.

2. Choose Your Providers

   Select from available options:

   • LLM: OpenAI, Anthropic, Gemini, Groq, xAI
   • TTS: ElevenLabs, Cartesia, Deepgram, Resemble
   • STT: Deepgram
3. Configure Settings

   Customize model selection, voice options, and language settings.

Burki Cloud charges pass-through costs plus a 15% managed fee. Check the Pricing page for details.

BYO (Bring Your Own Keys)

Use your own API keys for full control over costs:

1. Get Your API Keys

   Sign up for accounts with your preferred providers:

   Provider	Sign Up URL
   OpenAI	platform.openai.com
   Anthropic	console.anthropic.com
   ElevenLabs	elevenlabs.io
   Deepgram	deepgram.com
   Cartesia	cartesia.ai

2. Add Keys to Burki

   Go to Settings → API Keys → Provider Keys and enter your credentials.

3. Select BYO Mode

   When configuring an assistant, choose “BYO” and select your connected provider.

Your API keys are encrypted and stored securely. We never share them or use them for anything other than making API calls on your behalf.

Hybrid Mode

Mix BYO and Burki Cloud based on your needs:

Service	Example Configuration
LLM	BYO (OpenAI) - You have negotiated enterprise pricing
TTS	Burki Cloud - Easier management of voice options
STT	Burki Cloud - Deepgram is optimized for phone audio

---

Telephony Setup

Using Your Trial Number

Every new account receives a trial phone number:

• Free for 30 days
• Automatically configured for voice calls
• US number by default (other countries available on request)

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

Phone numbers cost $1.00/month (prorated daily) and are billed to your wallet.

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

Auto top-up has a 5-minute cooldown to prevent duplicate charges during high-volume periods.

Minimum Balance Requirements

Mode	Minimum to Make Calls
BYO	$0.03
Burki Cloud	$2.00

---

API Integration

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

1. Get Your API Key

   Go to Settings → API Keys → Generate New Key

2. Store Securely

   Copy the key immediately - you won’t be able to see it again. Store it securely in your application’s configuration.

3. Make Requests

   Use the API base URL https://api.burki.dev with your key in the Authorization header.

Check out our SDKs for Python, JavaScript, and Go - they handle authentication and API calls for you.

---

Next Steps

AI Configuration

Deep dive into LLM, TTS, and STT settings

Telephony Providers

Configure Twilio, Vonage, or Telnyx

Tools & Custom Actions

Add call transfers, CRM lookups, and more

API Reference

Full API documentation