Инструменты-вебхуки
Вебхук голосового агента: данные из вашей системы прямо во время звонка
Вебхук голосового агента — это адрес в вашей системе, к которому агент Kallina обращается посреди разговора, передавая то, что сказал клиент, чтобы получить ответ, которого нет в сценарии: статус заказа, остаток на счёте, состояние ремонта. Агент читает ответ и пересказывает его клиенту своими словами. Так Kallina подключается к любой системе с API, даже если её нет в списке интеграций.
- КлиентЯ вчера заказал диван. Не подскажете, когда привезут?
- АгентНазовите, пожалуйста, номер заказа — сейчас посмотрю.
- КлиентЧетыре, семь, два, восемь.
- АгентЗаказ на складе, отправка в четверг; курьер позвонит вам за час.
Зачем нужен инструмент-вебхук
Сценарий говорит агенту, как разговаривать, но не может хранить данные, которые меняются каждый час. Вебхук закрывает этот пробел: агент задаёт вашей системе короткий вопрос, через мгновение получает ответ и продолжает разговор со свежей информацией, не переводя клиента на оператора.
- Статус заказа, доставки или ремонта
- Наличие товара или цена из меняющегося прайса
- Данные клиента, найденные по телефону или по коду
- Заявка, которая регистрируется в вашей системе прямо во время звонка
Что заполняется для инструмента
Инструмент создаётся в редакторе агента, у него шесть полей.
| Поле | Для чего | Пример | |
|---|---|---|---|
| Название | Как инструмент называется в инструкциях агента | order_status | |
| Описание | Когда агенту им пользоваться — написано так, как объясняли бы новому сотруднику | Используй, когда клиент спрашивает, где его заказ | |
| Адрес | Адрес в вашей системе, который принимает запрос | Отдельный эндпоинт магазина только для агента | |
| Метод | Тип HTTP-запроса: POST, GET, PUT или PATCH | POST, по умолчанию | |
| Поля запроса | Какие данные агент спрашивает у клиента и отправляет; описываются JSON-схемой | Номер заказа, строкой | |
| Время ожидания | Сколько секунд агент ждёт ответа | 30 секунд по умолчанию, можно изменить |
Какие данные передаются и в каком порядке
По ходу разговора агент сам решает, когда воспользоваться инструментом, исходя из его описания. Сначала он собирает у клиента поля, которых требует схема, — например номер заказа или дату рождения — и может повторить их для проверки. Потом отправляет запрос на ваш адрес выбранным методом и ждёт ответа не дольше заданного времени.
Ваша система возвращает ответ, обычно в JSON, с тем, что нужно знать клиенту. Агент не зачитывает его дословно: он строит из него естественную реплику на языке разговора. Поэтому в ответе лучше оставить только нужные поля с понятными названиями и ничего такого, что агенту говорить не следует.
Каждое обращение к инструменту сохраняется в истории разговора в Kallina: название инструмента, отправленные параметры, полученный ответ, длительность и успешность. Если клиент жалуется, что ему сказали неверное, сразу видно, откуда ошибка — из вашей системы или из того, как агент это сформулировал.
Как запускаем новый инструмент
Выбираем вопрос
Начинаем с вопроса, который клиенты задают часто и на который сейчас отвечает человек, ищущий данные в программе.
Вы готовите адрес
Ваша команда делает эндпоинт, который принимает выбранные поля и возвращает только то, что нужно агенту.
Пишем описание
Описываем инструмент простыми словами: когда агент его вызывает, что спрашивает у клиента и что делает, если ничего не найдено.
Тестируем звонками
Звоним с реальными и с ошибочными данными, а потом смотрим в истории, что агент отправил и что получил.
Запускаем на линии
Инструмент входит в сценарий агента на вашем номере, и первые дни мы вместе следим за историей.
Примеры из разных отраслей
- Интернет-магазин
- Клиент спрашивает, где посылка. Агент просит номер заказа, инструмент возвращает статус и день доставки, и никому не нужно висеть в очереди ради одной строчки информации.
- Автосервис
- Владелец хочет узнать, готова ли машина. Инструмент ищет по госномеру в программе сервиса и сообщает этап работ; итоговую цену по-прежнему называет мастер-приёмщик.
- Служба доставки или курьерская компания
- Получатель звонит, чтобы перенести доставку. Инструмент регистрирует заявку в системе компании, а агент говорит, что диспетчер её подтвердит.
Безопасность адреса и данных
Отдельный адрес для агента
Рекомендуем отдельный эндпоинт, который умеет не больше того, что вы поручили агенту: читает статус, а не меняет весь аккаунт.
Защиту согласуем вместе
В форме инструмента нет отдельного поля для заголовков. Способ защиты адреса мы выбираем при настройке — например, длинный и трудноугадываемый ключ в самом адресе.
Только нужные поля
Всё, что возвращает ваша система, может попасть в реплику агента и остаётся в истории. Не отправляйте данные, которые клиент слышать не должен.
Если система молчит
Если ответ не пришёл за отведённое время, агент остаётся без запрошенных данных. В описании вы указываете, что делать в этом случае: записать номер телефона или перевести на человека.
Чего интеграция через вебхук сегодня не делает
Не отправляет вебхук после каждого звонка
Kallina пока не уведомляет внешнюю систему автоматически по окончании каждого звонка. Результат попадает туда через интеграции с CRM или через автоматизацию.
Не пишет код за вас
Адрес и его ответ делает ваша команда или поставщик вашей системы. Мы точно описываем, какие поля отправляет агент и что он ждёт в ответ.
Не заменяет публичный API Kallina
Документированного публичного REST API у Kallina пока нет; доступ через API обсуждаем по запросу. Вебхуки работают в обратную сторону: это агент спрашивает вас.
Вебхуки и адреса, запускающие автоматизации
Кроме инструментов, которые агент использует в разговоре, у Kallina есть адреса, запускающие автоматизацию из конструктора. Направление обратное: ваша система обращается к Kallina — например, чтобы новая заявка с сайта запустила цепочку шагов. Автоматизация может и вернуть ответ тому, кто её запустил.
Коротко: вебхук отвечает на вопрос «что сказать клиенту прямо сейчас?», а адрес автоматизации — на вопрос «что запустить, когда у вас что-то произошло?». Во многих проектах используют и то и другое, каждое для своей задачи.
Сколько стоит интеграция через вебхук
Вебхуки отдельно не оплачиваются: они входят в тариф агента, 99 $ или 300 $ в месяц, с кредитами, которые списываются по длительности разговоров. Вашу часть — адрес и его ответ — делает ваша команда; мы её описываем и тестируем при внедрении.
Попробуйте живого агента
Агент на демо-линии не подключён к вашей системе, но по нему слышно, как он просит номер, повторяет его и как говорит, получив ответ.
Позвоните живому агенту: +373 79 325 040На демо возьмём один из ваших вопросов и вместе набросаем поля инструмента.
Часто задаваемые вопросы
Что нужно от нашей системы?
Доступный из интернета адрес, который принимает HTTP-запрос с выбранными полями и возвращает короткий ответ. Если у системы уже есть API, часто хватает тонкой прослойки поверх него.
Как быстро она должна отвечать?
Как можно быстрее: клиент ждёт на линии. Максимум по умолчанию — 30 секунд, но на простой вопрос ответ должен приходить за мгновения.
Может ли агент не только читать, но и записывать данные?
Да, если ваш адрес это позволяет, — например, чтобы зарегистрировать заявку. Советуем делать записей поменьше и проверять их человеком.
Сколько инструментов может быть у одного агента?
Несколько, у каждого своё название и описание. Чем понятнее описания, тем точнее агент выбирает нужный инструмент.
Это работает на румынском и русском?
Да. Поля и ответ могут быть на любом языке; с клиентом агент говорит на языке разговора.
Можно посмотреть, что отправил агент?
Да, в истории каждого разговора видны отправленные параметры, полученный ответ, длительность и то, успешен ли был запрос.
Где используются вебхуки
- ИИ-оператор доставки
Агент отвечает о заказах и доставках по данным вашей системы.
- Голосовой агент для интернет-магазинов
Статус заказа, возвраты и вопросы о товарах — по телефону.
- Голосовой агент для автосервиса
Этап ремонта, который агент берёт из программы сервиса через вебхук.
- Голосовой агент SIP
Как звонки на ваш номер попадают к агенту.
- Руководство: первый голосовой агент
Что подготовить до запуска и как протестировать сценарий.
- Факты о Kallina AI
Компания, языки, интеграции и ограничения агентов — в одном месте.
Источники
Поля инструмента и история звонков проверены в коде платформы Kallina 18 ноября 2026 года.
Принесите вопрос, на который вы отвечаете чаще всего
Вместе превратим его в инструмент: что агент спрашивает, что отправляет и что отвечает.