Skip to end of metadata
Go to start of metadata

Описание

Автоинформатор позволяет автоматически дозваниваться до абонента и, после установления соединения, выполнить предварительно заданную Webitel JSON Scheme.

Настройка кампании

Календарь

Прежде чем переходить к настройкам исходящей кампании, необходимо создать календарь, по которому будет работать данная кампания. Календарь создается в разделе Calendars web-клиента Webitel. В календаре указывается дата начала и завершения кампании, часовой пояс, время работы в зависимости от дня недели, а так же, праздничные дни:

Общие настройки

В разделе Dialer создаем новую кампанию с типом Voice Broadcasting.

 

Если у Вас несколько активных кампаний, которые используют одинаковые исходящие линии, то вы можете указать приоритет (Priority), согласно которому дайлер будет отрабатывать последовательность выборки номеров из кампаний.

 

Указав название автоинформатора и выбрав предварительно созданный календарь, переходим к блоку с параметрами (Parameters).

#ParametersОписание
1LimitКоличество одновременных исходящих линий, которые будет использовать автоинформатор. Если вы указали 10 линий, то дайлер будет следить, за тем, что бы количество одновременных звонков не превысило заданный лимит.
2Wait between retries (in seconds)Если автоинформатор не смог дозвониться абоненту по одному из его номеров, он возобновит повторную попытку через время (в секундах), не меньше заданного в данном поле.
3Maximum number of retryВ этом поле указывается количество, сколько раз автоинформатор будет пытаться дозвониться абоненту (с паузой, указанной в #2 этой таблицы), пока не прекратит попытки дозвона и установит конечный результат, как MAX_TRY_COUNT
4Minimum succeed call duration (in seconds)После того, как абонент ответил и автоинформатор начал предварительно заданную Webitel JSON Scheme, дайлер ожидает время (в секундах) указанное в этом поле. Если абонент раньше бросит трубку, тогда дайлер посчитает такой звонок не успешным и возобновит попытки дозвона через время указанное в #2, но не превышая количества попыток указанных в #3. Если же абонент пребывает на линии больше этого времени, тогда, по завершению звонка, дайлер установит конечный результат, как NORMAL_CLEARING, и прекратит попытки дозвона.
5Originate 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

Переменная
Тип
Описание
namestringПроизвольное название абонента
priorityintПриоритет обзвона (любой целое число). По умолчанию, 0.
timezonestring

Часовая зона абонента. Если не задано, берется значение из настроек кампании.

http://api.webitel.com/en/latest/tz-table.html - значение из колонки fs_timezone

communications

array

Массив телефонных номеров с приоритетами для прозвона по одному абоненту, если необходимо указать больше одного средства связи для перебора.

"communications": [
	{
		number: "+380890000000", 
		priority: 2
	},{
		number: "0910000000", 
		priority: 1
	}
]
variablesobject

JSON объект с переменными и их значениями, которые dialer будет передавать в канал звонка.
Здесь могут быть заданы любые переменные из требуемого в проекте списка, как:

  • Идентификатор контакта
  • Идентификатор кредитной заявки
  • Продукт
  • Статус клиента
  • Язык общения

Пример наполнения:

"variables": {
	"language": "ru",
	"productID": "8fd26a17-eb28-4c74-aa6f-a3794f4f466c"
}

Запуск и остановка кампании

После выполнения всех предварительных настроек, кампания может быть запущена с помощью нажатия кнопки RUN. Когда дайлер обработает весь список абонентов либо завершиться период "до" указанный в календаре, кампания автоматически остановиться. Так же, вы можете остановить кампанию нажатием на кнопку STOP.

  • No labels