---
title: "Интеграция Notion: задачи и заметки из мессенджеров в базу Notion"
nav_title: "Notion"
url: https://docs.tuk-tuk.online/integrations/notion
markdown: https://docs.tuk-tuk.online/integrations/notion.md
section: "Интеграции"
description: "Как подключить Notion к tuk-tuk.online по токену внутренней интеграции: выбор базы данных, выдача доступа через Connections, экспорт задач и заметок страницами Notion, проверка подключения."
keywords: ["Notion интеграция", "Notion API токен", "экспорт задач в Notion", "Notion из Telegram", "заметки в Notion", "Notion database id", "Notion internal integration", "Notion Connections"]
lang: ru
product: tuk-tuk.online
app: https://lk.tuk-tuk.online
api_base: https://back.tuk-tuk.online
---

> [!AI] Кратко
> Интеграция Notion подключается по токену внутренней интеграции и базе данных с выданным доступом (Connections); задачи и заметки экспортируются страницами Notion с заголовком в title-свойство и текстом абзацами.
>
> - Где: «Интеграции» → Notion → «Подключить»; поля «Internal Integration Secret» (ntn_… или secret_…) и «База данных по умолчанию» (ссылка или ID, нормализуется в UUID).
> - Предусловие: интеграция добавлена в базу через «•••» → «Connections», иначе Notion возвращает 404.
> - Проверка при подключении: GET /v1/users/me и GET /v1/databases/{id}; сохраняются название базы и имя title-свойства.
> - Экспорт: POST /v1/pages с parent.database_id, Notion-Version 2022-06-28; текст разбивается на абзацы.
> - Кнопка «Проверить» в окне интеграции повторяет проверку и подсказывает, если база по умолчанию не задана.
>
> Связанные страницы: https://docs.tuk-tuk.online/integrations, https://docs.tuk-tuk.online/tasks, https://docs.tuk-tuk.online/integrations/yandex-metrika, https://docs.tuk-tuk.online/chains/blocks/integration

# Интеграция Notion

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

Подключение требует токен внутренней интеграции Notion и базу данных, которой выдан доступ.

## Что синхронизируется

| Данные | Чтение | Запись |
|---|---|---|
| База данных по умолчанию | Заголовок базы и имя свойства-заголовка проверяются при подключении | Нет |
| Страницы в базе | Нет | Создание страницы: заголовок в title-свойство базы, текст абзацами в теле страницы |

## Что нужно на стороне Notion

- Рабочее пространство Notion, где вы владелец или администратор.
- Внутренняя интеграция (Internal integration) с правами «Insert content» и «Read content».
- База данных, к которой этой интеграции выдан доступ.

## Как подключить

### Создать интеграцию в Notion

1. Откройте [notion.so/profile/integrations](https://www.notion.so/profile/integrations) и нажмите «New integration».
2. Выберите рабочее пространство, тип «Internal», отметьте права чтения и вставки контента.
3. Скопируйте «Internal Integration Secret». Новые токены начинаются с `ntn_`, старые начинаются с `secret_`; работают оба.

### Выдать доступ к базе

1. Откройте базу данных в Notion, нажмите «•••» в правом верхнем углу.
2. В разделе «Connections» добавьте созданную интеграцию.
3. Скопируйте ссылку на базу («Copy link») или её ID из адресной строки.

> [!WARNING] Без шага «Connections» Notion отвечает 404 на любой запрос к базе. Платформа покажет подсказку «интеграции не выдан доступ» и не сохранит подключение.

### Подключить в tuk-tuk.online

1. Откройте раздел [Интеграции](https://lk.tuk-tuk.online/integrations), выберите Notion и нажмите «Подключить».
2. Вставьте токен в поле «Internal Integration Secret».
3. В поле «База данных по умолчанию» вставьте ссылку на базу целиком или её ID: платформа сама приведёт ссылку к идентификатору.
4. Нажмите «Подключить»: платформа проверит токен методом `GET /v1/users/me`, прочитает базу, запомнит её название и имя title-свойства.

## Проверить, что работает

1. В окне интеграции нажмите «Проверить»: блок «Состояние подключения» покажет «Токен работает, база «…» доступна».
2. Откройте любой диалог или задачу и выполните «Отправить в Notion»: в базе появится новая страница, а в ответе придёт ссылка на неё.

## Что происходит после подключения

| Действие | Вызов Notion |
|---|---|
| Проверка токена | `GET https://api.notion.com/v1/users/me` |
| Проверка базы | `GET https://api.notion.com/v1/databases/{id}` |
| Экспорт задачи или заметки | `POST https://api.notion.com/v1/pages` с `parent.database_id`, заголовком в title-свойство и абзацами в `children` |

Запросы идут с заголовком `Notion-Version: 2022-06-28`: эта версия принимает `database_id` для баз с одним источником данных. Каждый запрос ограничен 15 секундами.

## Ограничения

- Экспорт создаёт страницу только в базе; страницы-родители без базы не поддерживаются.
- Заголовок попадает в title-свойство базы (как бы оно ни называлось); остальные свойства базы не заполняются.
- Если в базе несколько источников данных (multi-source database), Notion может отклонить создание страницы: оставьте один источник или создайте отдельную базу для экспорта.
- Текст разбивается на абзацы по переносам строк; форматирование Markdown не переносится.

## Частые проблемы

| Проблема | Что делать |
|---|---|
| «База данных Notion не найдена или интеграции не выдан доступ» | Откройте базу → «•••» → «Connections» и добавьте интеграцию |
| «Неверный Integration Token» | Скопируйте секрет заново на странице интеграций Notion; проверьте, что нет лишних пробелов |
| Страница создаётся не в той базе | Проверьте «База данных по умолчанию» в настройках интеграции; при экспорте можно указать другую базу |
| Страница без текста | Текст пустой или состоит только из пробелов: абзацы формируются из непустых строк |