Документация Webitel

Настройка схемы постобработки для оценки писем

1. Назначение

Используется для того, чтобы дать клиенту возможность оценить качество предоставленной консультации. Клиент получает на электронную почту письмо с кнопками для оценки качества ответа.

2. Настройка

2.1. Создание схемы

На рабочей области добавьте компоненты в следующей последовательности:
Start → Form SelectCustom codeGenerate FormSend emailAttempt Result.

image-20250926-100048.png
Рис. 1. Общая схема

2.2. Настройка компонента “Form Select”

  1. На панели инструментов выберите компонент “Form Select” и перетащите его в схему.

  2. В поле “Id” укажите lang.

  3. В поле “Options source” выберите input.

  4. Добавьте в список все доступные языки (например: en, ru, uk, es, kz, vi, pl, ro, uz).

image-20250926-100402.png
Рис. 2. Компонент “Form Select”

2.3. Добавьте компонент “Custom code”

  1. Добавьте в схему компонент “Custom code”.

  2. В поле “Custom code” вставьте JSON-код:

{
    "feedback": {
        "setVar": "hk",
        "sourceId": "${message_id}"
    }
}

image-20250926-100525.png
Рис. 3. Компонент “Custom code”

2.4. Добавьте компонент “Generate Form”

  1. Перетащите в схему компонент “Generate Form”.

  2. В поле “Id” укажите send.

  3. В секции “Body contents” добавьте переменную: lang.

  4. В секции “Form actions”:

    • В поле “Id” укажите значение (например, id).

    • В поле “Text” напишите название кнопки (например, Send).

    • Выберите цвет кнопки, например primary.

image-20250926-100727.png
Рис. 4. Компонент “Generate Form”

2.5. Добавьте компонент “Send email”

  1. Перетащите в схему компонент “Send email”.

  2. Заполните основные поля:

  • To” — адрес получателя;

  • Subject” — тема письма;

  • From” — адрес отправителя;

  • Message” — тело письма в формате HTML:

    <html lang="ru">
      <body>
        <div>
          <p style="font-size:16px;font-weight:300;line-height:24px;color:#000;">
            Добрый день!  
            <br>
            Уважаемый клиент, благодарим вас за обращение! ${message_id}  
            <br>
            Пожалуйста, ответьте на вопрос. Ваше мнение очень важно для нас!
          </p>
          <p style="margin-top:32px;font-size:16px;font-weight:700;line-height:24px;color:#000;">
            Был ли решён ваш вопрос?
          </p>
          <div>
            <a style="margin-right: 32px;" href="https://test.webitel.me/workspace/feedback-page?hk=${hk}&lang=${lang}&rating=1" target="_blank">
              <img style="width:120px" src="ССЫЛКА_НА_ИЗОБРАЖЕНИЕ_YES"/>
            </a>
            <a href="https://test.webitel.me/workspace/feedback-page?hk=${hk}&lang=${lang}&rating=0" target="_blank">
              <img style="width:120px" src="ССЫЛКА_НА_ИЗОБРАЖЕНИЕ_NO"/>
            </a>
          </div>
        </div>
      </body>
    </html>
    
    

Обратите внимание: ссылки на изображения нужно заменить на нужные.

image-20250926-101402.png
Рис. 5. Компонент “Send email”
  1. Включите переключатель “Use variable”, если хотите использовать переменную для контактов.

  2. Введите идентификатор Email профиля в поле “Profile” (например, 20), который будет использоваться для отправки электронного сообщения.

  3. Включите переключатель “Store”, чтобы сделать возможной отправку исходного сообщения.

  4. В поле “Retry count” укажите количество повторных попыток отправить сообщение после неудачи (например, 3).

  5. Включите переключатель “SMTP Auth”. После этого параметры “User” и “Password” (данные вашей учётной записи Webitel) заполнятся автоматически.

  6. Заполните параметры:

  1. Включите переключатель “TLS” для безопасного соединения.

3. Отображение в Workspace

  1. Оператор получает сообщение от клиента в Workspace. Он нажимает кнопку «Принять» (Рис. 8), чтобы взять его в работу.

image-20250929-132814.png
Рис. 8. Принятие сообщения в Workspace
  1. После принятия сообщения открывается форма постобработки. Оператор выбирает язык (Рис. 9), на котором клиент получит письмо с кнопками для оценки, и нажимает кнопку отправки (Рис. 10).

image-20250926-113208.png
Рис. 9. Выбор языка
image-20250926-113507.png
Рис. 10. Кнопка отправки
  1. Система отправляет клиенту email. В письме будут отображены настроенный текст и две кнопки с изображениями (Рис. 11).

image-20250929-131442.png
Рис. 11. Пример полученного клиентом письма
  1. Клиент нажимает кнопку с ответом. Выбор автоматически фиксируется в системе:

    • Если оценка ещё не была предоставлена, система сохраняет ответ и показывает страницу с сообщением об успешной отправке (Рис. 12).

image-20250929-132358.png
Рис. 12. Страница успешного ответа
  • Если оценка уже была предоставлена, система не принимает повтор и показывает страницу с сообщением об ошибке (Рис. 13).

image-20250929-131846.png
Рис. 13. Страница с ошибкой

Обратите внимание!

  • Клиент может оставить оценку только один раз.

  • Повторное нажатие кнопки не изменяет результат.

  • Оценка клиента не влияет на оценку оператора — она хранится отдельно в базе данных (в Grafana, удобно для аналитики).