Календарь записи через API и MCP

Доступно всем владельцам с действующей подпиской или пробным периодом и нужными правами. Старые ключи не получают новые права автоматически.

Что умеет календарь через API и MCP

Подключённая программа может читать настройки рабочего календаря, виды записи и записи за выбранные даты, искать свободное время, готовить перенос, отмену и подтверждение записи. Доступны также настройка рабочих часов и исключений, виды записи, ручные записи и напоминания. Календарь принадлежит выбранной ИИ-стратегии; синхронизации с Google или Яндекс Календарём нет.

Основные операции: get_free_slots, get_ai_calendar_configuration, get_ai_calendar_bookings, reschedule_ai_booking, cancel_ai_booking, confirm_ai_booking. Выбирайте свою стратегию и кабинеты, доступные ключу. Для чтения нужны права на настройки ИИ, для записей дополнительно — «Контактные данные и расшифровки звонков». Изменения требуют прав из группы «Управление AI-менеджером»; точные требования перечислены в инструкции ключа.

Как изменить запись

  1. Прочитайте запись и свободное время в часовом поясе стратегии.
  2. Подготовьте preview_ai_saved_change с нужным действием. Предпросмотр ничего не меняет.
  3. Откройте полученную ссылку на Bidline, проверьте «Было → Стало» и подтвердите лично. Подтверждение программы или сообщение «да» это не заменяет.
  4. Программа применяет тот же запрос с preview_id и прежним ключом повтора. Вместимость проверяется заново при сохранении; если данные изменились, нужен новый предпросмотр.

Перенос пересчитывает напоминание. Отмена и подтверждение меняют календарную запись и сами не отправляют сообщения покупателю. При неизвестном результате сначала проверьте запись и сохранённый результат операции.

Напоминания

Через update_ai_calendar_configuration доступны режим «За время до записи» (1–72 часа) и «В день записи» с местным временем стратегии. Уже отправленные и просроченные напоминания не повторяются. Состояние «запланировано», попытка отправки и неизвестный исход не означают доставку.

Чтение записей — за период до 62 дней, постранично: передавайте следующий курсор с теми же параметрами. Календарь на сайте и программный доступ используют сохранённые записи Bidline.

Автозаполнение навыков пока недоступно. Оно не требуется для чтения календаря и работы с записями.