Slack

Renta отправляет строки из вашего хранилища данных в канал Slack: сообщением на каждую изменившуюся строку, по несколько строк в одном сообщении, текстовой таблицей или CSV-файлом.

Сообщение вы пишете один раз как шаблон с плейсхолдерами {{ column }}, а Renta заполняет его для каждой строки. Для изменившейся строки можно показать прежнее значение рядом с новым.

Аутентификация

Renta авторизуется через Slack OAuth. Авторизация действует на один воркспейс, поэтому выберите тот воркспейс Slack, в который будет писать пайплайн.

Slack запрашивает права на список публичных и приватных каналов, отправку сообщений, отправку в публичные каналы без вступления бота, отправку под своим именем и иконкой и загрузку файлов. Список каналов Renta читает, чтобы заполнить список Channel, остальные права использует при запуске пайплайна.

Чтобы писать в приватный канал, откройте его в Slack и введите /invite @Renta. Публичным каналам приглашение не нужно.

Подготовка модели данных

Пайплайн Reverse ETL читает данные из модели данных: это SQL-запрос, сохранённый в разделе Context layers, который решает, какие строки хранилища синхронизировать и что лежит в каждой строке. Создайте её до пайплайна, потому что редактор шаблонов и маппер колонок заполняются колонками модели.

Называйте колонки так, как хотите ссылаться на них в сообщении. Колонка email вставляется как {{ email }}. Колонка с пробелом в имени или с цифрой в начале тоже доступна: {{ row["signup date"] }}.

При сохранении модели отметьте колонку, которая опознаёт строку, как ключ. В режиме Message по ключу Renta отличает изменившуюся строку от новой. Шаги одинаковы для любого хранилища, см. Создание модели данных.

Настройка пайплайна

На последнем шаге выберите, как Renta отправляет строки, куда они уходят и что написано в каждом сообщении. Форма подстраивается под выбранный режим, поэтому начните с него.

Как Renta отправляет данные

Выберите один из четырёх режимов. Первый следит за изменениями в модели. Остальные три отправляют весь результат модели на каждом запуске.

Модель данных и канал

Укажите пайплайну, откуда брать данные и в какой канал их писать.

1. Data model.
   Выберите модель данных для отправки. Из неё Renta читает строки и имена колонок.
2. Channel.
   Выберите канал для сообщений. В списке публичные каналы воркспейса и приватные каналы, куда приглашён бот.
3. Channel from a column.
   Доступно в режиме Message. Выберите колонку с ID канала Slack, например C0123456789, чтобы каждая строка уходила в свой канал. Строка с пустым значением пропускается и попадает в журнал запуска. Бот должен иметь право писать в каждый канал из этой колонки.

Формат сообщения и первый запуск

Выберите, как Renta читает шаблоны и что первый запуск делает со строками, которые уже есть.

1. Message format Выберите синтаксис шаблонов.

   Формат	Описание
   Plain text	Renta отправляет заполненный шаблон как текст сообщения. Работает форматирование Slack: *жирный*, _курсив_, <https://example.com|текст ссылки> и упоминания <@USER_ID>.
   Slack Block Kit	Шаблон представляет собой JSON-массив блоков Block Kit. При сохранении Renta проверяет, что это валидный JSON, и заполняет плейсхолдеры для каждой строки. Внутри блоков используйте текстовые объекты mrkdwn.

2. First run Доступно в режиме Message.

   Вариант	Описание
   Skip existing rows	Первый запуск запоминает строки и ничего не отправляет. Сообщения начинаются со следующего изменения. Это значение по умолчанию.
   Send a message for every row	Первый запуск отправляет сообщение о добавленной строке для каждой строки модели.

Шаблоны сообщений

В режиме Message вы пишете до трёх шаблонов, по одному на вид изменения. Введите в редакторе {{, чтобы выбрать колонку или переменную, или нажмите чип под редактором. Счётчик в углу показывает длину шаблона относительно лимита в 4 000 символов.

Кроме колонок модели, в любом шаблоне доступны переменные запуска.

Renta экранирует символы &, < и > в значениях колонок, поэтому значение, похожее на разметку, показывается как текст. Если колонка уже содержит разметку Slack, например готовую ссылку, добавьте фильтр safe: {{ link_column | safe }}.

Удалённые строки и бот

Завершите настройку сообщений шаблоном для удалённой строки и внешним видом бота.

1. Message when a row is removed.
   Отправляется для строки, которая исчезла из модели. Шаблону доступны последние известные значения строки.
2. Bot name.
   Renta пишет под этим именем, до 80 символов. Оставьте поле пустым, чтобы писать под именем приложения Slack.
3. Bot icon emoji.
   Код эмодзи с двоеточиями, например :chart_with_upwards_trend:. Оставьте поле пустым, чтобы сохранить иконку приложения.

Поведение при удалении строки

Укажите, что происходит в Slack, когда строка исчезает из модели данных. Настройка доступна в режиме Message.

Затем назовите пайплайн. Integration name это имя вашего пайплайна. Измените его по своему усмотрению.

Batch message

В режиме Batch message Renta заполняет шаблон строки для каждой строки и собирает строки в сообщения.

1. Rows per message.
   Сколько строк попадает в одно сообщение, от 1 до 50.
   Default: 10
2. Message header.
   Текст в начале каждого сообщения. Шапке доступны переменные запуска, например {{ model_name }}, но не колонки.

3. Text for each row.
   Шаблон, который Renta повторяет для каждой строки. Обязательный.
4. Message footer.
   Текст в конце каждого сообщения. Как и шапке, ему доступны только переменные запуска.

Сообщение, строки которого занимают больше 4 000 символов, отклоняется с подсказкой уменьшить Rows per message. В формате Slack Block Kit шаблон строки должен давать JSON-массив блоков. Шапка и подвал становятся блоками section вокруг строк, а в одном сообщении не больше 50 блоков.

Table и CSV

В режимах Table и CSV шаблонов нет. Вместо этого сопоставьте колонки модели с колонками таблицы или файла.

При создании пайплайна сопоставлены все колонки модели. Уберите лишние, переименуйте заголовки или добавьте новые через Add mapping:

В режиме Table Renta отправляет результат моноширинной таблицей в одном или нескольких сообщениях, в каждом из них повторяется строка заголовков. Ячейка длиннее 60 символов обрезается с многоточием. В режиме CSV Renta загружает один файл с именем из названия модели и даты запуска, например signups_2026-10-21.csv, с заголовками в первой строке. В обоих режимах необязательный Message header отправляется текстом над таблицей или файлом.

Расписание

Выберите, как часто запускается пайплайн.

Для расписания Daily укажите Update time (точное время старта каждого запуска) и нажмите Create pipeline.

Новый пайплайн появится в разделе Pipelines на вкладке Reverse ETL, где видно его запуски и прогресс.

Стратегия синхронизации

В режиме Message Renta синхронизирует данные инкрементально. Запуск сравнивает модель данных с состоянием, записанным на прошлом запуске, и отправляет сообщения только по строкам, которые изменились. Первому запуску сравнивать не с чем, поэтому он запоминает строки и ничего не отправляет, если в First run не выбрана отправка всех строк.

Режимы Batch message, Table и CSV отправляют весь результат модели на каждом запуске, менялись строки или нет.

Ограничения

В таблице собраны пределы, на которые может наткнуться запуск, и что Renta делает в этом случае.