Documentation

Getting Started

This guide takes you from zero to your first live call: get an API key, authenticate with REST, create an agent, and place a call. It should take about five minutes.

Prerequisites

  • A Blutec Echo account. Create one if you haven't yet.
  • Any HTTP client — cURL, Postman, or your language's fetch/HTTP library.
  • A phone number in your workspace to use as caller ID — see the Numbers Shop guide.

1. Get your API key

Log in and open API Access. Create a key and copy it — it is shown once. Use this key to authenticate every API request.

2. Authenticate

Send your API key on every request as a Bearer token. Keep it secret — store it in an environment variable and never commit it to version control. Base URL: https://bkecho.blutec.ai.

cURL
# Every REST request sends your API key as a Bearer token
curl -X GET "https://bkbharatai.blutec.ai/api/agents" \
  -H "Authorization: Bearer be_your_api_key_here" \
  -H "Content-Type: application/json"

See Authentication for headers, errors, and endpoint conventions.

3. Create your first agent

An agent defines how the AI speaks and what it tries to accomplish. Start with a name, a welcome message, and a couple of flow steps. For voice, LLM, transcription, filler phrases, and every other option, see the Agent API.

cURL
curl -X POST "https://bkbharatai.blutec.ai/api/agents/create" \
  -H "Authorization: Bearer be_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My First Agent",
    "welcome_message": "Hi! Thanks for taking my call. How are you today?",
    "context_breakdown": [
      {"title": "Introduction", "body": "Introduce yourself and why you are calling.", "is_enabled": true},
      {"title": "Close", "body": "Confirm next steps and thank them.", "is_enabled": true}
    ],
    "languages": ["en"]
  }'

Save the id from the response — you need it to place calls and update the agent.

4. Make your first call

Dispatch an outbound call from your agent to any number. Use a phone number from your workspace as the caller ID. Track results with the Call API.

cURL
curl -X POST "https://bkbharatai.blutec.ai/api/calls/dispatch" \
  -H "Authorization: Bearer be_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "ag_123",
    "to_number": "+15551234567",
    "from_number_id": "pn_123"
  }'

Next steps

  • Agent API — configure voice, LLM, transcription, filler phrases, idle handling, and post-call webhooks.
  • Conversational Flow — design multi-step call scripts.
  • Bulk Call — run outbound campaigns to a list of contacts.
  • Integrations — let agents call your APIs or book meetings.