# Интеграция Baserow и n8n - вебхуки, узлы и REST API

> Подключите open-source Baserow к n8n: аутентификация по токену базы данных, узел с пятью операциями над строками и сценарии синхронизации с CRM и формами.

Source: https://opennix.org/docs/baserow/integrations/n8n/


n8n - платформа автоматизации с визуальным конструктором, которая через официальный узел (node) Baserow подключает базы данных к сотням внешних сервисов: без единой строки кода можно создавать, читать, обновлять и удалять строки таблиц, а также запускать сценарии по расписанию или по вебхуку от изменений в данных.

## Обзор

Узел Baserow в n8n даёт визуальный доступ к [REST API базы данных](/docs/baserow/webhook-api/database-api/): вместо ручных HTTP-запросов пользователь перетаскивает готовый блок в рабочий процесс (workflow) и настраивает его через форму. Это удобно для синхронизации данных между системами, обработки заявок из форм, генерации отчётов и реакции на изменения в таблицах.

![Узел Baserow в конструкторе рабочих процессов n8n](/images/baserow/integrations/n8n-node-overview.jpg)

## Что нужно для начала работы

- Аккаунт Baserow (облачный или self-hosted).
- Аккаунт n8n (облачный сервис или self-hosted экземпляр).
- Учётные данные для входа в Baserow или заранее созданный [токен базы данных](/docs/baserow/webhook-api/personal-api-tokens/).
- Идентификаторы таблиц, которые нужно автоматизировать - их видно в [документации Database API](/docs/baserow/webhook-api/database-api/) конкретной базы.

## Поддерживаемые операции

Узел Baserow в n8n поддерживает пять базовых операций над строками таблицы.

| Операция | Что делает | Типичный сценарий |
|---|---|---|
| **Create a row** (создать строку) | Добавляет новую строку в таблицу | Сохранение заявок из формы, добавление контактов в CRM |
| **Get a row** (получить строку) | Возвращает конкретную строку по идентификатору | Получение данных клиента, поиск записи |
| **Get many rows** (получить строки) | Возвращает набор строк с учётом фильтров | Формирование отчётов, выгрузка данных |
| **Update a row** (обновить строку) | Изменяет существующую строку | Обновление статуса заказа, правка контакта |
| **Delete a row** (удалить строку) | Удаляет строку из таблицы | Очистка тестовых данных, архивирование записей |

## Аутентификация Baserow в n8n

Узел Baserow поддерживает два способа подключения - настраиваются один раз в учётных данных (credentials) и затем переиспользуются во всех рабочих процессах.

**По токену базы данных.** Создайте [токен базы данных](/docs/baserow/webhook-api/personal-api-tokens/) в настройках рабочего пространства Baserow и укажите его в поле `Database Token` при создании учётных данных в n8n. Это рекомендуемый способ: токен можно ограничить конкретным рабочим пространством и отозвать в любой момент, не меняя пароль аккаунта.

**По логину и паролю.** Вариант `Basic Auth` использует email и пароль от аккаунта Baserow напрямую. Он проще в настройке, но токен предпочтительнее там, где учётные данные передаются нескольким рабочим процессам или интеграциям.

Порядок настройки одинаков для обоих способов:

1. В n8n нажмите **+ Create** и выберите **Credential**.
2. Найдите в списке типов **Baserow API** и нажмите **Continue**.
3. Укажите **Host URL**: `https://api.baserow.io` для облачного Baserow или адрес API self-hosted экземпляра.
4. Выберите способ аутентификации и заполните `Database Token` либо `Username` и `Password`.
5. Нажмите **Save** - n8n автоматически проверит соединение.

Заведите отдельные учётные данные для продакшена и разработки, чтобы рабочие процессы оставались понятными.

## Создание строки в Baserow через n8n

Пример показывает, как добавить данные в таблицу Baserow из рабочего процесса n8n.

1. Перетащите узел **Baserow** на холст и соедините его с узлом-триггером (вебхук, расписание и так далее).
2. В поле **Operation** выберите **Create**, затем укажите сохранённые учётные данные Baserow.
3. Укажите **Table ID** - его видно в автоматически сгенерированной документации Database API - и заполните значения полей, при необходимости сопоставив их с данными из предыдущих узлов.
4. Нажмите **Execute Node**, чтобы проверить создание строки, и активируйте рабочий процесс.

## Примеры автоматизации

- **Синхронизация с CRM.** Держите записи клиентов согласованными между Baserow и CRM-системой: изменение контакта в одной системе автоматически обновляет вторую.
- **Обработка форм.** Принимайте заявки из форм, проверяйте данные и сохраняйте их в таблицу Baserow, добавляя уведомление по email о каждой новой записи.
- **Регулярная отчётность.** Запрашивайте данные Baserow по расписанию, формируйте отчёт и отправляйте его по email или в мессенджер - удобно для еженедельных сводок.
- **Сценарии по вебхукам.** Настройте [вебхук Baserow](/docs/baserow/webhook-api/webhooks/) на событие изменения строки, чтобы n8n запускал рабочий процесс сразу после появления новых данных.
- **Бэкенд для мобильных приложений.** Читайте и записывайте данные в таблицы Baserow через рабочие процессы n8n, не разворачивая отдельный сервер под бизнес-логику.

## Часто задаваемые вопросы

**Чем n8n отличается от прямого использования Database API?** Database API требует писать код для HTTP-запросов. Узел n8n даёт визуальный интерфейс: рабочий процесс собирается перетаскиванием блоков. Выбирайте n8n для автоматизации без кода, а прямой [REST API](/docs/baserow/webhook-api/database-api/) - для собственных приложений.

**Работает ли узел с self-hosted Baserow?** Да. При настройке учётных данных достаточно заменить Host URL с `https://api.baserow.io` на адрес API своего экземпляра - облачная и self-hosted версии поддерживают одинаковый набор операций.

**Как найти Table ID для рабочего процесса?** Откройте базу данных в Baserow, нажмите значок с тремя точками и выберите пункт документации API - там перечислены идентификаторы всех таблиц, названия полей и доступные эндпоинты.

**Нужны ли отдельные учётные данные для каждой базы?** Нет. Один набор учётных данных Baserow в n8n даёт доступ ко всем базам и таблицам рабочего пространства - конкретная таблица выбирается уже при настройке узла.

**Можно ли передавать большие объёмы данных?** Да, с постраничной выборкой. Операция **Get many** поддерживает параметры пагинации; для массовых операций разумно разбивать рабочий процесс на более мелкие партии, чтобы избежать таймаутов.

Следующий шаг - статья [«Интеграция Baserow с ToolJet»](/docs/baserow/integrations/tooljet/): как подключить low-code конструктор интерфейсов к таблицам Baserow через тот же REST API.