LeadVoice — Voice Assessment API by BotBrained

Voice assessments for your
lead pipeline — via API

One API call creates a session. Candidate speaks. You get scores, transcript, and a recommendation — delivered to your webhook.

# Create an assessment session
curl -X POST https://leadvoice.botbrained.com/api/v1/sessions \
  -H "Authorization: Bearer lv_sk_your_key" \
  -d '{
    "bot_id":   "your-bot-uuid",
    "client_ref": "lead-001",
    "context": {
      "name":   "Rahul Sharma",
      "course": "MBA"
    }
  }'

# Response
{
  "assessment_url": "https://leadvoice.botbrained.com/assess?t=…",
  "session_id":     "uuid"
}

From lead to scored — in minutes

LeadVoice plugs into any lead pipeline. No frontend code required on your end.

Configure your bot

Write a system prompt in the admin UI. Set voice, language, and webhook. Use ${name} or ${course} for dynamic context.

Create a session via API

POST to /api/v1/sessions with your API key, bot ID, and any lead context. Get back a secure, time-limited assessment URL.

Candidate completes assessment

Send the URL to the candidate — via WhatsApp, email, or SMS. They open it in any browser, pick their language, and speak.

Results to your webhook

When done, LeadVoice POSTs the transcript, scores (1–10), and a Hot/Warm/Cold recommendation to your endpoint — signed with HMAC-SHA256.

Built for production pipelines

Everything you need to run voice assessments at scale.

Gemini Live voice

Powered by Google Gemini Live API. Natural, low-latency conversation in 18+ languages. Configurable voice and model per bot.

Fully configurable bots

Set the system prompt, persona name, voice, languages, and analysis model from the admin UI — no code deployment needed.

Opaque, time-limited URLs

Assessment tokens are cryptographically random and never expose session IDs. Set expiry from 1 hour to 30 days.

Signed webhooks with retry

Results delivered via HMAC-SHA256 signed POST. Automatic retry up to 5 times over an hour if your endpoint is down.

Multi-tenant API keys

Generate multiple API keys per org, scoped to a specific bot. Revoke instantly from the admin UI. Keys are SHA-256 hashed — never stored in plaintext.

Usage & analytics

Sessions per day, completion rates, score distributions, and Hot/Warm/Cold breakdowns — all in the admin dashboard.

Bot knows who it's talking to

Pass lead data when creating a session. The bot's system prompt gets those values before the first word is spoken.

Greet candidates by name from the first sentence

Reference the course, role, or product they applied for

Tailor questions based on source, city, or budget

Any flat key-value pair — strings or numbers

# In your system prompt: You are speaking with ${name}. They applied for the ${course} program in ${city}. Their budget is ${budget}. Open by greeting them warmly... # In your API call: { "bot_id": "...", "context": { "name": "Rahul Sharma", "course": "MBA", "city": "Mumbai", "budget": "50000" } }