Перейти до вмісту
Daber AI

Розробникам

Усе, що робить панель керування, може зробити і ваш код

Публічний API з автентифікацією за ключем, підписані вебхуки про завершення розмови, запис активності назад у CRM і MCP-сервер, який дає змогу зібрати весь робочий простір із Claude або ChatGPT.

Коротко

Чи є API для телефонного агента?

Так. Є публічний REST API з автентифікацією за ключем, який надсилається в заголовку Authorization; через нього можна поставити вихідний дзвінок у чергу, читати розмови й транскрипції та керувати агентами, сценаріями дзвінків і базою знань. Коли дзвінок завершується, на налаштований вами endpoint доставляється вебхук, підписаний HMAC, тож опитувати систему не доводиться. Якщо ви працюєте в Salesforce або HubSpot, система може записати дзвінок назад як завершену активність, пов’язану з лідом або контактом. Усе це доступне й через віддалений MCP-сервер, який дає змогу LLM-клієнту будувати робочий простір і керувати ним, не написавши жодного рядка коду. Повний довідник, поле за полем і маршрут за маршрутом, міститься в документації OpenAPI, посилання на яку є на цій сторінці.

Живий довідник

Довідник генерується із самого коду, тож він завжди відповідає тому, що працює насправді. Маршрут, поле чи код помилки, який ви там бачите, — це те, що повертає сервер.

Відкрити довідник API

https://server.daber.ai/v1/docs

Публічний REST API

Автентифікація за ключем у кожному запиті, snake_case у передаванні даних і scopes на рівні маршруту: кожен ключ несе визначений набір scopes, а ключ без потрібного scope просто не отримує маршрут. Ключ показується один раз під час створення; у нас зберігається лише його хеш.

  • Постановка вихідного дзвінка в чергу з необов’язковою прив’язкою до кампанії, щоб результат увійшов у її KPI
  • Читання розмов: метадані, транскрипція, підсумок, тональність і причина переведення на оператора
  • Керування агентами та сценаріями дзвінків, зокрема створення схеми з наявного документа зі сценарієм
  • Запис у базу знань — створені через API записи потрапляють як чернетки, а придатними для пошуку їх робить підтвердження в панелі керування
  • Кожна зміна агента чи схеми версіонується, зокрема та, що надійшла через API, — і її можна відкотити

Поставити вихідний дзвінок у чергу

Мінімальний запит: ідентифікатор агента та номер для набору. Дзвінок потрапляє в чергу і йде тим самим шляхом набору, який використовують кампанії, тож другого, інакше поведеного шляху в коді немає.

curl -X POST https://server.daber.ai/v1/calls \
  -H "Authorization: Bearer dbr_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "3f9c1a52-7b41-4f0e-9c8d-2a5b6e7d8f10",
    "phone": "+972501234567"
  }'
У відповіді повертається ідентифікатор запиту на дзвінок. Результат — відповіли чи ні, що було сказано і що підсумовано — надходить вебхуком про завершення, а не у відповіді на цей запит.

Вебхуки про завершення

Замість того щоб опитувати API до кінця дзвінка, ви реєструєте endpoint, і подія приходить до вас. Кожен запит несе підпис HMAC-SHA256 над часовою позначкою та тілом повідомлення — її перевірка на вашому боці і є різницею між endpoint і endpoint, який може нагодувати будь-хто.

  • Події життєвого циклу дзвінка, замовленого через API: поставлено в чергу, завершено, не вдалося
  • Подія про завершення розмови для кожної завершеної голосової розмови, а не лише для замовлених через API
  • Підпис передається в окремому заголовку й містить часову позначку, тож старе повторне надсилання можна відхилити
  • Секрет можна розкрити та замінити з налаштувань, а журнал доставки зберігає останні спроби для кожного endpoint

Куди завершений дзвінок іде далі

Завершений дзвінок — це запис щонайменше у двох системах: нашій і вашій. Два способи закрити цей розрив, не пишучи синхронізацію вручну.

Запис активності в CRM

Якщо дзвінка немає в CRM, то для менеджера з продажу його не було. Після завершення система може створити завершену активність у Salesforce або HubSpot, прив’язану до потрібного ліда чи контакту та призначену його власникові, із підсумком і результатом. Збій запису в CRM ніколи не валить сам дзвінок — він фіксується і показується, а розмова лишається в нас неушкодженою.

Віддалений MCP-сервер

Той самий API, відкритий як MCP-сервер, — тож робочий простір можна під’єднати до LLM-клієнта на кшталт Claude чи ChatGPT і будувати його в діалозі: перетворити документ зі сценарієм на схему дзвінка, створити агента, прив’язати до нього схему й моделі, додати записи до бази знань і зробити тестовий дзвінок. Автентифікація — тим самим ключем API, а клієнтові надаються лише ті інструменти, які дозволяють scopes цього ключа: LLM-клієнт ніколи не отримує більше, ніж отримує ключ у його руці.

Що варто знати перед виходом у продакшн

  • Робочий ключ — такий самий секрет, як будь-який інший: він показується один раз і ніколи не надсилається з браузера
  • Діє обмеження частоти запитів на ключ, а виявлений шквал набору може автоматично призупинити ключ — призупинення скасовується в налаштуваннях
  • Перевірка підпису вебхука на вашому боці обов’язкова, а не факультативна
  • Підсумок і тональність пишуться після завершення дзвінка, а не в мить роз’єднання, — тому вони надходять вебхуком, а не у відповіді на запит набору

Зателефонувати ШІ-агенту

Справжній дзвінок івритом. Саме це почують ваші клієнти.

Нехай ШІ-агент передзвонить

Залиште номер — агент передзвонить менш ніж за хвилину.

Надсилаючи форму, ви погоджуєтеся, що ми зв’яжемося з вами щодо цього запиту. Дзвінок записується та розшифровується в текст.