Audatec Voice AI

A programmable outbound call platform that lets your application trigger AI-powered phone conversations at scale. One API call — your agent handles the rest.

How it works

Every call flows through three components:

• Agents — an AI persona with a script, voice, and expected input fields (e.g. customer_name, amount_due)
• SIP Trunks — carrier lines with concurrency limits assigned to your org
• Calls — a request that combines a phone number, an agent, a trunk, and per-call metadata

Base URL

https://api.audatec.in/integration/v1

Authentication

Every request to the API must include an API key in the Authorization header.

API Key Format

Using your key

Include your key in the Authorization header on every request:

Authorization: Bearer audtk_your_key_here

Getting a key

Generate API keys from the Audatec Dashboard:

1. Log in to studio.audatec.in
2. Navigate to Settings → Integration
3. Click New API Key, give it a name, and select a role
4. Copy the key immediately — it is shown only once

Key roles

Each key carries a role that controls what it can do:

Keys are org-scoped — a key authenticates as the organisation, not an individual user. All agents and trunks belonging to your org are accessible with a valid key.

Quick Start

Place your first AI call in three steps.

curl https://api.audatec.in/integration/v1/agents \
  -H "Authorization: Bearer $API_KEY"

curl https://api.audatec.in/integration/v1/sip-trunks \
  -H "Authorization: Bearer $API_KEY"

curl -X POST https://api.audatec.in/integration/v1/calls \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "+919876543210",
    "agent_id": "830f767a-397e-4b39-82ff-235cd344e2f9",
    "sip_trunk_id": "d5f3a1c0-8b2e-4f9a-b7d1-1e2c3a4b5c6d",
    "metadata": {
      "customer_name": "Rahul Sharma",
      "amount_due": "7500",
      "due_date": "2026-06-20"
    }
  }'

List Agents

Returns all active AI agents available to your organisation, including the metadata fields each agent requires.

Response — 200 OK

{
  "agents": [
    {
      "id": "830f767a-397e-4b39-82ff-235cd344e2f9",
      "name": "EMI Reminder Agent",
      "agent_code": "emi-reminder-v2",
      "status": "active",
      "input_schema": {
        "fields": ["customer_name", "amount_due", "due_date"],
        "sample_context": {
          "customer_name": "Rahul Sharma",
          "amount_due": "7500",
          "due_date": "2026-06-20"
        }
      }
    }
  ]
}

Response fields

List SIP Trunks

Returns all active SIP trunks (carrier lines) allocated to your organisation, with their concurrency and rate limits.

Response — 200 OK

{
  "sip_trunks": [
    {
      "id": "d5f3a1c0-8b2e-4f9a-b7d1-1e2c3a4b5c6d",
      "name": "India Prod Trunk 1",
      "trunk_phone": "+918069XXXXXX",
      "max_cps": 5,
      "max_channels": 100,
      "status": "active"
    }
  ]
}

Response fields

Trigger a Call

Dispatch a single outbound AI call. The call is queued immediately and your agent starts the conversation when the recipient answers.

Request headers

Request body

Example request

{
  "phone_number": "+919876543210",
  "agent_id": "830f767a-397e-4b39-82ff-235cd344e2f9",
  "sip_trunk_id": "d5f3a1c0-8b2e-4f9a-b7d1-1e2c3a4b5c6d",
  "metadata": {
    "customer_name": "Rahul Sharma",
    "amount_due": "7500",
    "due_date": "2026-06-20"
  },
  "callback_url": "https://your-server.com/hooks/call-done"
}

Responses

{
  "call_id": "31106b7c-9d02-4723-8b07-5bb8d90240cb",
  "status": "triggered",
  "poll_url": "/integration/v1/calls/31106b7c-9d02-4723-8b07-5bb8d90240cb/status"
}

{
  "error": "Trunk concurrency (max_channels) exhausted",
  "call_id": "31106b7c-9d02-4723-8b07-5bb8d90240cb",
  "status": "rejected"
}

Get Call Status

Returns the current state and outcome of a call. Poll this endpoint until is_terminal is true.

Path parameters

Response — 200 OK

