# Notion — интеграция для Buff

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

[Маркетплейс](https://buff.systems/marketplace) Notion

# Notion

Документы компании · издатель buff · версия 1.1.0

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

[Скачать коннектор](https://buff.systems/downloads) [Как установить](https://buff.systems/#usage) 6 из 8 инструментов только читают

- Ответ в Buff опирается на базу задач в Notion — с названием базы и её записей.
- Форма настройки: адрес, корневые страницы и базы данных и токен интеграции.
- Подключение работает: восемь инструментов, из них шесть только читают (зелёные).
- Проверка связи называет рабочее пространство, интеграцию и сколько отмеченных страниц ей доступно.
- Что интеграция получит, написано в её карточке в каталоге коннектора.

Нажмите на снимок, чтобы открыть его целиком. Все снимки — с работающей установки.

## Обзор

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

## Сценарии

Ситуации, ради которых его ставят.

- ### Менеджер продаж сверяется с регламентом скидок Клиент просит скидку 20 %. Кто её согласует и при каких условиях — записано на странице «Регламент скидок» в Notion, а не в голове менеджера, который пришёл месяц назад. Результат. ИИ-агент находит страницу по заголовку, читает её и отвечает по ней: до 15 % — сам, выше — руководитель отдела, и только при годовой оплате. Со ссылкой на источник.
- ### Реестр, в котором всё записано Договорённости с клиентами продакт ведёт базой данных Notion: строка на клиента, свойства — что обещали, срок, ответственный. В вопросе «что мы обещали «Ромашке»» никто эту таблицу не пересказывает. Результат. ИИ-агент читает устройство базы, фильтрует записи по нужному свойству и отвечает по строкам таблицы — каждое свойство текстом, как его видит человек.
- ### Вопрос прямо на странице Кто-то читает регламент и не понимает, как он применяется к их случаю. Идти в другой инструмент ради вопроса — лишний шаг, который обычно не делают. Результат. Он пишет боту в комментарии к странице. Ответ приходит в ту же ветку обсуждения и остаётся рядом с текстом, о котором спрашивали.
- ### Исследование остаётся в Notion Нужно разобраться, почему выгрузка ломается на кириллице, и оставить разбор там, где команда его найдёт через полгода, — а не в переписке. Результат. Запрос \`/research\` в комментарии даёт дочернюю страницу с отчётом — сам текст, а не картинка текста, — и PDF на ней; в ветку приходит ссылка.

## Примеры

Что написать и что придёт в ответ. Обращение к боту задаётся в настройках подключения — здесь это «@buff».

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` В разделе четыре вложенные страницы; про резервные копии — две: «Резервное копирование» (расписание, срок хранения) и «Восстановление» (порядок и кто утверждает). Обе — по ссылкам.

## Что умеет

### Читает то, что нужно, и тогда, когда нужно

search\_pages ищет по заголовкам через Notion и по тексту страниц области своими силами — сам Notion ищет только по заголовкам, а вопрос обычно о том, что на странице написано. get\_page отдаёт страницу целиком вместе с обсуждением, get\_page\_children — вложенное, get\_database и query\_database — устройство базы и её записи. Модель вызывает их сама, когда вопрос этого требует: ничего не копируется к нам заранее и не индексируется, а платите вы за то, что реально прочитано.

### Страница приходит как markdown

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

### Отвечает там, где спросили — и страницей, когда это отчёт

Упоминание бота словом или команда через слэш в комментарии запускает вопрос, исследование или черновик задачи; ответ приходит в ту же ветку обсуждения. Отчёт исследования — дочерняя страница под той, где спросили, с текстом и PDF; в ветку приходит ссылка на неё.

### Корни — это область

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

### События — вебхуком, опрос — страховкой

У Notion нет ленты комментариев, поэтому его вызов разбирается: событие comment.created называет комментарий, и ответ приходит через секунды. Опрос обходит страницы области по кругу как страховка — по умолчанию раз в 5 секунд, интервал меняется в настройках подключения. Лимиты Notion интеграция уважает: ответ 429 выжидается так, как просит сам Notion.

### Токен подписи получает сам коннектор

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

## Как пользоваться

Всё происходит на машине, где стоит коннектор. Открывать доступ к вашей сети снаружи не нужно ни на одном шаге.

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. **Коннектор** ← прокрутите кадр → У каждого подключения — свой набор инструментов и свой разрешённый адрес.

## Границы доступа

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

Ходит наружу

только по адресам из полей `base_url`

Учётные данные

api — значения остаются в коннекторе, интеграция их не видит

Вебхуки

deliver — порт открываете вы, по желанию

| Инструмент | Что делает | Доступ |
| --- | --- | --- |
| search\_pages | Найти страницы и базы данных по словам в заголовке — когда ответ может быть уже записан в Notion | только чтение |
| get\_page | Прочитать страницу целиком — текстом с заголовками, списками, таблицами и кодом — вместе с обсуждением | только чтение |
| get\_page\_children | Перечислить вложенные страницы и базы данных раздела — когда ответ собирается из нескольких страниц | только чтение |
| get\_database | Устройство базы данных — её источники данных и свойства с типами | только чтение |
| query\_database | Прочитать записи базы данных, при желании отфильтровав по значению свойства | только чтение |
| get\_comments | Обсуждения страницы — ветки комментариев, кто и когда писал | только чтение |
| add\_comment | Написать комментарий на странице или ответить в ветке обсуждения | пишет |
| create\_page | Создать страницу внутри одной из подключённых страниц — из markdown | пишет |

Интеграция работает отдельным процессом под собственным пользователем операционной системы: она не видит ключа коннектора, не читает файлы других подключений и не может выйти в сеть мимо коннектора. Подробнее — в [разделе о безопасности](https://buff.systems/security).

## Требования

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

## Вопросы

- **Вы скопируете наш Notion к себе?**: Нет. Интеграция читает страницы и записи по запросу модели, когда ответ этого требует, и ничего не переносит и не индексирует заранее. Прочитанное попадает в контекст конкретного ответа — не в хранилище.
- **Почему бот не отвечает, если написать @ и выбрать интеграцию?**: Потому что Notion не даёт выбрать интеграцию в подсказке @ — она не человек. Напишите имя словом: \`@buff …\` или используйте команду через слэш.
- **Бот сможет что-то изменить на страницах?**: Существующие страницы и записи баз он не редактирует. Он пишет комментарии и создаёт новые страницы — только внутри области и только когда его об этом попросили: отчёт исследования или прямой запрос модели на пишущей стадии.
- **Notion ищет только по заголовкам — как бот найдёт страницу по её тексту?**: Своими силами: если заголовки не подошли, интеграция читает страницы области и ищет слова в тексте, сравнивая их по основе, — падежи не мешают. Страница читается один раз до следующей правки, поэтому второй вопрос по той же области уже ничего не стоит. В большой области первый поиск занимает заметное время.
- **Как ограничить, что он видит?**: Двумя способами сразу: подключайте интеграцию в Notion только к нужным разделам и перечисляйте корни в настройке подключения. Пустой список корней означает «всё, что открыто интеграции», — так что первая граница обязательна.
- **Зачем опрос раз в 5 секунд, если есть вебхук?**: Вебхук — основной путь, опрос — страховка на случай, если вызов не дошёл. Холостой проход стоит один запрос к Notion, это укладывается в его лимит с запасом; интервал можно увеличить в настройках подключения.

Коротко

- **Версия**: 1.1.0
- **Издатель**: buff
- **Обновлён**: 2026-10-05
- **Размер**: 33 КБ
- **Инструментов**: 8, только читают 6
- **Учётные данные**: api
- **Вебхуки**: deliver
- **Платформы**: linux-x86\_64, linux-aarch64

[Документация коннектора](https://buff.systems/docs/connector) [Как это устроено с точки зрения ИБ](https://buff.systems/security) [Задать вопрос об интеграции](https://buff.systems/contact)

На этой странице

- [Обзор](https://buff.systems/#overview)
- [Сценарии](https://buff.systems/#use-cases)
- [Примеры](https://buff.systems/#examples)
- [Что умеет](https://buff.systems/#abilities)
- [Как пользоваться](https://buff.systems/#usage)
- [Границы доступа](https://buff.systems/#access)
- [Требования](https://buff.systems/#requirements)
- [Вопросы](https://buff.systems/#faq)

Дальше

## Подключить Notion

Поставьте коннектор в своей сети, откройте его локальную страницу и установите интеграцию из каталога. Пересобирать ничего не нужно.

[Скачать коннектор](https://buff.systems/app) [Написать нам](mailto:info@buff.systems)

Юрлицам и ИП — оплата переводом по реквизитам и закрывающие документы