1. Voice Broadcasting
- Vitalii Kovalyshyn
Описание
Автоинформатор позволяет автоматически дозваниваться до абонента и, после установления соединения, выполнить предварительно заданную Webitel JSON Scheme.
Настройка кампании
Календарь
Прежде чем переходить к настройкам исходящей кампании, необходимо создать календарь, по которому будет работать данная кампания. Календарь создается в разделе Calendars web-клиента Webitel. В календаре указывается дата начала и завершения кампании, часовой пояс, время работы в зависимости от дня недели, а так же, праздничные дни:
Общие настройки
В разделе Dialer создаем новую кампанию с типом Voice Broadcasting.
Если у Вас несколько активных кампаний, которые используют одинаковые исходящие линии, то вы можете указать приоритет (Priority), согласно которому дайлер будет отрабатывать последовательность выборки номеров из кампаний.
Указав название автоинформатора и выбрав предварительно созданный календарь, переходим к блоку с параметрами (Parameters).
Parameters | Описание | |
|---|---|---|
| 1 | Limit | Количество одновременных исходящих линий, которые будет использовать автоинформатор. Если вы указали 10 линий, то дайлер будет следить, за тем, что бы количество одновременных звонков не превысило заданный лимит. |
| 2 | Wait between retries (in seconds) | Если автоинформатор не смог дозвониться абоненту по одному из его номеров, он возобновит повторную попытку через время (в секундах), не меньше заданного в данном поле. |
| 3 | Maximum number of retry | В этом поле указывается количество, сколько раз автоинформатор будет пытаться дозвониться абоненту (с паузой, указанной в #2 этой таблицы), пока не прекратит попытки дозвона и установит конечный результат, как MAX_TRY_COUNT |
| 4 | Minimum succeed call duration (in seconds) | После того, как абонент ответил и автоинформатор начал предварительно заданную Webitel JSON Scheme, дайлер ожидает время (в секундах) указанное в этом поле. Если абонент раньше бросит трубку, тогда дайлер посчитает такой звонок не успешным и возобновит попытки дозвона через время указанное в #2, но не превышая количества попыток указанных в #3. Если же абонент пребывает на линии больше этого времени, тогда, по завершению звонка, дайлер установит конечный результат, как NORMAL_CLEARING, и прекратит попытки дозвона. |
| 5 | Originate timeout | Параметр указывает сколько времени нужно дожидаться ответа абонента, прежде чем посчитать, что нет ответа, и продолжить попытки дозвона через время указанное в #2, но не превышая количества попыток указанных в #3. |
Если необходимо всем абонентам в кампании передавать одинаковые переменные в канал, для этой задачи вы можете воспользоваться вкладкой Variables.
JSON Scheme
После успешного дозвона до одного из абонентов в кампании, дайлер выполняет схему из вкладки Callflow. Вы можете использовать любые элементы маршрутизации, обращаться к переменным, которые устанавливали глобально на кампанию, либо на конкретного абонента.
Cause
На вкладке Cause указываются коды завершения вызова из списка и как дайлер должен обрабатывать эти коды.
Error - получив один из этих кодов, дайлер немедленно прекращает дозваниваться абоненту.
Retry - получив один из этих кодов, дайлер продолжает дозваниваться абоненту, в рамках заданного количества попыток.
OK - успешное завершение работы дайлера по данному абоненту.
Minus - коды из данного списка не влияют на количество попыток дозвона. Получая данный ответ, дайлер не прекращает дозвон и не увеличивает количество выполненных попыток.
Загрузка абонентов
Абоненты могут быть добавлены в кампанию с помощью web-клиента Webitel, импортом из CSV файла, либо с использованием REST API интерфейса.
Дозвон на номера указанные в карточках абонентов осуществляется с использованием стандартной исходящей маршрутизации
Загрузка с помощью web-клиента
Просто нажимаете зеленую кнопку "Добавить" и вводите данные клиента для прозвона:
Name - Произвольное название абонента
Priority - Приоритет обработки этого абонента дайлером из списка всех абонентов.
Expire - Если абонент не был обработан до указанного времени и даты, то он автоматически исключается из дальнейшего прозвона с кодом завершения MEMBER_EXPIRED
Communications - Список номеров телефонов, по которым можно дозвониться этому абоненту. Обратите внимание, что в рамках одной кампании не могут быть одинакове номера у разных абонентов.
Variables - Индивидуальные переменные для данного абонента. Так же попадают в канал звонка и могут использоваться в JSON Scheme.
Run after adding members - Если включен этот параметр, то после добавления нового абонента, кампания автоматически запуститься в работу.
Загрузка с помощью CSV файла
Для загрузки списка абонентов из файла CSV, воспользуйтесь кнопкой "Загрузить".
В окне предварительно обработки файла, вы можете указать набор символов, используемый разделитель, игнорировать первую строчку. Для нужных колонок из файла указываете назначение загрузки в поля карточки абонента.
Загрузка с помощью REST API
Список клиентов для прозвона передается с помощью JSON файла методом POST на сервер webitel.
Пример запроса:
POST /api/v2/dialer/571f2e2e6ea6478aba60581a/members?autoRun=true HTTP/1.1
Content-Type: application/json X-Access-Token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE0NDIwMDIxNzkzNTh9 X-Key: 8fd26a17-eb28-4c74-aa6f-a3794f4f466c
Body
{
"name":"Мирный Евгений",
"priority": 0,
"timezone":"",
"variables": {
"debt": 20000,
"language":"русский",
"productID":"8fd26a17-eb28-4c74-aa6f-a3794f4f466c"
},
"communications":[
{
"number":"099998888",
"priority":1
}, {
"number":"3434534534534",
"priority":2
}
]
}Body JSON
Переменная | Тип | Описание |
|---|---|---|
name | string | Произвольное название абонента |
priority | int | Приоритет обзвона (любой целое число). По умолчанию, 0. |
timezone | string | Часовая зона абонента. Если не задано, берется значение из настроек кампании. http://api.webitel.com/en/latest/tz-table.html - значение из колонки fs_timezone |
communications | array | Массив телефонных номеров с приоритетами для прозвона по одному абоненту, если необходимо указать больше одного средства связи для перебора. "communications": [
{
number: "+380890000000",
priority: 2
},{
number: "0910000000",
priority: 1
}
] |
variables | object | JSON объект с переменными и их значениями, которые dialer будет передавать в канал звонка.
Пример наполнения: "variables": {
"language": "ru",
"productID": "8fd26a17-eb28-4c74-aa6f-a3794f4f466c"
} |
Запуск и остановка кампании
После выполнения всех предварительных настроек, кампания может быть запущена с помощью нажатия кнопки RUN. Когда дайлер обработает весь список абонентов либо завершиться период "до" указанный в календаре, кампания автоматически остановиться. Так же, вы можете остановить кампанию нажатием на кнопку STOP.