Перейти к содержимому

Синхронизация с Notion

Свяжите шаблон с одной из своих баз данных Notion — и каждая отправленная форма станет там строкой: она создаётся при отправке формы и обновляется, когда документ потом меняется.

1 · Подключите рабочее пространство Notion

Создайте в Notion внутреннюю интеграцию (на notion.so/my-integrations — ссылка есть в настройках Pocper) и скопируйте её токен (Internal Integration Secret). Вставьте его в Pocper в разделе «Настройки» → «Интеграции» → Notion. Сделать это может только владелец команды; токен хранится в зашифрованном виде. Чтобы сменить его, нажмите «Заменить токен» на той же странице: новый токен проверяется, прежде чем заменить старый.

Затем откройте этой интеграции доступ к базе данных, в которую хотите писать, или к странице, где она находится: откройте её в Notion, выберите ••• → «Connections» → «Add connections» (в некоторых версиях — ••• → «More») и выберите свою интеграцию. Без этого шага базы нет в списке Pocper, а на вставленную ссылку Pocper отвечает, что не находит её.

2 · Свяжите шаблон с базой данных

Откройте у шаблона панель «Рабочая область», выберите вкладку «Интеграция» и нажмите «Связать базу данных Notion». Выберите базу, которую видит ваша интеграция (можно искать по названию), или вставьте ссылку на неё. Первая строка, «Новая база данных», создаёт базу внутри выбранной вами страницы — со столбцом для каждого поля, уже сопоставленным, и столбцом «Pocper ID».

У каждого поля есть список столбцов подходящего типа: поле даты — в столбец даты, флажок — во флажок, текстовое поле — в текстовый столбец или в заголовок. В группе «Сведения об отправке» можно сопоставить ещё клиента, время отправки, статус и того, кто отправил.

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

3 · Что происходит при отправке

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

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

На страницу строки попадают закладка, ведущая обратно к документу, и ответы списком (слишком длинные сокращаются, не больше сотни). В настройках «Интеграция» шаблона тело страницы можно отключить.

4 · Файлы, подписи и дубликаты

Загруженные файлы и подписи могут уходить в столбец «Files & media»: файл копируется в Notion, до 20 МБ (файл больше пропускается и отмечается в журнале синхронизации). Отправка их ссылками в столбец URL — отдельный переключатель, по умолчанию выключенный, потому что такую ссылку любой, кто видит строку, сможет открыть без входа в Pocper.

«Защита от дублей» не даёт повторно отправленной форме появиться дважды: Pocper записывает Pocper ID каждого документа в текстовый столбец с таким названием и находит строку по нему. База, где этот столбец уже есть, использует его; если нет, его добавляет окно связывания (флажок включён по умолчанию) или группа «Настройки» на вкладке «Интеграция» — в одно нажатие.

5 · Изменения, сделанные в Notion

Включите обратную синхронизацию на вкладке «Интеграция» — и из Notion будут возвращаться две вещи. Смена столбца статуса на Submitted, Cancelled или Collected переводит документ в этот статус; правка ячейки, сопоставленной с текстовым полем, флажком, полем даты или времени, записывает значение в документ, и в его истории правка отмечена как пришедшая из Notion. Если обе стороны изменили ячейку, побеждает значение из Notion — кроме случая, когда клиент ещё заполняет форму (не отправлена и сохранена в последние десять минут): тогда остаётся его значение, ячейка в Notion возвращается обратно, а вкладка «Интеграция» это отмечает.

Обратной синхронизации нужен вебхук, который владелец настраивает один раз на команду в Настройках → Интеграции → Notion: создайте URL вебхука, добавьте его как подписку на вкладке Webhooks вашей интеграции в Notion и вставьте обратно токен подтверждения, который пришлёт Notion. Pocper никогда не опрашивает Notion сам, поэтому без вебхука правки в Notion там и остаются. Колонка, которая не может вернуть значение, — подпись, файл, любое поле заблокированного документа — восстанавливается в Notion, а вкладка «Интеграция» это отмечает.

6 · Если что-то пошло не так

Строку, которую не удалось отправить, Pocper повторяет с растущими промежутками в течение суток. Если попытки исчерпаны или Notion отказывает наотрез — токен отозван или к базе больше нет доступа, — синхронизация останавливается, а владелец команды и тот, кто связал базу, получают уведомление в приложении, которое открывает вкладку «Интеграция» документа. Ошибка там подсказывает, что делать; исходное сообщение Notion — по кнопке «Показать сообщение Notion».

Остановленная синхронизация возобновляется сама, как только причина устранена: когда вы переподключаете Notion или заменяете токен в «Настройках», когда Pocper снова читает базу («Перечитать столбцы из Notion» рядом с заголовком «Поля» или любое изменение, сохранённое на вкладке «Интеграция»), или когда документ редактируют. В шаблоне строка «Журнал синхронизации» показывает число ошибок и умеет показывать только их, а у строки вроде «3 документа ещё не в Notion» есть кнопка «Отправить», которая отправляет их все — сначала добавив столбец «Pocper ID», если его нет; разверните её, чтобы увидеть, какие и почему. «Приостановить синхронизацию» рядом с заголовком «Синхронизация» прекращает отправку изменений, пока вы не нажмёте «Возобновить синхронизацию».