Core Concepts

Assistants

An Assistant is your AI voice agent. It combines:
  • An LLM (the brain — GPT-4o, Llama, Claude, etc.)
  • A Voice (TTS — how it sounds)
  • A Transcriber (STT — how it hears)
  • A System Prompt (personality and instructions)
  • A Language Wrapper (optional — for African language support)
Assistants start as drafts and become published when synced to the voice engine.

Phone Numbers

Phone numbers are how callers reach your assistant. They come from a pre-configured admin pool and are purchased with credits. A phone number can be linked to one assistant (or one squad) at a time.

Linking

Linking connects a published assistant to an active phone number. When linked:
  • Incoming calls to that number route to your assistant
  • A SIP endpoint is created behind the scenes
  • The assistant handles the call end-to-end

Language Wrappers

Language wrappers are pre-built prompt prefixes that instruct your assistant to respond in a specific African language. They handle:
  • Language preference
  • Noisy transcription recovery
  • Code-switching (when callers switch languages)
  • Speech-friendly output

Squads

A Squad groups multiple assistants together for complex call flows. Squads support:
  • Sequential routing — assistants handle calls in order
  • Parallel routing — multiple assistants available simultaneously
  • Conditional routing — route based on caller intent

Publishing

Publishing syncs your assistant configuration to the voice AI engine (Vapi). Only published assistants can receive calls.

Credits

Credits are your account balance used for:
  • Phone number purchases (one-time buy fee + monthly fee)
  • Per-minute call usage
  • All costs are shown in your local currency

Organization

Your organization is the billing and access boundary. All assistants, phone numbers, and squads belong to an organization.