Динамическая база для голосового бота: как подключить и проверить

Динамическая база для голосового бота нужна, когда данных так много, что бот начинает в них путаться. У агентства недвижимости сотни квартир, у такси цена зависит от двух адресов, у клиники или салона — расписание десятка специалистов, у магазина — каталог на тысячи товаров. Целиком в бота это не загрузить: звонок дорожает, бот путает даты и цены, и клиент уходит к конкуренту.

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

Что такое динамическая база и как она работает в звонке

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

1. Звучит ключевое слово — у клиента («есть время на завтра?») или у бота («Смотрю расписание...»).
2. AI по промптам параметров берёт из разговора дату, услугу, район или артикул.
3. Кабинет отправляет GET-запрос, а бот говорит «одну секунду, посмотрю».
4. Сервер возвращает короткий ответ: три свободных окна, пять квартир, остаток товара.
5. Бот отвечает по «Инструкции для динамического вебхука» — только по этим данным, поэтому не путается в датах.

Когда динамическая база не нужна

Сначала проверьте, не хватит ли обычного загрузочного вебхука, — чаще всего хватает. Подключите Google-документ с данными («Вебхуки» → «Загрузка webhook, google document, txt») и поспрашивайте бота в «Обучении AI» о датах, услугах и ценах. Не путается — программист не нужен. Кабинет советует держать загрузочные данные в пределах 50 КБ и 7 секунд, а больше 100 КБ или 10 секунд сохранить не даст. Подробнее — в статье «База знаний для голосового бота».

Для Yclients программист тоже не нужен: мастер во вкладке «Интеграции» сам создаёт триггер «Поиск по базе данных» — это готовый пример динамической базы, см. «Интеграция с Yclients». Свободное время из Google Календаря подтягивает свой мастер: «Интеграция с Google Календарём».

Задание программисту: три адреса и формат ответа

Прослойку — небольшой код между ботом и вашей базой — пишет программист. База может быть любой: таблица, XML, MySQL, CRM, сервис записи с API. Сначала выпишите параметры поиска (дата, услуга, сотрудник), потом ставьте задачу. Для записи нужны три адреса:

• Справочник услуг и сотрудников с ID — в загрузочный вебхук: по нему AI переводит слова клиента в номер.
• Поиск окон, например https://example.com/slots?date=24.03.2026&service_id=3, — в триггер «Поиск по базе данных».
• Запись клиента — в «Вебхуки» → «Запись webhook».

Требования к ответу поиска:

• Коротко: до трёх окон, ближайших к желаемому времени, для каталога — 3–5 позиций.
• Текст, JSON или XML с понятными полями; по опыту настройки XML бот читает надёжнее всего.
• Вместо «error» и кода 500 — фраза с подсказкой: бот сам переспросит клиента.
• Быстро и только GET: всё это время клиент ждёт на линии.

Блок freeSlots понимает готовая инструкция ответа триггера. Перед настройкой откройте каждую ссылку в браузере: уберите дату, смените услугу, выберите выходной. Прослойку можно сделать самим или заказать внедрение под ключ — кнопка в конце статьи.

Как настроить триггер «Поиск по базе данных»

1. 1
   Добавьте триггер

   Вкладка «Триггеры» → «Добавить триггер». Новый триггер сразу получает действие «Поиск по базе данных» и демо-базу: бот спрашивает номер аккаунта и называет баланс.
2. 2
   Впишите ключевые слова

   Заполните «Название триггера», например «Расписание», и «Ключевые слова для запуска триггера»: фразу бота перед поиском («смотрю расписание») и при желании фразы клиента.
3. 3
   Проверьте паузу

   «Фраза заполнения паузы»: у нового триггера это «одну секунду, посмотрю.» через 2000 мс.
4. 4
   Вставьте ссылку

   Адрес поиска в «Ссылку на запрос к динамической базе данных», метод GET. Постоянные значения пишите прямо в ссылку: city=msk.
5. 5
   Добавьте параметры

   Удалите демо-параметр akk, нажмите «Добавить параметр», задайте «Название параметра» латиницей и «Промпт параметра». Параметр сам допишется в ссылку: date=${date}.
6. 6
   Опишите ответ

   «Инструкция для динамического вебхука». Пустое поле заменит готовая инструкция для окон записи; для каталога и остатков перепишите её. Нажмите «Сохранить».

Без ключевых слов включённый триггер не сохранится — откроется окно «Не заполнены ключевые слова триггера». Поле «Модель для получение параметров» видно не всегда: новый триггер сам ставит «Обычная модель».

Как написать «Промпт параметра»: примеры для даты, ID и названий

«Промпт параметра» — вопрос к AI, на который он отвечает одним значением из разговора. Укажите формат и что писать, если значения нет:

Короткий список, например филиалы, можно расписать прямо в промпте: «у метро Сокол — 1, на Тверской — 2». Клиент говорит «покраска», а в справочнике «Окрашивание волос»? Пусть бот назовёт услугу как в справочнике и уточнит, верно ли: тогда AI возьмёт правильный ID.

Как бот сам запускает поиск: фраза в «Плане разговора»

Надёжнее запускать поиск фразой самого бота: он скажет её, когда соберёт все параметры. Откройте вкладку «Инструкция» → «План» → блок «План разговора», нажмите «Добавить шаг» и перетащите шаги на места:

1. После вопроса об услуге: «Назови услугу как в справочнике и уточни, верно ли».
2. После вопроса о дне: «Когда знаешь услугу и день, напиши „Смотрю расписание...“, больше ничего не добавляй и жди ответа».
3. Для повторного поиска: «Если клиент хочет другой день или услугу, снова напиши „Смотрю расписание...“».

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

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

Откройте тестовый чат: «Обучение AI» → «Ручное обучение» → «Начать обучение» — и напишите как клиент, назвав услугу и день. Когда сработает триггер, в чате появится блок «Webhook: <название триггера>»: ключевое слово, «Ответ AI» по каждому параметру, итоговая ссылка и «Ответ динамической базы».

Сверьте параметры со справочником. Не устроил ответ бота после блока — «Исправить» под ним правит «Инструкцию для динамического вебхука», а не основную. «Проверить стабильность ответов» повторит запрос 10 раз и покажет, плавают ли даты и цены. Запись проверьте в «Тесте записи данных» → «Тестировать запись данных». Подробнее — в статье «Как обучить голосового бота».

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

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

1. «Webhook (init — загрузка базы данных)» — что бот знал до разговора, например справочник.
2. «Webhook (Динамическая база)» — ссылка, «Параметры (AI подзапросы)» и «Ответ сервера (HTTP 200)». Неверный параметр — правьте его промпт.
3. «Умный ответ после динамической базы» — что бот сказал по этим данным. Не те окна — «Исправить» под ответом бота.
4. «Webhook (post — запись)» — ответ вашей системы. Например, AI написал update вместо create, и запись не создалась: уточните промпт — новая запись create, перенос update, отмена delete.

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

Типовые ошибки

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

Читайте также: База знаний для голосового бота, Как обучить голосового бота, Голосовой робот под ключ