Довідник API
Live — v1 available now

REST API

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

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

Authentication

Generate an API key from Dashboard → Settings → API Keys. Передавайте його як Bearer-токен у кожному запиті.

Authorization: Bearer oc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Ключі хешуються під час зберігання та показуютьсяonly onceлише під час створення. Ротуйте або відкликайте їх будь-коли на тій самій сторінці налаштувань.

Що можна підключити

API — це звичайний REST + Bearer-токен, тому він працює з будь-чим, що підтримує HTTPS, — SDK не потрібен.

Zapier

Webhooks + HTTP

Запускайте дзвінки, коли новий лід додається до вашої CRM, таблиці або форми.

Make (Integromat)

HTTP-модуль

Створюйте візуальні сценарії: форма → OutboundCalls → оновлення в Slack/електронній пошті/CRM.

n8n

Вузол HTTP-запиту

Автоматизація на власній інфраструктурі. Підключайте базу даних, планувальник або стек обміну повідомленнями.

HubSpot / Salesforce / Pipedrive

CRM

Автоматично додавайте нові контакти до кампанії; повертайте підсумки дзвінків як записи активності.

Власний backend (Node, Python, PHP, Go, Ruby)

Будь-яка мова

Стандартний REST + Bearer-токен. Працює з будь-якою системою, що може виконати HTTPS-виклик.

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

No-code

Підключіть ендпоінт до дії в сценарії — SDK не потрібен.

Практичні сценарії, які ви можете створити

Новий лід заповнює вашу 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

Налаштуйте URL-адресу webhook для кожного агента. Після кожного дзвінка OutboundCalls надсилає POST-запитом на ваш ендпоінт підписаний JSON-пакет даних із такими даними:

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

Усі пакети даних підписуються за допомогою HMAC-SHA256. Перевіряйте заголовок за секретним ключем webhook вашого агента.

Запускайте за хвилини, а не тижні

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