Поля диалога — это карточка с данными, которые система сама вытаскивает из переписки (и из отклика на вакансию, если это Авито Работа).

Вы один раз задаёте нужные поля — например «Гражданство», «Телефон», «Бюджет», «Район» — и дальше:

- значения появляются в карточке диалога в WebCS;
- их можно править вручную;
- их можно подставлять в дополнительные поля AmoCRM / Bitrix24.

Типичные задачи:
- сразу видеть гражданство кандидата при отклике на вакансию;
- передавать телефон, имя, бюджет или район в сделку CRM без копирования из чата;
- хранить в диалоге важные детали, которые клиент написал текстом.

Как это работает — коротко

Сообщение в чате → разбор полей → карточка диалога → (опционально) Amo / Bitrix

1. Вы настраиваете список полей в Настройки сообщений → Поля диалога.
2. При входящем или системном сообщении система запускает разбор в фоне.
3. Найденные значения записываются в блок «Данные диалога» в карточке чата.
4. Если в Amo/Bitrix для доп. поля указан плейсхолдер {df....}, значение уходит в сделку.

Разбор использует AI и, где возможно, данные без AI: телефон из чата, системные блоки вида «Подпись — значение», данные отклика на вакансию.

Важно: за AI-разбор списываются токены с баланса пользователя. Если токенов мало, разбор пропускается (в логах диалога будет пометка).

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

Откройте:
Сообщения → Настройки → вкладка «Поля диалога»

Как добавить поле

1. Нажмите «Добавить поле».

2. Заполните:
   Название поля - Как поле будет видно в карточке. Например: Гражданство, Телефон, Бюджет
   Подсказка для AI - Необязательно. Уточнение, как искать значение. Например: Страна гражданства кандидата или Озвученная цена в рублях
   Включено - Если выключить — поле не разбирается и не показывается в карточке
   Обновлять при новых сообщениях - Если выключено — после первого заполнения AI больше не перезаписывает значение. Если включено — при новых сообщениях значение может обновиться

3. Нажмите «Сохранить».

После сохранения у поля появится плейсхолдер вида {df.xxxxxxxx} — он понадобится для Amo/Bitrix.

Технический код поля (id) генерируется сам. Вам его руками вводить не нужно — достаточно названия.

Примеры полей:

Где смотреть данные в диалоге

Откройте чат в WebCS. Справа в карточке появится блок «Данные диалога» — если хотя бы одно поле включено.

В блоке:
- список ваших полей и текущие значения;
- кнопка «Разобрать» — вручную запустить разбор сейчас;
- кнопка ✓ рядом с полем — сохранить значение вручную.

Рядом с названием поля может отображаться источник:
ai - Извлечено AI из переписки
job_api - Из отклика на вакансию (Авито Работа)
system_regex - Из текста/системного сообщения или телефона в чате
manual - Вы сохранили значение вручную

Автоматический и ручной разбор

Автоматически
Разбор запускается сам на входящие сообщения клиента и на системные сообщения Avito (например, отклик на вакансию).

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

Кнопка «Разобрать»

Нужна, если:
- вы только что добавили новые поля и хотите пройти старую переписку;
- значение не подтянулось, а вы хотите перезапустить разбор.

После нажатия:
- появится уведомление, что разбор запущен;
- через несколько секунд значения подставятся в поля сами (если вы онлайн в WebCS).

Если ничего не нашлось — поля останутся пустыми.

Ручное редактирование
1. Введите или измените значение в поле.
2. Нажмите ✓.

После сохранения:
- значение помечается как manual («Защищено от AI»), AI больше не перезапишет его, пока вы не нажмёте «разрешить авто».
- если поле связано с Amo/Bitrix — значение уйдёт в CRM (см. ниже).
- если AI нашёл данные с низкой уверенностью, под полем может появиться «Предложение AI», его можно принять одной кнопкой.

Связь с AmoCRM и Bitrix24

Поля диалога сами по себе живут в карточке чата. Чтобы они попали в CRM, нужно один раз привязать их к дополнительным полям:

Шаг 1. Создайте поле в настройках AvChat
Например: Гражданство → после сохранения появится плейсхолдер {df.ab12cd34}.

Шаг 2. Укажите плейсхолдер в доп. полях CRM

Откройте настройки интеграции:
AmoCRM → Дополнительные поля, или
Bitrix24 → Дополнительные поля

В нужном текстовом / числовом / URL-поле выберите из меню {} ваш пункт:

{df.ab12cd34} - Гражданство (поле диалога)

Можно вставить и вручную.

Шаг 3. Когда значение уйдёт в сделку

Значение обновляется в CRM, если:
1. у диалога уже есть сделка/лид;
2. в доп. поле CRM стоит плейсхолдер {df....} этого поля;
3. значение поля изменилось (авторазбор или ручное сохранение ✓).

Если сделки ещё нет — сначала создайте/отправьте диалог в Amo или Bitrix как обычно. При создании сделки плейсхолдеры {df....} тоже подставляются, если значение уже есть в карточке.

Важно про конфликты

Если менеджер вручную поменял то же поле уже в самой CRM, AvChat старается не затирать это изменение повторным автообновлением.

Для полей типа select в Amo значение должно совпадать с ID варианта списка (enum). Обычный текст в select может не записаться — для таких случаев удобнее текстовое поле CRM.

Особенности для вакансий (Авито Работа)

Если объявление — вакансия (vakansii в ссылке), система дополнительно пытается взять данные из отклика:
- гражданство;
- возраст (считается из даты рождения);
- имя / ФИО;
- телефон.

Для этого в настройках должны быть поля с такими названиями (без учёта регистра), например:
Гражданство
Возраст
ФИО или Имя
Телефон

Если Job API недоступен, те же данные система попробует вытащить из системного сообщения отклика или из текста переписки через AI.

Советы по настройке

1. Называйте поля так, как они звучат в чате. Для «Гражданство» совпадение по названию помогает быстрее подтянуть значение из системного отклика.

2. Подсказка для AI особенно полезна для неоднозначных вещей: бюджет, район, «когда нужно», контрпредложение по цене.

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

4. Сначала настройте 2–3 поля, проверьте на реальном диалоге кнопкой «Разобрать», потом добавляйте остальные.

5. Для CRM используйте текстовые доп. поля — так проще и надёжнее.

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

Почему поле пустое после разбора?
В переписке могло не быть явного значения, или AI не был уверен. Попробуйте уточнить подсказку для AI или заполните вручную.

Почему AI не перезаписывает поле?
Либо значение уже есть и выключено «Обновлять при новых сообщениях», либо поле сохранено вручную (manual). Нажмите «разрешить авто».

Почему не ушло в Amo/Bitrix?
Проверьте: есть ли сделка у диалога, указан ли плейсхолдер {df....} в доп. поле, хватает ли прав/токена интеграции.

Списываются ли токены всегда?
Нет. Заполнение без AI (телефон, Job API, системные блоки) токены не тратит. AI вызывается только если есть незаполненные (или обновляемые) поля и достаточный баланс токенов.

Быстрый чеклист запуска

1 Создать поля на вкладке «Поля диалога» и сохранить.
2 (Опционально) В Amo/Bitrix в доп. поля вставить {df....} из меню {}.
3 Открыть нужный чат в WebCS.
4 Нажать «Разобрать» или дождаться входящего сообщения.
5 Проверить блок «Данные диалога».
6 При необходимости поправить значение и нажать ✓.
7 Убедиться, что в сделке CRM нужные поля заполнились.