Custom Fields — пользовательские поля

(Bot Settings → Custom Fields) — раздел для создания дополнительных полей в карточке клиента.

Обновлено 21 июня 2026 г.5 мин

Custom Fields (Bot Settings → Custom Fields) — раздел для создания дополнительных полей в карточке клиента.

Стандартные поля в Chatterfy уже существуют: имя, username, status и Telegram ID. Но часто этого недостаточно.

Custom Fields позволяют хранить любые дополнительные данные пользователя: ID трейдера, баланс, страну, язык, source, заметку менеджера, дату регистрации, технические ID и другие параметры.

Когда нужны Custom Fields

Например:

партнёрка возвращает trader_id

AI определяет страну пользователя

менеджер оставляет внутреннюю заметку

нужно сохранить сумму депозита

нужно передать данные через webhook

нужно сделать ветвление Flow по данным пользователя.

Custom Fields — это дополнительные переменные пользователя. Поле создаётся один раз в настройках бота, после чего появляется в карточке каждого клиента.

Как заполняются Custom Fields

Поля могут заполняться автоматически или вручную.

Способ	Как работает
Автоматически	Через Webhooks & API, AI Recognition или внешние integrations
Вручную	Оператор заполняет поле в карточке клиента

Вручную поля обычно заполняют для:

заметок

ручной модерации

sales

поддержки

данных из внешних источников.

Где используются Custom Fields

После заполнения значения доступны:

Где используется	Для чего
Condition	Ветвление Flow по данным пользователя
AI	Персонализация логики и ответов
Сообщения	Подстановка данных в текст
Ссылки	Передача параметров во внешние сервисы
Webhook	Обновление или отправка данных
Filters	Фильтрация пользователей
CRM	Отображение данных в карточке клиента

Переменные Custom Fields

Для использования значений применяется формат: {{fields.ключ}}

Примеры:

{{fields.country}}

{{fields.refId}}

{{fields.depositAmount}}

Используйте именно Field Key, а не название поля.

Как создать Custom Field

1. Откройте Custom Fields

Перейдите: Bot Settings → Custom Fields. Если бот новый — список будет пустым.

2. Нажмите Add Custom Field

Нажмите: Add Custom Field. После этого откроется форма создания нового поля.

3. Выберите тип поля

Тип определяет: формат хранения. валидацию. формат ввода.

Тип нельзя изменить после создания. Если выбрали неправильный тип — создайте новое поле. Старое поле можно скрыть через Visible field.

4. Заполните параметры

Для каждого поля задаются:

Параметр	Что означает
Field Key	Технический ключ поля
Name	Название поля для оператора
Visible field	Видимость поля в карточке клиента
Type	Тип данных

Для Select и Multiselect дополнительно задаётся список значений.

5. Нажмите Save

После сохранения поле:

появляется в системе

становится доступно в карточках клиентов

начинает работать в Flow и AI.

Типы полей

Тип	Что хранит	Пример
Text	Короткий текст	Ivan
Long Text	Длинный текст	заметка менеджера
Link	Ссылка	https://site.com
Number	Число	5000
Date	Дата и время	2030-01-30T10:20:30Z
Select	Один вариант из списка	Registered
Multiselect	Несколько вариантов	Football, Tennis

Text

Text — короткое текстовое значение. Подходит для: имени. ID. страны. языка. коротких значений. Пример: India

Long Text

Long Text — длинный текст. Обычно используется для: заметок. комментариев. описаний. внутренних данных.

Link

Link — ссылка. Пример: https://partner.com/user/123

Number

Number — числовое значение. Пример: 5000

Date

Date — дата и время. Формат: 2030-01-30T10:20:30Z. Используется стандарт ISO 8601.

Select

Select позволяет выбрать один вариант из списка. Например: Registered. Deposit. Withdraw. Подходит для: status. страны. языка. категории.

Multiselect

Multiselect позволяет выбрать несколько значений одновременно. Например: Football. Tennis. Crypto. Подходит для: интересов. tags. атрибутов. категорий.

Select и Multiselect — задание списка значений

Для этих типов нужно заранее задать список значений. Каждое значение указывается с новой строки. Пример:

Registered

Deposit

Withdraw

Тип	Отличие
Select	Можно выбрать только один вариант
Multiselect	Можно выбрать несколько вариантов одновременно

