Как подключить базу знаний к голосовому боту: прайс, каталог, вебхуки

Клиент спрашивает цену или свободное время, бот обещает «менеджер перезвонит» — и клиент остывает и уходит к конкуренту. База знаний для голосового бота решает это: через вебхуки бот отвечает по живым данным — прайсу, остаткам, каталогу, карточке клиента из вашей системы. А итоги разговора сам отправляет туда, где с ними работают, — без ручного ввода.

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

Вебхук — это ссылка, по которой кабинет сам забирает или отправляет данные. Отдельно вебхуки и триггеры не оплачиваются: вы платите только за минуты разговора, в среднем 12 ₽ за минуту. Посмотрите видео на две с половиной минуты, а ниже — пошаговая настройка.

Зачем это бизнесу

• Онлайн-школа держит программу и цены в Google-документе. Поменяли цену в документе — бот называет новую уже в следующем звонке.
• Агентство недвижимости подключает свою базу: клиент называет район, бюджет и число комнат, а бот прямо в разговоре находит 3–5 подходящих объектов.
• Интернет-магазин отвечает про остатки и статус заказа по артикулу или номеру. Итог звонка вместе со ссылкой на запись уходит в его систему.
• Магазин с большим каталогом платит меньше. Динамическая база отдаёт AI только нужные строки, а не весь каталог, и бот не путается.
• Служба такси или доставки: бот узнаёт адрес подачи и адрес назначения, сервер считает цену, и клиент слышит стоимость прямо в разговоре — без ожидания оператора.
• Салон, клиника, прокат автомобилей: бот проверяет свободное время или машины, сам записывает, переносит и отменяет записи. Администратору не нужно перезванивать.
• Каждый разговор прозрачен: в разборе звонка видно, какие данные получил бот, что понял из разговора и что ответил. Ошибку находят сразу, а не по жалобам клиентов.

Как бот получает данные: три вида вебхуков

Вебхуки бывают трёх видов:

1. Загрузочный срабатывает до звонка. Данные приходят вместе с инструкцией, и бот опирается на них с первой фразы.
2. Динамический срабатывает во время звонка, когда в разговоре прозвучали ключевые слова триггера — у клиента или у самого бота. AI берёт из разговора нужные значения, кабинет отправляет запрос, ваш сервер возвращает короткий ответ. Пока идёт запрос, бот говорит «одну секунду, посмотрю».
3. Записывающий срабатывает после звонка. AI заполняет параметры ссылки из диалога и отправляет результат.

Как подключить Google-документ к голосовому боту

Это самый простой путь: не нужны ни хостинг, ни программист. Документ подтягивается, пока идут гудки, поэтому бот знает прайс с первой фразы.

1. 1
   Откройте доступ к документу

   В Google нажмите «Доступ» → «Все, у кого есть ссылка», роль «Читатель». Скопируйте ссылку.
2. 2
   Добавьте вебхук

   Карточка бота → «Вебхуки» → «Загрузка webhook, google document, txt» → «Добавить webhook».
3. 3
   Заполните поля

   «Название Webhook», например «Прайс», и «Ссылка на запрос». Ссылка на документ сама превратится в выгрузку текстом, на таблицу — в CSV. Подойдёт и txt-файл или ваш API (адрес, по которому ваша система отдаёт данные).
4. 4
   Передайте данные о клиенте

   Если по ссылке ваш API, отметьте «Быстрые параметры»: «Передавать телефон», «Передавать id lead». Так сервер поймёт, чью карточку отдать.
5. 5
   Сохраните

   Нажмите «Сохранить» на нижней панели. Кабинет проверит объём и скорость загрузки.
6. 6
   Проверьте

   В «Обучении AI» окно «Загрузка Базы данных из webhook» покажет, что получил бот. Как работать с этой вкладкой, описано в статье «Обучение голосового бота».

Как передать итоги звонка в свою систему

Откройте «Запись webhook» → «Добавить webhook», отметьте «Отправлять webhook» и впишите адрес приёмника: каждый записывающий вебхук работает как «Свой webhook» с «Быстрыми параметрами». Метод запроса — только GET, то есть данные передаются прямо в ссылке.

