API справочник
Live — v1 available now

REST API

Стартирайте AI гласови обаждания, синхронизирайте контакти и получавайте резултатите от обаждания от всеки бекенд, CRM или no-code инструмент.

Base URL:https://outboundcalls.ai/api/v1

Authentication

Generate an API key from Dashboard → Settings → API Keys. Подайте го като Bearer token при всяка заявка.

Authorization: Bearer oc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Ключовете се хешират при съхранение и се показватonly onceпри създаване. Сменяйте или оттегляйте по всяко време от същата страница Настройки.

Какво можете да свържете

API е стандартен REST + Bearer token, затова работи с всичко, което използва HTTPS — без необходимост от SDK.

Zapier

Webhook-и + HTTP

Стартирайте обаждания, когато нов lead бъде добавен във Вашия CRM, електронна таблица или форма.

Make (Integromat)

HTTP модул

Създавайте визуални работни потоци: формуляр → OutboundCalls → Slack/имейл/CRM актуализация.

n8n

Възел за HTTP заявка

Автоматизация, хоствана самостоятелно. Свържете Вашата база данни, планировчик или система за съобщения.

HubSpot / Salesforce / Pipedrive

CRM

Добавяйте автоматично нови контакти в кампания; връщайте резюмета от обажданията като записи за активност.

Персонализиран бекенд (Node, Python, PHP, Go, Ruby)

Произволен език

Стандартен REST + Bearer token. Работи с всичко, което може да направи HTTPS заявка.

No-code платформи (Bubble, Retool, Airtable Automations)

No-code

Включете крайната точка в действие от работен поток — без необходимост от SDK.

Реални работни потоци, които можете да изградите

Нов lead попълва Ваш формуляр в Typeform → обадете му се в рамките на 30 секунди
Booking confirmation in Calendly → AI agent calls 24h before to confirm
Failed Stripe payment → reminder call instead of just an email
Ежедневно CSV качване от Вашия CRM → AI агент се обажда на всеки контакт в работно време
WhatsApp inbound message → callback from voice agent if requested
Напредъкът на продължителна кампания се синхронизира към Вашето хранилище за данни на всеки 15 мин.

Endpoints

Акаунт

GET/me

Агенти

GET/agents
GET/agents/:id

Контакти

GET/contacts
POST/contacts

Обаждания

POST/calls
GET/calls
GET/calls/:id

Кампании

GET/campaigns
GET/campaigns/:id

Още крайни точки (създаване/актуализиране/изтриване на агенти, CSV импорт, управление на кампании) са в плана за развитие. Нужна Ви е някоя спешно?Tell us.

Code examples

cURL
# Trigger an outbound call from your agent
curl -X POST https://outboundcalls.ai/api/v1/calls \
  -H "Authorization: Bearer oc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "clxAGENT123",
    "toNumber": "+14155551212",
    "contactId": "clxCONTACT456"
  }'

# Response
{
  "id": "clxCALL789",
  "phoneFrom": "+12025550100",
  "phoneTo": "+14155551212",
  "status": "RINGING",
  "elevenlabsConvId": "conv_abc...",
  "createdAt": "2026-04-29T10:32:11.000Z"
}
JavaScript / Node.js
// Trigger a call from any Node.js / browser app
const r = await fetch('https://outboundcalls.ai/api/v1/calls', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.OC_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    agentId: 'clxAGENT123',
    toNumber: '+14155551212',
  }),
});
const call = await r.json();
console.log(call.id, call.status); // RINGING

// Later — fetch transcript & summary
const detail = await fetch(`https://outboundcalls.ai/api/v1/calls/${call.id}`, {
  headers: { Authorization: `Bearer ${process.env.OC_API_KEY}` },
}).then(r => r.json());
console.log(detail.summary, detail.transcript);

Post-call webhook

Конфигурирайте webhook URL за всеки агент. След всяко обаждане OutboundCalls изпраща чрез POST подписан JSON payload към Вашата крайна точка със:

  • Full transcript
  • Recording URL
  • AI-generated summary
  • Sentiment score
  • Goal achieved (true/false)
  • Extracted data fields
  • Duration + credits charged
  • Voicemail flag

Всички payload-и се подписват с HMAC-SHA256. Проверете заглавката спрямо секретния ключ за webhook на Вашия агент.

Стартирайте за минути, не за седмици

Създайте акаунт, генерирайте API ключ и стартирайте първото си обаждане за под 5 минути.