Конвертер
Что такое Конвертер
Конвертер — это инструмент, который объясняет боту, в каком виде записывать данные в таблицу.
Представьте, что вы даёте боту шаблон: «Когда будешь записывать данные, клади их вот так: имя — в колонку A, возраст — в колонку B, почту — в колонку C».
Этот шаблон и есть Конвертер.
📌 Конвертер используется в реакции WriteGoogleTable (запись в таблицу). Без конвертера вы можете записывать данные только вручную (через JSON или YAML).
Где находится Конвертер
Настройки → Интеграции → кнопка над «Google»
В разделе — список всех ваших конвертеров с возможностью:
- 🔍 Поиска по названию
- 📄 Постраничной навигации
- ➕ Создания новых конвертеров
Как создать Конвертер
Нажмите «Создать» и укажите:
| Поле | Что это |
|---|---|
| Название | Как вы назовёте этот шаблон (например, «Пользователи» или «Заказы») |
| Ориентация | Как будут добавляться новые записи (см. ниже) |
Ориентация данных
| Ориентация | Что значит | Когда использовать |
|---|---|---|
| Rows (строки) | Каждая новая запись = новая строка в таблице | 📌 Самый частый вариант. Например, список клиентов: каждый клиент — отдельная строка |
| Columns (столбцы) | Каждая новая запись = новый столбец | Используется реже. Например, сбор данных по дням: каждый день — новый столбец |
⚠️ Важно: Ориентацию нельзя изменить после создания конвертера. Выбирайте внимательно!
Что внутри Конвертера
Конвертер состоит из элементов (столбцов или строк, в зависимости от ориентации).
Каждый элемент — это одно поле данных.
Что содержит элемент
| Параметр | Описание |
|---|---|
| Название | Необязательное название поля (например, «Имя пользователя»). Помогает ориентироваться в конвертере |
| Тип данных | Что именно записывать. Пока доступен только тип «Произвольное значение» |
| Адрес | Фиксированная позиция: |
| — при ориентации Rows → фиксированная колонка (буква A, B, C…) | |
| — при ориентации Columns → фиксированная строка (номер 1, 2, 3…) | |
| Текст | Для типа «Произвольное значение» — что именно записывать. Можно использовать переменные и макросы |
Типы данных
Платформа поддерживает следующие типы данных (в разработке — пока доступен только один):
| Тип | Описание | Доступность |
|---|---|---|
| Произвольное значение | Текст с поддержкой переменных (${user.name}) и макросов (!{time}) |
✅ Доступен |
| Колонки пользователя | id, имя, username, статус, дата первого контакта, дата запуска бота | 🚧 В разработке |
Карточка конвертера
У каждого конвертера есть карточка с действиями:
| Действие | Описание |
|---|---|
| ✏️ Переименовать | Изменить название конвертера |
| 🗑️ Удалить | Безвозвратно удалить конвертер |
| ➕ Добавить элемент | Добавить новый столбец или строку (в зависимости от ориентации) |
| 📋 Список элементов | Просмотр всех элементов внутри конвертера |
Пример использования
Задача
Вы создаёте бота, который собирает данные о новых подписчиках.
Нужно записывать в таблицу: имя, email и дату подписки.
Решение
- Создаёте конвертер «Новые подписчики» с ориентацией Rows (строки)
- Добавляете элементы:
| Элемент | Адрес | Значение |
|---|---|---|
| Имя | A | ${user.first_name} |
| B | ${user.email} |
|
| Дата | C | `!{time |
- В реакции WriteGoogleTable выбираете этот конвертер
Результат
При каждом новом подписчике бот автоматически:
- Записывает имя в колонку A
- Записывает email в колонку B
- Записывает текущую дату в колонку C
Каждый новый подписчик — новая строка в таблице.
Важно
| Правило | Описание |
|---|---|
| ⚖️ Взаимоисключение | Конвертер и ручной ввод данных — взаимоисключающие опции. Либо вы используете конвертер, либо вводите данные вручную (JSON/YAML) |
| 🔒 Неизменяемость | Ориентацию конвертера нельзя изменить после создания |
| 🔗 Переменные | В поле «Текст» можно использовать любые переменные (${...}) и макросы (!{...}) |
Связь с другими разделами
| Раздел | Связь |
|---|---|
| Google Таблицы | Конвертер используется для записи в таблицы |
| WriteGoogleTable | Реакция, в которой применяется конвертер |
| Переменные | Данные, которые можно подставлять в конвертер |
| Макросы | Функции для преобразования данных в конвертере |