• «Быстрые параметры» подставят телефон, имя, номер лида и ссылку на запись разговора.
• «Добавить параметр» — своё значение из разговора. Укажите «Название параметра» латиницей и «Промпт поиска для параметра», например summary и «Напиши резюме разговора в двух предложениях». Параметр сам допишется в ссылку в виде summary=${summary}.
• Вебхуки для amoCRM и Yandex Форм создают мастера во вкладке «Интеграции»: у таких вебхуков остаются свои кнопки настройки, а ссылку и параметры мастер заполняет сам.

Как бот заполняет поля и шаги в CRM самого кабинета, рассказано в статье «Запись итогов звонка в CRM».

Большие базы: «Поиск по базе данных»

Загрузочные данные AI получает целиком в начале звонка. Кабинет советует держать все загрузочные вебхуки вместе в пределах 50 КБ и 7 секунд загрузки. Больше — при сохранении откроется предупреждение, что звонок станет дороже или начнётся с тишины, и сохранить можно только кнопкой «Я принимаю риск, сохранить». Больше 100 КБ или 10 секунд сохранить не даст. Каталог на тысячи позиций в эти рамки не помещается — да и не нужен целиком.

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

1. Откройте «Триггеры» и нажмите «Добавить триггер».
2. Впишите «Ключевые слова для запуска триггера» — фразы клиента («есть в наличии», «на завтра», «двушка») или фразу самого бота, например «смотрю расписание».
3. Задайте «Фразу заполнения паузы» — что бот скажет, пока ждёт ответ.
4. Укажите «Ссылку на запрос к динамической базе данных» и параметры с «Промптом параметра», например «Какой район назвал клиент? Одним словом».
5. Напишите «Инструкцию для динамического вебхука» — как отвечать по найденному. Пустое поле заменит готовая инструкция для свободных слотов записи. Для каталога или остатков перепишите её под свою задачу.

На своей стороне нужен адрес, который принимает GET-запрос и быстро возвращает 3–10 подходящих записей. Такую «прослойку» — небольшой код между ботом и вашей базой — можно сделать самим с программистом. Или закажите внедрение под ключ — кнопка в конце статьи: базу подключат за вас. Новый триггер приходит с демонстрационной базой — замените ссылку, параметры и инструкцию на свои. На той же вкладке настраиваются и другие действия бота, например перевод звонка с бота на менеджера. Подробно — в статье «Динамическая база для голосового бота».

Чек-лист динамической базы: задание программисту

Сначала проверьте, нужна ли вам динамическая база: чаще всего хватает загрузочного вебхука, и вы экономите на программисте. Загрузите данные Google-документом и спросите бота в «Обучении AI» о датах, услугах и ценах. Если бот не путается, а данные укладываются в 50 КБ, динамическая база не нужна. Путает — нужен поиск по базе. Расписание в Yclients или Google Календаре подключают мастера во вкладке «Интеграции», без программиста: подробнее — в статье «Интеграция с yclients». Для своей базы дайте программисту такое задание:

• Перечислите параметры поиска, например дата, услуга и сотрудник. Для записи обычно нужны три адреса: справочник услуг и сотрудников с их номерами — для загрузочного вебхука, поиск свободного времени — для «Поиска по базе данных» и запись клиента — для записывающего вебхука.
• Ответ — короткий: для записи хватит трёх свободных окон, ближайших ко времени, которое назвал клиент. Подойдёт текст, JSON или XML с понятными названиями полей. По опыту настройки, XML бот читает надёжнее всего.
• Вместо ошибки — понятная фраза. Пустая дата или неизвестная услуга не должны давать «error» или код 500. Пусть сервер ответит: «Пожалуйста, выберите день, в который вам удобно записаться». Бот прочитает это и переспросит клиента.
• До настройки откройте каждую ссылку в браузере: уберите дату, поменяйте услугу, выберите выходной. Каждый ответ должен подсказывать следующий шаг, а не показывать ошибку.

