Интеграция отправляет задачи и заметки из кабинета в базу данных Notion. Оператор фиксирует договорённость с клиентом прямо из диалога, и в Notion появляется страница с заголовком и текстом: команда работает в привычном пространстве, ничего не переписывая руками.
Подключение требует токен внутренней интеграции Notion и базу данных, которой выдан доступ.
#Что синхронизируется
| Данные | Чтение | Запись |
|---|---|---|
| База данных по умолчанию | Заголовок базы и имя свойства-заголовка проверяются при подключении | Нет |
| Страницы в базе | Нет | Создание страницы: заголовок в title-свойство базы, текст абзацами в теле страницы |
#Что нужно на стороне Notion
- Рабочее пространство Notion, где вы владелец или администратор.
- Внутренняя интеграция (Internal integration) с правами «Insert content» и «Read content».
- База данных, к которой этой интеграции выдан доступ.
#Как подключить
#Создать интеграцию в Notion
- Откройте notion.so/profile/integrations и нажмите «New integration».
- Выберите рабочее пространство, тип «Internal», отметьте права чтения и вставки контента.
- Скопируйте «Internal Integration Secret». Новые токены начинаются с
ntn_, старые начинаются сsecret_; работают оба.
#Выдать доступ к базе
- Откройте базу данных в Notion, нажмите «•••» в правом верхнем углу.
- В разделе «Connections» добавьте созданную интеграцию.
- Скопируйте ссылку на базу («Copy link») или её ID из адресной строки.
#Подключить в tuk-tuk.online
- Откройте раздел Интеграции, выберите Notion и нажмите «Подключить».
- Вставьте токен в поле «Internal Integration Secret».
- В поле «База данных по умолчанию» вставьте ссылку на базу целиком или её ID: платформа сама приведёт ссылку к идентификатору.
- Нажмите «Подключить»: платформа проверит токен методом
GET /v1/users/me, прочитает базу, запомнит её название и имя title-свойства.
#Проверить, что работает
- В окне интеграции нажмите «Проверить»: блок «Состояние подключения» покажет «Токен работает, база «…» доступна».
- Откройте любой диалог или задачу и выполните «Отправить в 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; проверьте, что нет лишних пробелов |
| Страница создаётся не в той базе | Проверьте «База данных по умолчанию» в настройках интеграции; при экспорте можно указать другую базу |
| Страница без текста | Текст пустой или состоит только из пробелов: абзацы формируются из непустых строк |