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

Інструкція по запуску постобробки при здійсненні оператором Ручного Вихідного дзвінка

1. Опис

Форма постобробки при вихідному дзвінку призначена для того, щоб оператор міг зафіксувати результати для ручного вихідного дзвінка.

1.1. Як це працює

Під час активного вихідного дзвінка автоматично відкривається форма постобробки.

  • У формі оператор може:

    • зафіксувати результат дзвінка (наприклад, "клієнт погодився на зустріч");

    • створити нове звернення у системі (за умови наявності додатка “Звернення”);

    • виконати інші дії, які визначені адміністратором у налаштуваннях.

  • Форма виглядає так само, як і звичайна форма постобробки для вхідних дзвінків у черзі.

Якщо під час вихідного дзвінка відкривається форма, інші вхідні дзвінки оператору не розподіляються, доки він не завершить постобробку.

2. Налаштування

2.1. Створення та налаштування схеми

Схему для вихідного дзвінка з формою постобробки можна створити двома способами: через код або через діаграму.

2.1.1. Створення через код

  1. У розділі Admin → Маршрутизація → Схеми натисніть кнопку “Додати” (Рис. 1).

image-20250911-112346.png
Рис. 1. Кнопка “Додати“
  1. У модальному вікні виберіть “Код” (Рис. 2.(1)) і тип “Голосова” (Рис. 2.(2)).

image-20250909-105053.png
Рис. 2. Модальне вікно “Створити нову схему“
  1. Натисніть кнопку “Створити” (Рис. 3).

image-20250909-105201.png
Рис. 3. Кнопка “Створити“
  1. Відкриється вкладка “Загальне“ для створення нової схеми (Рис. 4).

image-20250909-105317.png
Рис. 4. Вкладка “Загальне“
  1. Вкажіть назву схеми та за потреби додайте теги.

  2. У полі “Схема” (Рис. 5) вставте JSON-конфігурацію (див. нижче).

image-20250909-105554.png
Рис. 5. Поле “Схема“
  1. Натисніть на кнопку “Зберегти” (Рис. 6).

image-20250909-105644.png
Рис. 6. Кнопка “Зберегти“

Приклад JSON-конфігурації:

[
  {
    "recordSession": {
      "action": "start",
      "bridged": true,
      "followTransfer": true,
      "minSec": 2,
      "stereo": true,
      "type": "mp3"
    }
  },
  {
    "ccOutbound": {
      "canelDistribute": "true",
      "processing": {
        "enabled": true,
        "form": {
          "id": 17
        },
        "sec": 10
      },
      "queueName": "test"
    }
  },
  {
    "bridge": {
      "endpoints": [
        {
          "cancelDistribute": false,
          "dialString": "$1",
          "gateway": {
            "enable": false,
            "id": "22",
            "name": "cloud2",
            "proxy": ""
          },
          "parameters": {},
          "type": "gateway"
        }
      ],
      "parameters": {},
      "strategy": "multiply"
    }
  },
  {
    "sleep": 1000
  },
  {
    "answer": ""
  },
  {
    "echo": 1000
  },
  {
    "hangup": ""
  }
]

Основні параметри:

  • recordSession – відповідає за запис дзвінка.

  • ccOutbound – параметри вихідного дзвінка:

    • canelDistribute: true ― оператору не будуть розподілятися інші дзвінки;

    • processing.enabled: true ― активується форма постобробки;

    • form.id: 17 ― ID форми, яка відкриється після дзвінка. Щоб дізнатися ID, необхідно знайти схему форми постобробки, що буде привʼязана до дзвінка, та скопіювати його с адресної строки (Рис. 7);

    • sec: 10 ― тривалість постобробки (у секундах);

    • queueName: "anna test" ― назва черги для виконання дзвінка.

image-20250909-110734.png
Рис. 7. Приклад ID схеми постобробки
  • bridge – параметри з’єднання з абонентом (gateway, dialString, стратегія набору).

  • sleep, answer, echo, hangup – службові дії, що регулюють процес виклику.