Как написать «Промпт параметра» и запустить поиск вовремя

Параметры AI заполняет по разговору, загрузочным данным и прошлым ответам базы. Основную инструкцию он при этом не видит, поэтому всё нужное пишите в самом промпте:

• Просите одно значение в строгом формате: «Напиши, на какую дату хочет записаться клиент. Строго ДД.ММ.ГГГГ, а если он назвал время — ДД.ММ.ГГГГ ЧЧ:ММ. Без комментариев и без точки в конце».
• Номера — только цифрами: «Напиши id услуги, на которую хочет записаться клиент. Только цифры, например 1». Номер AI найдёт в справочнике из загрузочного вебхука. Короткий список можно расписать прямо в промпте: «Если клиент назвал филиал на Ленина — напиши 101».
• Скажите, что писать, если значения нет: «Если клиент не назвал дату — напиши -». Постоянные значения, например город, впишите прямо в ссылку: city=msk.
• Запускайте поиск фразой самого бота. Добавьте в «План разговора» шаг: «Когда клиент назвал услугу и день, напиши „Смотрю расписание...“ и больше ничего не добавляй, жди ответа». В ключевые слова впишите «смотрю расписание». Второй такой шаг — для другой даты: «Если клиент хочет другой день, снова напиши „Смотрю расписание...“».
• Попросите бота назвать услугу так, как она записана в справочнике: клиент говорит «покраска», бот уточняет «окрашивание волос». Так AI возьмёт верный номер. Шаги «услуга — название из справочника — день — фраза поиска» ставьте подряд, остальные вопросы — до или после них.

Как проверить динамическую базу и вебхук записи в «Обучении AI»

Динамическую базу и вебхук записи проверяют в тестовом чате ещё до первых звонков:

• Начните разговор с ключевых слов триггера, например «есть свободное время на завтра?». В чате появится блок «Webhook: <название триггера>»: по какому слову сработал триггер, что AI подставил в каждый параметр, итоговая ссылка и ответ базы. Как разобрать настоящий звонок, рассказано ниже.
• Ответ сразу после этого блока бот пишет не по основной инструкции, а по «Инструкции для динамического вебхука» триггера. Поэтому «Исправить» у такого ответа правит именно её — в окне будет плашка «Исправляем инструкцию для динамического вебхука».
• «Проверить стабильность ответов» под таким ответом повторит запрос 10 раз и покажет, плавают ли даты, слоты и цены.
• Вебхук записи проверяют в «Тесте записи данных»: выберите «Webhook: <адрес>» и нажмите «Тестировать запись данных». Под каждым параметром будет «Ответ AI», а неточный промпт правят кнопкой «✎ Редактировать промпт». Запрос уходит по-настоящему, так что данные появятся в вашей системе.

Как разобрать звонок с динамической базой

Если в настоящем звонке бот назвал не то время или не записал клиента, откройте «Обучение AI» → «Найти звонок». Вставьте ID из «Детализации звонков» или выберите звонок из списка за 7 дней. Разговор загрузится в чат вместе с вебхуками на своих местах. Смотрите их по порядку:

• Загрузочные вебхуки — что бот получил до разговора. Нет справочника услуг — AI не найдёт нужный номер.
• Блок динамической базы — ссылка запроса, ответ AI по каждому параметру и ответ вашего сервера. Неверная дата или номер — уточните «Промпт параметра» триггера.
• «Умный ответ после динамической базы» — что бот сказал по этим данным. Не те слоты или формат — «Исправить» под ответом бота поправит «Инструкцию для динамического вебхука».
• Блок записывающего вебхука — параметры и ответ вашей системы. Например, AI написал update вместо create, и запись не создалась. Уточните промпт: «Подтвердил новую запись — напиши create, перенёс — update, отменил — delete».

Сверяйте ответ бота с ответом сервера, который сохранился в звонке. Не открывайте ссылку запроса заново: свободное время уже могли занять, а дата — пройти.

Читайте также: Перевод звонка с бота на менеджера, Обучение голосового бота, Запись итогов звонка в CRM, Голосовой бот данные клиента из crm