Для розробників
Що ви можете під’єднати до Kallina з коду сьогодні
У Kallina ще немає публічного задокументованого REST API. Є чотири робочі точки під’єднання: webhook-інструменти, які агент викликає під час розмови, адреси, що запускають потоки, скрипт для голосової кнопки та MCP-сервер. Доступ до API для особливих випадків обговорюємо за запитом.
Точки під’єднання
Webhook-інструменти під час дзвінка
У картці агента визначте інструмент: назва, опис, адреса, метод, схема полів і максимальний час очікування. Агент викликає його, коли цього вимагає розмова, і використовує відповідь у фразі.
Адреси, що запускають потоки
Потік у конструкторі може мати власну адресу запуску. Ваша система надсилає запит, а потік запускається з отриманими даними.
Голосова кнопка на сайті
Один скрипт на сторінці. Голосова сесія отримує тимчасову адресу, тож ідентифікатор агента не з’являється в коді сторінки.
MCP-сервер
MCP-сумісні асистенти можуть під’єднуватися до облікового запису Kallina через авторизацію OAuth, щоб читати агентів, дзвінки та ліди або запускати дзвінки.
Голосова кнопка: код для вставлення
Скрипт завантажується просто, не як модуль і не через bundler.
<script src="https://app.kallina.info/embed.js" data-widget="WIDGET_ID"></script>
<script>
window.KallinaVoice.on("state", (s) => console.log(s)); // idle | connecting | listening | speaking
window.KallinaVoice.on("message", (m) => console.log(m.source, m.text));
// window.KallinaVoice.start() / window.KallinaVoice.stop()
</script>| Атрибут | Що робить |
|---|---|
| data-widget | Публічний ідентифікатор віджета. Обов’язково. |
| data-mode | «button» показує кнопку; «inline» нічого не показує, і запуск залиште вашому коду. |
| data-position | Кут кнопки: праворуч унизу або ліворуч унизу. |
| data-color | Колір кнопки. |
| data-label | Доступна для читачів екрана мітка кнопки. |
Автентифікація адрес потоків
| Метод | Коли використовувати |
|---|---|
| Без автентифікації | Лише для тестів, у потоках, які не торкаються персональних даних. |
| Базовий | Користувач і пароль, для систем, які не знають іншого. |
| Власний заголовок | Заголовок із секретним значенням, встановленим вами. |
| Bearer | Токен у заголовку авторизації. |
Доступні інструменти MCP
Наведені нижче назви — це назви на сервері. Доступ надається для кожного облікового запису, після авторизації.
- list_agents
- get_agent
- update_agent_prompt
- list_phone_numbers
- list_calls
- get_call_transcript
- list_leads
- export_leads
- start_outbound_call
- list_campaigns
- start_campaign
- account_status
Поширені запитання
У вас є REST API з ключами?
Ні, не публічний. Якщо вам потрібно запускати дзвінки або читати результати з вашої системи, напишіть нам про ваш випадок, і ми узгодимо доступ і його формат.
Чи отримую я webhook із результатом після кожного дзвінка?
Не як стандартну послугу. Результат надсилається через потоки або через наявні інтеграції; для фіксованого формату ми це обговорюємо в проєкті.
Чи є документація?
Для голосової кнопки та webhook-інструментів — опис на цій сторінці та довідка в застосунку. Для будь-якого додаткового доступу документацію ви отримуєте під час запуску проєкту.
Чи повинні вебхуки відповідати швидко?
Так. Кожен інструмент має максимальний час очікування; повільна відповідь означає паузу в розмові, тож тримайте запити короткими.
Опишіть, що саме ви хочете з’єднати
Скажіть, яка система, які дані і в який момент дзвінка. Ми відповімо, що можна зробити з тим, що є, і що потрібно побудувати.