Инструменты-вебхуки

Вебхук голосового агента: данные из вашей системы прямо во время звонка

Вебхук голосового агента — это адрес в вашей системе, к которому агент Kallina обращается посреди разговора, передавая то, что сказал клиент, чтобы получить ответ, которого нет в сценарии: статус заказа, остаток на счёте, состояние ремонта. Агент читает ответ и пересказывает его клиенту своими словами. Так Kallina подключается к любой системе с API, даже если её нет в списке интеграций.

Вопрос о заказеRO
  1. КлиентЯ вчера заказал диван. Не подскажете, когда привезут?
  2. АгентНазовите, пожалуйста, номер заказа — сейчас посмотрю.
  3. КлиентЧетыре, семь, два, восемь.
  4. АгентЗаказ на складе, отправка в четверг; курьер позвонит вам за час.
✓ Ответ взят из системы магазина
Пример разговора

Зачем нужен инструмент-вебхук

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

  • Статус заказа, доставки или ремонта
  • Наличие товара или цена из меняющегося прайса
  • Данные клиента, найденные по телефону или по коду
  • Заявка, которая регистрируется в вашей системе прямо во время звонка

Что заполняется для инструмента

Инструмент создаётся в редакторе агента, у него шесть полей.

Поля инструмента-вебхука
ПолеДля чегоПример
НазваниеКак инструмент называется в инструкциях агентаorder_status
ОписаниеКогда агенту им пользоваться — написано так, как объясняли бы новому сотрудникуИспользуй, когда клиент спрашивает, где его заказ
АдресАдрес в вашей системе, который принимает запросОтдельный эндпоинт магазина только для агента
МетодТип HTTP-запроса: POST, GET, PUT или PATCHPOST, по умолчанию
Поля запросаКакие данные агент спрашивает у клиента и отправляет; описываются JSON-схемойНомер заказа, строкой
Время ожиданияСколько секунд агент ждёт ответа30 секунд по умолчанию, можно изменить

Какие данные передаются и в каком порядке

По ходу разговора агент сам решает, когда воспользоваться инструментом, исходя из его описания. Сначала он собирает у клиента поля, которых требует схема, — например номер заказа или дату рождения — и может повторить их для проверки. Потом отправляет запрос на ваш адрес выбранным методом и ждёт ответа не дольше заданного времени.

Ваша система возвращает ответ, обычно в JSON, с тем, что нужно знать клиенту. Агент не зачитывает его дословно: он строит из него естественную реплику на языке разговора. Поэтому в ответе лучше оставить только нужные поля с понятными названиями и ничего такого, что агенту говорить не следует.

Каждое обращение к инструменту сохраняется в истории разговора в Kallina: название инструмента, отправленные параметры, полученный ответ, длительность и успешность. Если клиент жалуется, что ему сказали неверное, сразу видно, откуда ошибка — из вашей системы или из того, как агент это сформулировал.

Как запускаем новый инструмент

  1. Выбираем вопрос

    Начинаем с вопроса, который клиенты задают часто и на который сейчас отвечает человек, ищущий данные в программе.

  2. Вы готовите адрес

    Ваша команда делает эндпоинт, который принимает выбранные поля и возвращает только то, что нужно агенту.

  3. Пишем описание

    Описываем инструмент простыми словами: когда агент его вызывает, что спрашивает у клиента и что делает, если ничего не найдено.

  4. Тестируем звонками

    Звоним с реальными и с ошибочными данными, а потом смотрим в истории, что агент отправил и что получил.

  5. Запускаем на линии

    Инструмент входит в сценарий агента на вашем номере, и первые дни мы вместе следим за историей.

Примеры из разных отраслей

Интернет-магазин
Клиент спрашивает, где посылка. Агент просит номер заказа, инструмент возвращает статус и день доставки, и никому не нужно висеть в очереди ради одной строчки информации.
Автосервис
Владелец хочет узнать, готова ли машина. Инструмент ищет по госномеру в программе сервиса и сообщает этап работ; итоговую цену по-прежнему называет мастер-приёмщик.
Служба доставки или курьерская компания
Получатель звонит, чтобы перенести доставку. Инструмент регистрирует заявку в системе компании, а агент говорит, что диспетчер её подтвердит.

