Интеграция

Интеграция с CRM, API и телефония

OperatorAI подключается к вашим системам: CRM передаёт заявку на звонок, результат возвращается сам. Звонки идут через вашу SIP-линию или корпоративную АТС.

REST API

Заявка на звонок одним запросом

Ваша CRM или учётная система каждый день сама передаёт клиентов для обзвона. У каждого звонка уникальный ID: статус можно проверить в любой момент, но это не обязательно — результат придёт вебхуком.

ЗапросЧто делает
POST/api/v1/callsОдна заявка на звонок
POST/api/v1/calls/batchДо 1 000 звонков в одном запросе
GET/api/v1/calls/{id}Статус, результат и расшифровка звонка
GET/api/v1/calls/external/{externalId}Поиск по ID из вашей системы
GET/api/v1/callsИзменения: синхронизация по курсору
DELETE/api/v1/calls/{id}Отмена заявки
GET/api/v1/calls/{id}/recordingЗапись звонка
GET/api/v1/campaignsКампании и их ID
GET/api/v1/openapi.jsonДокументация OpenAPI (импортируется в Postman)
POST/api/v1/calls
X-Api-Key: oai_••••••••••••
Content-Type: application/json

{
  "campaignId": "7f3c2a90-…",
  "phone": "+994501234567",
  "name": "Эльвин Мамедов",
  "externalId": "loan-48213-2026-10",
  "data": {
    "Сумма долга": "320 AZN",
    "Дата платежа": "28.10.2026"
  }
}
Ответ201 Created
{
  "id": "c9a1e5d2-…",
  "object": "call",
  "status": "queued",
  "externalId": "loan-48213-2026-10"
}

Результат приходит вебхуком

Когда звонок завершён, на ваш адрес уходит событие call.completed или call.failed: статус, итог (например, promised_to_pay), ответы анализа, расшифровка и ссылка на запись.

  • Подпись: X-OperatorAI-Signature (HMAC-SHA256)
  • Если не принято — повторная отправка с растущими интервалами в течение ~2 дней
  • Журнал отправок хранится в панели 30 дней

Документация внутри программы

Документация и тестовая консоль — в панели; есть примеры на curl, C#, PHP, Python и 1С. Простая интеграция обычно занимает у программиста 1⁠–⁠3 дня.

Работает и без API: загрузите список из Excel или CSV, а результаты выгрузите в Excel.

API входит в ежемесячный план «Поддержка с API»: обучение ваших программистов и разбор ошибок интеграции — на нас.

POSTВебхук: звонок завершён
X-OperatorAI-Event: call.completed
X-OperatorAI-Signature: v1=4be1…

{
  "id": "evt_5f0c…",
  "type": "call.completed",
  "data": {
    "id": "c9a1e5d2-…",
    "externalId": "loan-48213-2026-10",
    "status": "completed",
    "outcome": "promised_to_pay",
    "result": {
      "durationSeconds": 74,
      "answers": [
        {
          "tool": "Обещание оплаты",
          "answer": "Да",
          "status": "done"
        },
        {
          "tool": "Дата оплаты",
          "answer": "30 октября",
          "status": "done"
        }
      ],
      "recordingUrl": "https://…/calls/c9a1e5d2-…/recording"
    }
  }
}

Ключи

Ключи, права и лимиты

Создаются в панели

Права: calls:write, calls:read, campaigns:read. Ограничения по кампании, IP/CIDR и сроку действия.

Хранится только хеш

Сам ключ в базе не хранится — только его хеш SHA-256. Ключ можно отозвать в любой момент.

Защита от дублей

externalId: если одна и та же заявка придёт дважды, новый звонок не создаётся.

Лимит

600 запросов в минуту на ключ; при превышении — 429 и Retry-After.

Телефония

Ваша линия, ваш номер

Звонки идут с вашей SIP-линии: клиент видит знакомый номер, а минуты вы оплачиваете своему оператору напрямую.

SIP-линия

Любой SIP-провайдер или линия оператора связи. Аудиокодек G.711.

Корпоративная АТС

Есть пошаговое руководство по подключению к Cisco CUCM как Third-Party SIP Device.

Одновременные звонки

Число параллельных звонков определяется числом каналов линии; кампания не открывает больше.

Восстанавливается сама

Если SIP-регистрация пропала, основной и резервный адреса пробуются по очереди, затем набор продолжается.

ИИ-провайдеры. Поддерживаются Google Gemini, xAI Grok, ElevenLabs и Azure Speech. Аккаунты и ключи ваши, расходы вы оплачиваете провайдеру напрямую. При смене модели стоимость звонков считается по таблице цен в панели.

Вопросы об интеграции

Сколько времени занимает интеграция?

Простая интеграция (передать список и получить результат) обычно занимает у программиста 1⁠–⁠3 дня. При необходимости интеграцию сделаем мы.

Работает ли с 1С?

Да, в документации есть пример для 1С. Подключиться может любая система, которая умеет отправлять HTTP-запросы.

Можно ли без API?

Да. Списки загружаются из Excel или CSV, результаты выгружаются в Excel.

С какого номера идут звонки?

С номера вашей SIP-линии. Линию вы берёте у оператора связи или SIP-провайдера; с подключением поможем.

Позвоним на ваш номер

Пришлите сценарий или текущий скрипт. В течение 3 рабочих дней проведём демо-звонок по вашему сценарию и подготовим письменное предложение.

Заказать демо-звонокНаписать в WhatsApp

Связаться напрямую

Sahib Babaliyev+994 50 788 77 90

Tural Hamzayev+994 55 552 54 41

Эл. почта[email protected]