Для разработчиков
Что вы можете подключить к 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 — описание на этой странице и справка в приложении. Для любого дополнительного доступа документацию вы получите при запуске проекта.
Инструменты webhook должны отвечать быстро?
Да. У каждого инструмента есть максимальное время ожидания; медленный ответ означает паузу в разговоре, поэтому держите запросы короткими.
Опишите нам, что хотите связать
Скажите, какую систему, какие данные и в какой момент звонка. Мы ответим, что можно сделать с тем, что есть, и что нужно построить.