Безопасность адреса и данных

  • Отдельный адрес для агента

    Рекомендуем отдельный эндпоинт, который умеет не больше того, что вы поручили агенту: читает статус, а не меняет весь аккаунт.

  • Защиту согласуем вместе

    В форме инструмента нет отдельного поля для заголовков. Способ защиты адреса мы выбираем при настройке — например, длинный и трудноугадываемый ключ в самом адресе.

  • Только нужные поля

    Всё, что возвращает ваша система, может попасть в реплику агента и остаётся в истории. Не отправляйте данные, которые клиент слышать не должен.

  • Если система молчит

    Если ответ не пришёл за отведённое время, агент остаётся без запрошенных данных. В описании вы указываете, что делать в этом случае: записать номер телефона или перевести на человека.

Чего интеграция через вебхук сегодня не делает

  • Не отправляет вебхук после каждого звонка

    Kallina пока не уведомляет внешнюю систему автоматически по окончании каждого звонка. Результат попадает туда через интеграции с CRM или через автоматизацию.

  • Не пишет код за вас

    Адрес и его ответ делает ваша команда или поставщик вашей системы. Мы точно описываем, какие поля отправляет агент и что он ждёт в ответ.

  • Не заменяет публичный API Kallina

    Документированного публичного REST API у Kallina пока нет; доступ через API обсуждаем по запросу. Вебхуки работают в обратную сторону: это агент спрашивает вас.

Вебхуки и адреса, запускающие автоматизации

Кроме инструментов, которые агент использует в разговоре, у Kallina есть адреса, запускающие автоматизацию из конструктора. Направление обратное: ваша система обращается к Kallina — например, чтобы новая заявка с сайта запустила цепочку шагов. Автоматизация может и вернуть ответ тому, кто её запустил.

Коротко: вебхук отвечает на вопрос «что сказать клиенту прямо сейчас?», а адрес автоматизации — на вопрос «что запустить, когда у вас что-то произошло?». Во многих проектах используют и то и другое, каждое для своей задачи.

Сколько стоит интеграция через вебхук

Вебхуки отдельно не оплачиваются: они входят в тариф агента, 99 $ или 300 $ в месяц, с кредитами, которые списываются по длительности разговоров. Вашу часть — адрес и его ответ — делает ваша команда; мы её описываем и тестируем при внедрении.

Подробно о ценах Kallina

Попробуйте живого агента

Агент на демо-линии не подключён к вашей системе, но по нему слышно, как он просит номер, повторяет его и как говорит, получив ответ.

Позвоните живому агенту: +373 79 325 040

На демо возьмём один из ваших вопросов и вместе набросаем поля инструмента.

Часто задаваемые вопросы

Что нужно от нашей системы?

Доступный из интернета адрес, который принимает HTTP-запрос с выбранными полями и возвращает короткий ответ. Если у системы уже есть API, часто хватает тонкой прослойки поверх него.

Как быстро она должна отвечать?

Как можно быстрее: клиент ждёт на линии. Максимум по умолчанию — 30 секунд, но на простой вопрос ответ должен приходить за мгновения.

Может ли агент не только читать, но и записывать данные?

Да, если ваш адрес это позволяет, — например, чтобы зарегистрировать заявку. Советуем делать записей поменьше и проверять их человеком.

Сколько инструментов может быть у одного агента?

Несколько, у каждого своё название и описание. Чем понятнее описания, тем точнее агент выбирает нужный инструмент.

Это работает на румынском и русском?

Да. Поля и ответ могут быть на любом языке; с клиентом агент говорит на языке разговора.

Можно посмотреть, что отправил агент?

Да, в истории каждого разговора видны отправленные параметры, полученный ответ, длительность и то, успешен ли был запрос.

Где используются вебхуки

Источники

Поля инструмента и история звонков проверены в коде платформы Kallina 18 ноября 2026 года.

Принесите вопрос, на который вы отвечаете чаще всего

Вместе превратим его в инструмент: что агент спрашивает, что отправляет и что отвечает.