Поля разговора («Что записываем»)

Поле разговора — то, что бизнес хочет сохранить из чата с клиентом: услуга, о которой он спросил, бывал ли он раньше, кто посоветовал салон. Поля перечислены на странице Онлайн-администратор в настройках, на вкладке Что записываем. Онлайн-администратор заполняет их, пока разговаривает с клиентом, а человек потом может поправить (см. Значение поля у переписки).

Одни поля на весь бизнес

Поля принадлежат бизнесу. Филиал со своими шагами чата пишет в те же поля (см. Сценарий филиала).

Что есть у поля

• Название. Оно написано на каждом языке, на котором бизнес обслуживает клиентов. Команда видит его у себя, а клиент — в вопросе, если поле спрашивают кнопками. На языке без названия написано «Перевода нет — онлайн-администратор переведёт сам».
• Вид (Что в нём):
  • выбор — один вариант из нескольких, например «Маникюр»;
  • список — можно выбрать несколько, например «Вечером» и «В выходные»;
  • число — клиент говорит словами, а записывается числом, например бюджет или сколько человек;
  • да или нет — два варианта, подписи можно свои, например «Нет, впервые»;
  • короткий текст — несколько слов, до 200 знаков, например кто посоветовал салон.
• Варианты у выбора и списка, два и больше. У числа и короткого текста вариантов нет.
• Подсказка — короткая заметка для команды и онлайн-администратора: «в евро», «кто нас порекомендовал».

В таблице у каждого поля показаны вид, варианты и число чатов, где оно заполнено.

Варианты уходят клиенту кнопками

Название варианта отправляется клиенту кнопкой, поэтому оно должно поместиться на кнопке в каждом канале: не больше 20 знаков на каждом языке. Два варианта, которые на одном языке читаются одинаково, не принимаются: кнопки должны различаться. Как шаг превращает варианты в кнопки, описано в Сценарии разговора.

Что нельзя поменять

• Ключ поля и варианта остаётся таким, каким создан. Если ключ не указан, Talemo делает его из названия. По ключу поле называют программы, онлайн-администратор и столбцы выгрузки.
• Вид поля, которое уже заполнено хотя бы в одном чате, остаётся. Нужен другой вид — добавьте новое поле.
• Вариант, выбранный хотя бы в одном чате, остаётся. Добавьте новый вариант.

Названия и подсказки можно менять в любое время. Если название поменяли после того, как сделали перевод, перевод помечается устаревшим (см. Языки и переводы текстов сценария).

Кто что может

Добавлять и менять поля — настройка бизнеса, поэтому это может роль, которая охватывает весь бизнес. Остальные видят поля, но не меняют.

Инструменты и отказы

• Бизнес записывает то, что остаётся от переписки, — какая услуга нужна, приходил ли клиент раньше, удобное время — в поля разговора. talemo_list_conversation_fields перечисляет их с ключом, видом (choice, list, number, yes_no, text), названием на первом языке обслуживания и его переводами (устарели, если название потом менялось), вариантами, пометкой и числом переписок, где поле заполнено. retired перечисляет убранные.
• talemo_create_conversation_field принимает key, kind, label и, для выбора или списка, options; label_tr — для языка обслуживания, кроме первого, а position называет место. Название варианта попадает на кнопку в каждом канале, поэтому длиннее 20 знаков хотя бы на одном языке отклоняется с request.body_invalid и params.max. Ключ, который держит другое поле, в том числе убранное, отклоняется с record.duplicate.
• talemo_update_conversation_field меняет названия, вид, варианты, подсказку или место; ключ не меняется никогда. Переводы и варианты присылают целиком. Поле, в котором уже есть значения, вид сохраняет, а вариант, выбранный хоть в одной переписке, остаётся: статус 409, код conversation_field.has_values, params.count и params.option. Убранное поле отклоняется с conversation_field.retired: сначала верните его.
• Пока быстрые вопросы канала включены, варианты поля, которое спрашивает первый шаг сценария, — это то, что каждый клиент видит в Instagram или Messenger салона, поэтому изменение доходит до Meta в течение минуты. Сначала покажите dry_run и спросите человека.