{
  "id": "31106b7c-9d02-4723-8b07-5bb8d90240cb",
  "phone_number": "+919876543210",
  "call_status": "Completed",
  "is_terminal": true,
  "stalled": false,
  "call_outcome": {
    "disposition": "interested",
    "summary": "Customer confirmed payment for June 20.",
    "sentiment": "positive"
  },
  "duration": 97,
  "start_timestamp": "2026-06-14T10:32:05.000Z",
  "end_timestamp": "2026-06-14T10:33:42.000Z",
  "transcript_url": null,
  "recording_url": null,
  "last_updated": "2026-06-14T10:33:42.000Z"
}

Response fields

Call Notifications

Receive the call result instantly without polling by providing a callback_url when triggering the call. Audatec sends one POST to your endpoint when the call reaches a terminal state.

Notification payload

{
  "event": "call.completed",
  "call_id": "31106b7c-9d02-4723-8b07-5bb8d90240cb",
  "call_status": "Completed",
  "call_outcome": {
    "disposition": "interested",
    "summary": "Customer confirmed payment for June 20.",
    "sentiment": "positive"
  },
  "duration": 97,
  "transcript_url": null,
  "recording_url": null,
  "metadata": {
    "customer_name": "Rahul Sharma",
    "amount_due": "7500",
    "due_date": "2026-06-20"
  },
  "occurred_at": "2026-06-14T10:33:42.000Z"
}

{
  "event": "call.failed",
  "call_id": "91a2b3c4-d5e6-7f8a-9b0c-1d2e3f4a5b6c",
  "call_status": "SIP Call Failed",
  "call_outcome": null,
  "duration": null,
  "transcript_url": null,
  "recording_url": null,
  "metadata": null,
  "occurred_at": "2026-06-14T11:05:10.000Z"
}

Event types

The event field will be one of:

Signature verification

Every notification includes an X-Audatec-Signature header — an HMAC-SHA256 of the request body signed with your account's webhook secret. Verify it before processing:

const crypto = require('crypto');

function verifySignature(rawBody, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

Endpoint requirements

• Must return HTTP 2xx within 30 seconds
• If processing takes longer, respond 200 immediately and handle the payload asynchronously
• Non-2xx responses and timeouts are retried

callback_url vs Polling

Two ways to receive call results. callback_url is strongly recommended for any production system.

callback_url Recommended

Pass a callback_url when triggering the call. Audatec POSTs the result to your endpoint the moment the call reaches a terminal state — no repeated requests, no delay, no wasted API quota.

• Zero server load — one inbound POST replaces dozens of status polls per call
• Instant — notification arrives within seconds of the call ending
• Scales linearly — 1000 concurrent calls still means exactly 1000 callbacks, not 1000 × N polls
• Verified with X-Audatec-Signature — HMAC-SHA256 so you can reject spoofed requests

Polling

If you can't expose a public endpoint (local development, scripts, one-off jobs), poll GET /calls/{call_id}/status until is_terminal is true.

• No inbound server required
• Keep the interval at 4–5 seconds minimum — tighter loops waste quota without benefit
• Stop immediately once is_terminal: true — further polls are no-ops
• Not recommended at scale: 100 concurrent calls at 4 s intervals = 25 req/s of pure overhead

async function waitForCall(callId, apiKey) {
  const url = `https://api.audatec.in/integration/v1/calls/${callId}/status`;
  while (true) {
    const res = await fetch(url, {
      headers: { Authorization: `Bearer ${apiKey}` }
    });
    const data = await res.json();
    if (data.is_terminal) return data;
    await new Promise(r => setTimeout(r, 4000)); // poll every 4s
  }
}

Error Handling

All errors return JSON with an error field describing what went wrong.

{ "error": "metadata missing required keys: amount_due, due_date" }

Common errors

Retry strategy

Different status codes call for different retry behaviour:

• 400 — Do not retry. Fix the request payload.
• 401 — Do not retry. Check your API key.
• 429 — Retry after the Retry-After header value (seconds).
• 502 / 503 — Retry with exponential backoff (1s, 2s, 4s…).

Call Status Values

All possible values for the call_status field.

Error Codes

HTTP status codes returned by the API.