Перейти к содержимому
AISARAISAR
Все инструкции

Свои поля контакта и диалога

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

Что это и зачем

Свои поля дополняют стандартные данные контакта (имя, телефон, email, компания). Поле контакта описывает человека: источник заявки, город, дату рождения ребёнка. Поле диалога описывает конкретное обращение: причину, номер заказа, срок. Значения видны в карточке, по ним можно искать и сортировать контакты, собирать сегменты и рассылки, подставлять их в сообщения и условия сценариев.

Кто может создавать поля

  • Создавать, менять, упорядочивать и архивировать поля могут администратор и менеджер.
  • Удалить поле навсегда может только администратор.
  • Заполнять значения контакта могут те, у кого есть право редактировать контакты, а также сотрудники, которым выдано отдельное право заполнять поля контакта (оно есть и у роли «Агент»). Значения диалога заполняют те, кто может редактировать диалоги.

Шаг 1. Создайте поле

  1. Откройте «Настройки», раздел «Свои поля». Вверху две вкладки: «Контакт» и «Диалог». Выберите, к чему относится поле.
  2. Нажмите «Добавить поле». Если полей ещё нет, под заголовком есть примеры («Источник», «Город», «Причина обращения», «Номер заказа», «Срок»): можно начать с них.
  3. Введите название и выберите тип. Для списков добавьте варианты. Необязательная подсказка показывается оператору под названием поля.
  4. Сохраните. Поле появится в карточках контактов или диалогов, а перетаскиванием в таблице можно задать порядок полей.

У каждого поля есть ключ: латинские буквы, цифры и «_». AISAR предложит его по названию. Ключ используется в сценариях и API и после сохранения не меняется, как и тип поля. Если ключ нужен именно такой, задайте его при создании.

Типы полей

ТипЧто хранит
СтрокаКороткий текст до 1000 символов.
Многострочный текстДлинный текст до 10 000 символов. В списке контактов показывается начало.
ЧислоЧисло, при необходимости с десятичными знаками (в настройках поля задаётся, сколько знаков показывать).
ДатаКалендарная дата.
СписокОдин вариант из заранее заданных.
МультисписокНесколько вариантов из заданных.
ЧекбоксДа или нет.
СсылкаАдрес, начинающийся с http:// или https://.
ТелефонНомер телефона; сохраняется в международном формате.
EmailАдрес электронной почты.

Варианты списка и архив

Вариант списка нельзя удалить так, чтобы потерять значения: его отправляют в архив. У контактов, где он уже выбран, значение остаётся (рядом пометка «в архиве»), но выбрать его заново нельзя. Вариант можно вернуть из архива в окне поля.

Само поле тоже сначала архивируется. Архивное поле исчезает из карточек, фильтров и выбора, но значения у контактов сохраняются, и поле можно вернуть кнопкой «Вернуть из архива» (флажок «Показать архивные» над таблицей). Если поле используется в сценариях, сегментах, у ИИ-сотрудников или в рассылках, 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 быть корректными.
«Этого поля больше нет»Поле заархивировали или удалили, пока вы редактировали карточку. Обновите страницу.
В сценарии действие «Обновить поле» пропускаетсяПроверьте, что поле не в архиве и значение подходит по типу (например, дата в понятном формате).