2.1.2. Створення через діаграму

  1. У розділі Admin → Маршрутизація → Схеми натисніть кнопку “Додати” (Рис. 8).

image-20250911-112346.png
Рис. 8. Кнопка “Додати“
  1. У модальному вікні виберіть “Діаграма” і тип “Голосова” (Рис. 9).

image-20250909-110033.png
Рис. 9. Модальне вікно “Створити нову схему“
  1. Натисніть “Створити” (Рис. 10).

image-20250909-105201.png
Рис. 10. Кнопка “Створити“
  1. Додайте послідовно компоненти схем:

image-20250909-111226.png
Рис. 11. Вигляд схеми
  1. У компоненті “Custom code” (Рис. 12) додайте в поле код (параметри для "id", "sec", та "queueName" потрібно змінити на необхідні):

 {
    "ccOutbound": {
      "canelDistribute": "true",
      "processing": {
        "enabled": true,
        "form": {
          "id": 17
        },
        "sec": 10
      },
      "queueName": "test"
    }
  }
image-20250909-111339.png
Рис. 12. Компонент “Custom code“
  1. Налаштуйте інші компоненти схеми.

  2. Натисніть на іконку збереження (Рис. 13).

image-20250909-111612.png
Рис. 13. Іконка збереження схеми

2.2. Налаштування правила вихідного набору

Щоб схема з кодом працювала для ручних вихідних дзвінків, її потрібно прив’язати до правила вихідного набору.

  1. У розділі Admin → Маршрутизація → Правила вихідного набору натисніть кнопку “Додати” (Рис. 14).

image-20250911-112547.png
Рис. 14. Кнопка “Додати“
  1. У формі створення правила заповніть обов’язкові поля (Рис. 15):

    • “Ім’я” — назва правила, яка допоможе вам ідентифікувати його.

    • “Номер призначення” — регулярний вираз, за яким система визначатиме, на які номери застосовується правило (наприклад, ^\+?380\d{9}$ для українських номерів).

    • “Схема дзвінка” — виберіть зі списку вашу схему з кодом (створену на попередньому етапі).

image-20250909-111835.png
Рис. 15. Створення нового правила вихідного набору
  1. За потреби можна додати опис правила у полі “Опис”.

  2. Натисніть кнопку “Зберегти” (Рис. 16).

image-20250909-112002.png
Рис. 16. Кнопка “Зберегти“

Після цього правило буде активоване, і під час здійснення вихідного дзвінка система використовуватиме підв’язану схему.

Важливо!

У налаштуванні правил має значення послідовність в реєстрі: при вихідному дзвінку номер перевіряється за кожним правилом зверху донизу. Тому правило з вашою схемою потрібно розміщувати у правильному порядку, щоб воно відпрацьовувало пріоритетно.

3. Відображення у Workspace

3.1. Відкриття форми

  1. Оператор ініціює ручний вихідний дзвінок через іконку виклику у нижній панелі Workspace. Для цього потрібно натиснути на іконку дзвінка (Рис. 17).

image-20250909-151408.png
Рис. 17. Іконка виклику у Workspace
  1. Далі ввести номер абонента вручну (Рис. 18.(1)) або обрати його зі списку доступних контактів (Рис. 18.(2)).

image-20250909-151250.png
Рис. 18. Панель набору номера абонента
  1. Під час активного дзвінка система автоматично підтягує налаштовану у схемі форму постобробки.

image-20250909-151136.png
Рис. 19. Приклад відображення форми постобробки у Workspace

3.2. Робота з формою

  • Поля у формі визначаються тією схемою, яка була прив’язана до правила вихідного набору.

  • У формі можуть бути налаштовані:

    • поля для створення “Звернення” (за умови наявності додаткаЗвернення”);

    • поля для виконання додаткових задач.

3.3. Збереження даних

  • Оператор заповнює форму відповідно до результатів дзвінка.

  • Усі введені дані фіксуються після натискання кнопки “Send”. Після цього дані стають доступними у системі згідно з логікою, закладеною у схемі (наприклад, створюється Звернення).