Документация ›CRM: лиды, задачи, календарь

Запись на приём (календарь)

Что это?

Когда включено, AI назначает встречи клиентам прямо во время разговора. Спрашивает «когда вам удобно?», проверяет рабочие часы специалиста и занятые слоты, сохраняет запись в дашборд. Оператор сразу видит её на странице Календарь.

По умолчанию: ВЫКЛ.

Запись через AI выключена по умолчанию во всех аккаунтах. AI никогда не пытается записывать, пока вы её не включите. Настройка в два шага:

  1. Откройте Настройки и включите Запись на приём (календарь). После этого в меню появятся Кабинеты / специалисты — пока запись выключена, раздел скрыт, потому что страница пуста.
  2. Откройте Кабинеты / специалисты и добавьте хотя бы один ресурс для записи (см. ниже).

После этого AI на всех каналах (голос, WhatsApp, Telegram, Instagram и чат на вашем сайте) может посмотреть, кто свободен, и записать на визит.

«Кабинеты / специалисты» = любой бронируемый ресурс (не обязательно человек):

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

  • Клиника / стоматология: имя врача + специальность
  • Лаборатория / диагностика: название услуги (по-кабинетно если работают параллельно несколько кабинетов)
  • Салон красоты: имя мастера + его услуга
  • Автосервис: номер поста или вид работ
  • Юр-фирма: имя юриста ИЛИ обобщённая «Консультация»

AI берёт то, что вы поставите в поле name, и так и говорит клиенту в подтверждении — поэтому пишите так, чтобы звучало естественно когда AI это произнесёт.

Формат рабочих часов:

JSON по дням недели (3 буквы, lowercase). Каждое значение — список пар ["HH:MM", "HH:MM"] в ВАШЕМ часовом поясе. Отсутствующий ключ или пустой список = выходной.

Пример для клиники Пн-Пт с обедом:

{"mon": [["09:00", "13:00"], ["14:00", "18:00"]],
 "tue": [["09:00", "13:00"], ["14:00", "18:00"]],
 "wed": [["09:00", "13:00"], ["14:00", "18:00"]],
 "thu": [["09:00", "13:00"], ["14:00", "18:00"]],
 "fri": [["09:00", "13:00"], ["14:00", "18:00"]]}

Пустой dict {} = «всегда открыто» — полезно пока настраиваешь, AI не отвергает никакое время. Как только заполнишь реальные часы — AI отказывает в записях вне рабочих часов с объяснением.

Что происходит когда AI записывает клиента:

  1. AI проверяет рабочие часы — отказывает в записях вне часов и просит другое время
  2. AI проверяет конфликты — отказывает в двойной записи, просит другой слот
  3. Запись сохраняется в БД → появляется на странице Календарь, в таймлайне контакта (📅 карточка) и в таймлайне лида
  4. Если для этого контакта есть лид со статусом новый или связались — автоматически переходит в согласовано на канбане
  5. Создаётся задача «Подтвердить запись на HH:MM» на утро дня встречи — оператор получает Telegram-напоминание за час до due
  6. AI подтверждает в одну строку на языке, который настроен в аккаунте

Перенос и отмена записи:

Когда запись включена, у AI на всех каналах есть ещё два инструмента — reschedule_appointment и cancel_appointment. Оба находят собственную ближайшую запись клиента по номеру, с которого он звонит или пишет (определитель номера на телефоне, номер WhatsApp в чате) — чужую запись по угаданному id тронуть нельзя.

  • Одна ближайшая запись → переносится или отменяется сразу; AI подтверждает новое время (или отмену) только после успешного ответа системы.
  • Несколько записей → AI получает список и спрашивает клиента, какую именно (по дню и времени).
  • Ничего не найдено (записывались с другого номера или через регистратуру без телефона) → AI спрашивает, с какого номера делали запись, либо берёт имя и телефон для регистратуры. Он никогда не говорит «перенёс» или «отменил», если этого не произошло.
  • Перенос сохраняет специалиста и длительность и проходит те же проверки, что новая запись: рабочие часы, отсутствие пересечений, занятость в Google-календаре, если он подключён. Событие в Google пересоздаётся при переносе и удаляется при отмене.
  • Оба действия видны в ленте контакта («запись перенесена» / «запись отменена»); отменённый слот сразу доступен для новой записи.

Как оператор работает с Календарём:

  • Дневной вид: Календарь по умолчанию показывает сегодня. Кнопки prev/next или ?date=YYYY-MM-DD для любого дня.
  • Смена статуса: Нажать «Изменить статус» на запланированной/подтверждённой записи. Оператор помечает подтверждена / состоялась / не пришёл / отменена.
  • Ссылка на контакт: Каждая карточка записи имеет ссылку на карточку клиента — открывает полную кросс-канальную историю.
  • Отменённый слот можно переиспользовать: AI может забронить поверх отменённой записи (проверка конфликтов исключает cancelled).

Типичные проблемы:

  • Забыли включить переключатель. Кабинеты есть, но Запись ВЫКЛ в Настройках → AI всё равно не бронирует, а ссылка «Кабинеты / специалисты» пропадает из меню. Включите запись — и вернётся и то и другое.
  • Включили переключатель без кабинетов. Страница Календарь показывает «ресурсы не настроены», AI отказывает в записях.
  • Неправильный формат рабочих часов. Используйте JSON-шаблон выше. Пустой список [] = выходной; отсутствующий ключ дня тоже = выходной.
  • Напоминания клиенту. Задача, которая создаётся утром дня записи — для оператора. Напоминания клиенту в WhatsApp за 24 и за 2 часа до записи включаются отдельно — см. раздел «Напоминания о записи» ниже.

Добавить запись вручную:

Не каждая запись приходит через AI — клиент позвонил на ресепшн или пришёл сам. Нажмите «+ Добавить запись» вверху Календаря, выберите специалиста / дату / время / длительность, впишите имя и телефон клиента и сохраните. Прошлые даты разрешены (удобно для бэкфилла); запись появится в сетке дня как обычная.