← На главнуюДокументация
← К разделам

Календарь, почта и парсинг

Календарь, почта и парсинг сайтов — три отдельные функции тарифа с собственными кабинетами и (для календаря и почты) отдельными API-ключами автоматизации. Полный перечень методов — в разделе API настройки (аккордеоны «Календарь (CalDAV)» и «Почта (IMAP/SMTP)»).

Календарь Яндекс (CalDAV)

Нужна функция тарифа calendar_bridge. Раздел в кабинете: «Календари (CalDav)» — /dashboard/calendar-bridge.

  1. Создайте пароль приложения в настройках Яндекс ID и укажите логин (email) и этот пароль в форме подключения.
  2. Нажмите «Загрузить календари», выберите нужные календари и сохраните подписки.
  3. Запустите синхронизацию вручную или дождитесь фонового обновления — события попадают в кэш на сервере.

Для сценариев n8n и скриптов создайте ключ автоматизации с префиксом cal_ в том же разделе. Им запрашиваются только эндпоинты /api/v1/integrations/calendar/... (список и CRUD событий). Обычный ключ файлов qk_ для этих путей не подходит.

Настройка аккаунта Яндекса, список календарей с сервера и ручной синк доступны по путям /api/v1/calendar-bridge/... — только при входе по сессии в браузере, не по cal_. Фоновая синхронизация для всех пользователей вызывается служебным POST /api/v1/cron/calendar-bridge-sync с секретом CRON_SECRET (настраивается на сервере).

Почта Яндекс (IMAP/SMTP)

Нужна функция тарифа mail_bridge. Раздел: «Почта (IMAP/SMTP)» — /dashboard/mail-bridge. Можно подключить несколько ящиков (несколько аккаунтов Яндекса).

  1. Добавьте ящик: email и пароль приложения Яндекса, при необходимости подпись и глубину синхронизации (дней назад).
  2. Откройте «Папки IMAP» для ящика: загрузите список папок с сервера, отметьте нужные (как правило «Входящие» и другие) и сохраните — синхронизируются только выбранные папки.
  3. Запустите синхронизацию вручную или дождитесь фонового цикла.

Ключи автоматизации с префиксом mail_ выдаются в кабинете почты. Ими вызываются /api/v1/integrations/mail/messages (список и фильтры по датам, параметр folder), /api/v1/integrations/mail/messages/{id} и /api/v1/integrations/mail/send. В запросах к письмам указывайте accountId нужного ящика. Управление ящиками, папками и подписками — через /api/v1/mail-bridge/... только с сессией. Фоновый синк: POST /api/v1/cron/mail-bridge-sync с CRON_SECRET.

Парсинг сайтов

Нужна функция тарифа web_import (квота страниц в месяц зависит от плана). Раздел: /dashboard/web-import — добавление URL, пошаговая загрузка и обработка страниц, экспорт результата, при необходимости вызов AI по извлечённому тексту.

Технические эндпоинты (по сессии пользователя): создание и список задач /api/v1/web-import/jobs, шаг обработки .../jobs/{id}/step, отмена, экспорт, а также /api/v1/web-import/ai для сценариев с моделью. Назначение — получить структурированный текст с веб-страниц для дальнейшей работы в сервисе или в n8n.

Сводка по ключам

  • qk_ — основной API файлов, папок, RAG и большинства разделов из API и интеграции
  • cal_ — только календарь: /api/v1/integrations/calendar/...
  • mail_ — только почта: /api/v1/integrations/mail/...