---
title: Поля разговора («Что записываем»)
summary: Поле разговора — то, что бизнес хочет сохранить из чата, например услуга, о которой спросил клиент. У поля есть вид, название на каждом языке обслуживания и, у видов с выбором, варианты, которые доходят до клиента кнопками.
tools: [talemo_list_conversation_fields, talemo_create_conversation_field, talemo_update_conversation_field]
related: [remove-and-restore-fields, field-values, conversation-script, script-languages]
search: [что бот записывает из чата, анкета клиента, поля заявки]
---

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

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

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

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

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

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

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

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

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

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

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

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

## Кто что может

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

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

- Бизнес записывает то, что остаётся от переписки, — какая услуга нужна, приходил ли клиент раньше, удобное время — в поля разговора. `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` и спросите человека.