Notion

В Notion команда держит то, чего нет ни в задаче, ни в коде: требования, решения, регламенты, ранбуки — и таблицы, в которых ведёт задачи и реестры. Интеграция даёт Buff читать страницы и базы данных отмеченных разделов, когда это нужно для ответа, принимает вопросы прямо в комментариях к странице и умеет оставить результат страницей: отчёт исследования появляется дочерней страницей под той, где спросили.

• Менеджер продаж сверяется с регламентом скидок

  Клиент просит скидку 20 %. Кто её согласует и при каких условиях — записано на странице «Регламент скидок» в Notion, а не в голове менеджера, который пришёл месяц назад.

  Результат. ИИ-агент находит страницу по заголовку, читает её и отвечает по ней: до 15 % — сам, выше — руководитель отдела, и только при годовой оплате. Со ссылкой на источник.

• Реестр, в котором всё записано

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

  Результат. ИИ-агент читает устройство базы, фильтрует записи по нужному свойству и отвечает по строкам таблицы — каждое свойство текстом, как его видит человек.

• Вопрос прямо на странице

  Кто-то читает регламент и не понимает, как он применяется к их случаю. Идти в другой инструмент ради вопроса — лишний шаг, который обычно не делают.

  Результат. Он пишет боту в комментарии к странице. Ответ приходит в ту же ветку обсуждения и остаётся рядом с текстом, о котором спрашивали.

• Исследование остаётся в Notion

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

  Результат. Запрос `/research` в комментарии даёт дочернюю страницу с отчётом — сам текст, а не картинка текста, — и PDF на ней; в ветку приходит ссылка.

1. @buff как у нас называется схема миграций?

   комментарий на любой странице отмеченного раздела

   инструмент: search_pages + get_page

   Внутреннее имя схемы миграций — «Тобольск»: номер собирается как ГГ.ММ.N. Источник: страница «Регламент выпуска релизов», раздел «Схема миграций».

2. @buff какие задачи в работе по экспорту?

   вопрос в приложении Buff или комментарий на странице

   инструмент: get_database + query_database

   В базе «Задачи» две записи про экспорт; в работе одна — «Экспорт в CSV», оценка 3, статус «В работе». Вторая, «Кодировка выгрузки», уже готова. Ссылки на записи — ниже.

3. /research почему выгрузка ломается на кириллице

   комментарий на странице с регламентом

   инструмент: get_page + create_page

   Слово после обращения выбирает работу: без него — короткий ответ, «research» — исследование, «task» — черновик задачи. Отчёт исследования появится дочерней страницей под этой, с PDF; в ветку придёт ссылка.

4. @buff что в этом разделе есть про резервные копии?

   комментарий на родительской странице раздела

   инструмент: get_page_children

   В разделе четыре вложенные страницы; про резервные копии — две: «Резервное копирование» (расписание, срок хранения) и «Восстановление» (порядок и кто утверждает). Обе — по ссылкам.

1. Шаг 1

   Установка занимает одно нажатие

   Откройте раздел «Маркетплейс» на локальной странице коннектора. До установки видно, что интеграция получит: адрес, по которому она сможет ходить, какие учётные данные попросит и сколько инструментов увидит модель. Коннектор скачивает подписанный бандл из нашего реестра и проверяет подпись до того, как что-то запишет на диск.

   Коннектор

   

   ← прокрутите кадр →

2. Шаг 2

   Заведите внутреннюю интеграцию в Notion

   В настройках рабочего пространства создайте внутреннюю интеграцию с правами читать и вставлять содержимое и комментарии. Скопируйте её секрет — это токен для коннектора. Затем подключите интеграцию к корневым страницам разделов через меню «…» → «Подключения»: всё вложенное откроется вместе с ними.

3. Шаг 3

   Настройка — корни, псевдоним и интервал

   Адрес API подставлен. Назовите корни — ссылки или идентификаторы страниц и баз данных, через запятую (пусто — всё открытое интеграции), короткое имя бота, например `buff`, и при желании интервал опроса. Секрет хранится на вашей машине; интеграция его не видит.

   Коннектор

   

   ← прокрутите кадр →

4. Шаг 4

   Обращайтесь словом, не через @

   Интеграцию в Notion нельзя упомянуть через @ — она не человек. Пишите её имя текстом: `@buff как у нас принято…` или `/research …`. Регистр не важен.

5. Шаг 5

   То же самое из командной строки

   Установка без графики равноправна, а не запасной вариант: `connector install notion`, затем `connector instance set --plugin notion --version 1.0.0 --set roots=https://www.notion.so/… --poll 5`.

6. Шаг 6

   События приходят сами

   Опрос работает всегда и портов не требует. Чтобы ответы приходили через секунды, включите приём событий у коннектора, укажите выданную ссылку в вебхуках интеграции Notion и подтвердите подписку токеном, который коннектор покажет на странице подключения; подпишитесь на событие comment.created.

   Коннектор

   

   ← прокрутите кадр →

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

• Notion — облачный; версия API 2026-03-11 (чтение и запись страниц как markdown, файловые загрузки).
• Внутренняя интеграция Notion с правами читать и вставлять содержимое и комментарии; чтение сведений о пользователях — по желанию, для имён авторов.
• Интеграция подключена к корневым страницам или базам данных разделов, где работает бот.
• Коннектор версии 0.8 или новее: интервал опроса на подключение и токен подписи от источника появились в нём; старый коннектор откажется ставить интеграцию и назовёт обе версии.
• Сетевой доступ от машины с коннектором до api.notion.com — наружу из вашей сети ничего открывать не нужно; вебхук — по желанию, только для скорости.
• Коннектор, запущенный с правом заводить отдельного пользователя ОС для интеграции (root или CAP_SETUID).

Вы скопируете наш Notion к себе?

Нет. Интеграция читает страницы и записи по запросу модели, когда ответ этого требует, и ничего не переносит и не индексирует заранее. Прочитанное попадает в контекст конкретного ответа — не в хранилище.

Почему бот не отвечает, если написать @ и выбрать интеграцию?

Потому что Notion не даёт выбрать интеграцию в подсказке @ — она не человек. Напишите имя словом: `@buff …` или используйте команду через слэш.

Бот сможет что-то изменить на страницах?

Существующие страницы и записи баз он не редактирует. Он пишет комментарии и создаёт новые страницы — только внутри области и только когда его об этом попросили: отчёт исследования или прямой запрос модели на пишущей стадии.

Notion ищет только по заголовкам — как бот найдёт страницу по её тексту?

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

Как ограничить, что он видит?

Двумя способами сразу: подключайте интеграцию в Notion только к нужным разделам и перечисляйте корни в настройке подключения. Пустой список корней означает «всё, что открыто интеграции», — так что первая граница обязательна.

Зачем опрос раз в 5 секунд, если есть вебхук?

Вебхук — основной путь, опрос — страховка на случай, если вызов не дошёл. Холостой проход стоит один запрос к Notion, это укладывается в его лимит с запасом; интервал можно увеличить в настройках подключения.