Свои поля контакта и диалога
Как хранить в карточке контакта и диалога то, что важно именно вашему бизнесу: город, номер заказа, срок, причину обращения. Создание полей, типы, заполнение в чате, фильтры, сценарии, рассылки, ИИ-сотрудник и импорт.
Что это и зачем
Свои поля дополняют стандартные данные контакта (имя, телефон, email, компания). Поле контакта описывает человека: источник заявки, город, дату рождения ребёнка. Поле диалога описывает конкретное обращение: причину, номер заказа, срок. Значения видны в карточке, по ним можно искать и сортировать контакты, собирать сегменты и рассылки, подставлять их в сообщения и условия сценариев.
Кто может создавать поля
- Создавать, менять, упорядочивать и архивировать поля могут администратор и менеджер.
- Удалить поле навсегда может только администратор.
- Заполнять значения контакта могут те, у кого есть право редактировать контакты, а также сотрудники, которым выдано отдельное право заполнять поля контакта (оно есть и у роли «Агент»). Значения диалога заполняют те, кто может редактировать диалоги.
Шаг 1. Создайте поле
- Откройте «Настройки», раздел «Свои поля». Вверху две вкладки: «Контакт» и «Диалог». Выберите, к чему относится поле.
- Нажмите «Добавить поле». Если полей ещё нет, под заголовком есть примеры («Источник», «Город», «Причина обращения», «Номер заказа», «Срок»): можно начать с них.
- Введите название и выберите тип. Для списков добавьте варианты. Необязательная подсказка показывается оператору под названием поля.
- Сохраните. Поле появится в карточках контактов или диалогов, а перетаскиванием в таблице можно задать порядок полей.
У каждого поля есть ключ: латинские буквы, цифры и «_». AISAR предложит его по названию. Ключ используется в сценариях и API и после сохранения не меняется, как и тип поля. Если ключ нужен именно такой, задайте его при создании.
Типы полей
| Тип | Что хранит |
|---|---|
| Строка | Короткий текст до 1000 символов. |
| Многострочный текст | Длинный текст до 10 000 символов. В списке контактов показывается начало. |
| Число | Число, при необходимости с десятичными знаками (в настройках поля задаётся, сколько знаков показывать). |
| Дата | Календарная дата. |
| Список | Один вариант из заранее заданных. |
| Мультисписок | Несколько вариантов из заданных. |
| Чекбокс | Да или нет. |
| Ссылка | Адрес, начинающийся с http:// или https://. |
| Телефон | Номер телефона; сохраняется в международном формате. |
| Адрес электронной почты. |
Варианты списка и архив
Вариант списка нельзя удалить так, чтобы потерять значения: его отправляют в архив. У контактов, где он уже выбран, значение остаётся (рядом пометка «в архиве»), но выбрать его заново нельзя. Вариант можно вернуть из архива в окне поля.
Само поле тоже сначала архивируется. Архивное поле исчезает из карточек, фильтров и выбора, но значения у контактов сохраняются, и поле можно вернуть кнопкой «Вернуть из архива» (флажок «Показать архивные» над таблицей). Если поле используется в сценариях, сегментах, у ИИ-сотрудников или в рассылках, AISAR перед архивацией покажет, где именно, и после подтверждения отключит его в этих местах. «Удалить навсегда» доступно только для архивного поля, которое нигде не используется, и стирает все его значения без возможности вернуть.
Заполнение в чате и в карточке
- В чате откройте панель справа: поля контакта лежат в секции «Поля», поля диалога в секции «Поля диалога». Значение сохраняется при выходе из поля или по Enter, Esc отменяет; в многострочном тексте сохранить можно по Ctrl+Enter или кликом вне поля.
- Поля контакта есть и в разделе «Контакты»: в карточке контакта и в форме редактирования.
- Чтобы очистить значение, нажмите «Очистить» в поле.
- Под значением видно, кто и когда изменил его последним и откуда пришло изменение: оператор, сценарий, ИИ, импорт, API, слияние контактов.
- У одной карточки есть общий предел на объём значений своих полей. Если упёрлись, AISAR скажет, что в карточке слишком много текста: сократите самые длинные значения.
Фильтры и сортировка в «Контактах»
В списке контактов добавьте фильтр «Своё поле»: выберите поле, условие и значение. Условия зависят от типа: у строки «равно», «содержит», «начинается с», «заполнено»; у числа и даты «больше», «меньше», «между»; у списка «равно» и «в списке»; у мультисписка «включает»; у чекбокса «да» и «нет». Можно применить до пяти фильтров по своим полям одновременно, они работают вместе (контакт должен подходить под все). Колонки своих полей можно вывести в таблицу и отсортировать по ним: пустые значения всегда уходят в конец. Многострочный текст и мультисписок не сортируются. Те же фильтры применяются к выгрузке контактов.
Для постоянных выборок создайте сегмент с условием «Своё поле»: он пригодится в рассылках. Если поле позже уйдёт в архив, такое условие перестанет отбирать контакты, а не расширится на всю базу; выберите другое поле, чтобы сохранить сегмент.
Сценарии
- Триггеры «Поле контакта обновлено» и «Поле диалога обновлено» запускают сценарий, когда значение изменилось. В условии можно уточнить, какое именно поле.
- Действие «Обновить поле контакта» записывает значение в своё поле контакта или диалога. Если поле в архиве или значение не подходит по типу, шаг пропускается, а сценарий идёт дальше.
- Переменные в сообщениях и условиях:
{{contact.custom.<ключ>}}для поля контакта и{{conversation.custom.<ключ>}}для поля диалога. Значение подставляется в читаемом виде: у списка название варианта, у даты дата, у чекбокса «Да» или «Нет». Пустое поле даёт пустую строку. Список переменных есть в редакторе сценария, их выбирают из подсказки.
Подробнее о переменных и кнопках см. переменные сценариев, об основах сценариев сценарии простыми словами.
Рассылки
В тексте рассылки и в привязке переменных шаблона доступны поля контакта в виде {{custom.<ключ>}}: они появляются в списке переменных с пометкой «Своё поле». В тестовом сообщении подставляется пример значения, при реальной отправке берётся значение из карточки каждого получателя. Поля диалога в рассылках не используются. Отобрать получателей по своим полям можно сегментом.
Подробнее о рассылках: как устроены рассылки.
ИИ-сотрудник
У ИИ-сотрудника два независимых доступа к своим полям, оба выключены, пока вы их не включите.
- Чтение. В окне поля есть переключатель «Видно ИИ-сотруднику», по умолчанию он выключен. Если включить, ИИ увидит значение в сводке по контакту или диалогу и сможет опираться на него в ответах. Поля без этой отметки ИИ не видит.
- Запись. В настройках инструмента «Записывать имя и контакты» у ИИ-сотрудника есть список «Свои поля, которые можно заполнять». ИИ запишет в карточку только отмеченные там поля. Отметка «Только пустые поля» запрещает перезаписывать уже заполненные значения.
Рекомендуем включать чтение и запись только для полей, которые ИИ действительно нужны. Если поле используется у ИИ-сотрудника, при архивации AISAR предупредит об этом.
Голосовой агент
Голосовой агент, который отвечает на звонки, тоже работает со своими полями контакта, и доступы настраиваются отдельно от текстового ИИ-сотрудника.
- Чтение. Если в компании есть поля с отметкой «Видно ИИ-сотруднику», голосовой агент получает их значения сам: они попадают в блок данных клиента в его инструкции. Вписывать их вручную не нужно. Скрытые поля агенту не передаются. У уже настроенных агентов блок появится после следующего сохранения агента или после изменения поля с отметкой «Видно ИИ-сотруднику».
- Запись. В настройках голосового агента, на вкладке «Голос», есть карточка выбора своих полей контакта, которые агент может заполнять. Если список пуст, действует список из инструмента «Записывать имя и контакты» привязанного ИИ-сотрудника.
Голосом заполняются только пустые поля. Звонящего опознают по номеру, а номер можно подделать, поэтому уже заполненное значение голосовой агент не перезапишет.
Импорт из CSV
На шаге сопоставления колонок выберите для колонки пункт «Своё поле» и укажите, в какое поле контакта писать. Одно поле можно привязать только к одной колонке. Даты можно писать как ДД.ММ.ГГГГ или ГГГГ-ММ-ДД, чекбокс как «да», «нет», 1 или 0, несколько значений мультисписка разделяйте «;» или запятой. Значения, которых нет в списке, пропускаются: новых вариантов импорт не создаёт, поэтому сначала добавьте нужные варианты в поле. Нечитаемое значение пропускается с предупреждением, остальная строка импортируется. Если в заголовке колонки название совпадает с названием вашего поля, AISAR предложит сопоставление сам.
Подробнее об импорте: импорт контактов из CSV.
Чувствительные данные
Лимиты
- До 100 активных полей отдельно для контактов и для диалогов; архивные в этот предел не входят.
- До 200 вариантов у одного списка; название поля и варианта до 100 символов, подсказка до 500.
- Для работы с полями из других систем есть API: группа «Свои поля».
Если что-то не получается
| Что видите | Что делать |
|---|---|
| Нет кнопки «Добавить поле», вверху надпись, что изменять поля могут администратор и менеджер | Попросите администратора компании выдать вам подходящую роль или создать поле. |
| «Достигнут предел в 100 активных полей» | Отправьте ненужные поля в архив. |
| «Такой ключ уже занят» | Ключ уникален среди всех полей этого типа, включая архивные. Выберите другой. |
| Значение не сохраняется: «Проверьте формат значения» | Дата должна быть настоящей, ссылка начинаться с http:// или https://, телефон и email быть корректными. |
| «Этого поля больше нет» | Поле заархивировали или удалили, пока вы редактировали карточку. Обновите страницу. |
| В сценарии действие «Обновить поле» пропускается | Проверьте, что поле не в архиве и значение подходит по типу (например, дата в понятном формате). |