Если нужно свободное текстовое значение — используйте Text или Long Text.

Field Key

Field Key — технический ключ поля. Он используется: в webhook. в AI. в переменных. в API. в Flow.

Пример Field Key: depositAmount

Использование в сообщении: {{fields.depositAmount}}

Использование в webhook: ?fields.depositAmount=5000

Для Field Key используйте только латиницу, без пробелов и специальных символов.

Name

Name — отображаемое имя поля. Его видит оператор в CRM.

В Name можно использовать: русский язык. пробелы. эмодзи. Примеры: Сумма депозита. ID трейдера. Страна пользователя.

Field Key и Name — разные вещи.

Field Key	Name
depositAmount	Сумма депозита

Visible field

Visible field определяет, видно ли поле оператору в карточке клиента.

Значение	Что происходит
Visible = ON	Поле отображается в CRM и доступно оператору
Visible = OFF	Поле скрыто в интерфейсе, но продолжает работать в системе

Visible = OFF обычно используется для:

технических данных

внутренних ID

скрытых переменных

служебной логики.

Webhooks, Condition и AI

Webhooks

Webhook может записывать значения в поля. Пример: ?fields.balance=5000. Подробнее: Webhooks & API — приём данных извне.

Condition

Condition может проверять значения полей. Например: country = IN. После этого пользователь может попасть в нужную ветку Flow. Подробнее: Condition — ветвление по условиям.

AI Reply и Send Message

Custom Fields можно использовать в сообщениях и AI. Примеры: {{fields.country}}, {{fields.depositAmount}}.

AI Recognition

AI может извлекать данные из текста, скриншотов или изображений и автоматически записывать их в Custom Fields. Подробнее: AI Recognition — обработка медиа.

Примеры использования

Арбитраж

Партнёрка возвращает: trader_id. Postback или webhook записывает его в: fields.exnovaTraderId.

E-commerce

Создаются поля: orderId, orderTotal, deliveryStatus. Webhook обновляет данные заказа автоматически.

Support

AI определяет категорию обращения: Оплата, Доступ, Технический вопрос — и записывает её в Select-поле.

Что важно учитывать

Тип поля изменить нельзя.

Удалить поле нельзя.

Если ошиблись: создайте новое поле. старое поле скройте через Visible field.

Что должно получиться

После настройки Custom Fields:

карточка клиента становится гибче

AI получает дополнительные данные

Flow может ветвиться по значениям

webhook может сохранять информацию

CRM хранит нужные параметры пользователя.

Если что-то не работает

Поле не появляется

Проверьте:

сохранено ли поле

правильный ли бот открыт

не скрыто ли поле через Visible field.

Значение не записывается через webhook

Проверьте:

существует ли Field Key

правильно ли написан fields.*

нет ли ошибки в запросе.

Переменная пустая

Скорее всего поле:

ещё не заполнено

или используется неправильный Field Key.

Нельзя изменить тип поля

Это ограничение системы. Тип фиксируется после создания.

Частые вопросы

Связанное

Bot Settings

Bot Settings — настройки конкретного бота: имя, AI-модели, поля, теги, уведомления, Sale Status и Webhooks.

Webhooks & API — приём данных извне

С помощью webhook внешний сервис может обновлять данные пользователя, менять status чата, переключать шаги Flow?

AI Recognition — обработка медиа

AI Recognition — обработка медиа через AI AI Recognition — функция внутри Automation & AI, которая позволяет AI обрабатывать медиафайлы пользователя. AI может работать с: голосовыми сообщениями; фотог

Condition — ветвление по условиям

Шаг Condition ветвит flow по полям лида: теги, депозит, время — точные правила без AI-маршрутизации.

Карточка клиента

Карточка клиента — полный профиль лида: переписка, данные, события, медиа, Custom Data и Actions.

Custom Filters — сохранённые выборки

Раздел Bot Settings → Custom Filters — место, где создаются сохранённые фильтры для сегментации лидов.

Sale Status — этапы воронки продаж

Раздел Bot Settings → Sale Status используется для отслеживания этапа, на котором находится лид внутри воронки продаж. Sale Status помогает команде быстро понимать: где сейчас находится пользователь к

Эта статья была полезна?