Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Description

Broacasting allows you to automatically dial up to the subscriber and, after the connection is established, perform a predefined

Описание

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

Table of Contents

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

Campaign setup

Календарь

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

Image Removed

Calendar

Before proceeding to the settings of the outbound campaign, you must create a calendar on which the campaign will work. The calendar is created in the Calendars section of the Webitel web client. The calendar contains the start and end date of the campaign, the time zone, the time of work depending on the day of the week, as well as holidays:

Image Added

General settings

In the Dialer section, create a new campaign with the Voice Broadcasting type

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

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

 

Info

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

 

If you have several active campaigns that use the same outgoing lines, then you can specify the priority (Priority), according to which the dealer will work out the sequence of sample numbers from the campaigns.

 

After specifying the name of the campaign and selecting the previously created calendar, go to the block with parameters Указав название автоинформатора и выбрав предварительно созданный календарь, переходим к блоку с параметрами (Parameters).

#ParametersОписаниеDescription
1LimitКоличество одновременных исходящих линий, которые будет использовать автоинформатор. Если вы указали 10 линий, то дайлер будет следить, за тем, что бы количество одновременных звонков не превысило заданный лимитThe number of simultaneous outgoing lines that the dialer will use. If you specify 10 lines, the webitel will ensure that the number of simultaneous calls does not exceed the specified limit.
2Wait between retries (in seconds)Если автоинформатор не смог дозвониться абоненту по одному из его номеров, он возобновит повторную попытку через время (в секундах), не меньше заданного в данном полеIf the autoinformer could not reach the subscriber by one of his numbers, he will resume trying again after a time (in seconds) not less than the one specified in this field.
3Maximum number of retryВ этом поле указывается количество, сколько раз автоинформатор будет пытаться дозвониться абоненту (с паузой, указанной в #2 этой таблицы), пока не прекратит попытки дозвона и установит конечный результат, как This field indicates the number, how many times the dialer will try to call the subscriber (with a pause indicated in # 2 of this table) until he stops trying to dial and sets the final result as MAX_TRY_COUNT
4Minimum succeed call duration (in seconds)После того, как абонент ответил и автоинформатор начал предварительно заданную After the subscriber has answered and the autoinformer has started the previously specified Webitel JSON Scheme, дайлер ожидает время (в секундах) указанное в этом поле. Если абонент раньше бросит трубку, тогда дайлер посчитает такой звонок не успешным и возобновит попытки дозвона через время указанное в #2, но не превышая количества попыток указанных в #3. Если же абонент пребывает на линии больше этого времени, тогда, по завершению звонка, дайлер установит конечный результат, как NORMAL_CLEARING, и прекратит попытки дозвона.
5Originate timeoutПараметр указывает сколько времени нужно дожидаться ответа абонента, прежде чем посчитать, что нет ответа, и продолжить попытки дозвона через время указанное в #2, но не превышая количества попыток указанных в #3.
Info

Если необходимо всем абонентам в кампании передавать одинаковые переменные в канал, для этой задачи вы можете воспользоваться вкладкой Variables.

JSON Scheme

После успешного дозвона до одного из абонентов в кампании, дайлер выполняет схему из вкладки Callflow. Вы можете использовать любые элементы маршрутизации, обращаться к переменным, которые устанавливали глобально на кампанию, либо на конкретного абонента.

Image Removed

Cause

На вкладке Cause указываются коды завершения вызова из списка и как дайлер должен обрабатывать эти коды.

Image Removed

  • Error - получив один из этих кодов, дайлер немедленно прекращает дозваниваться абоненту.
  • Retry - получив один из этих кодов, дайлер продолжает дозваниваться абоненту, в рамках заданного количества попыток.
  • OK - успешное завершение работы дайлера по данному абоненту.
  • Minus - коды из данного списка не влияют на количество попыток дозвона. Получая данный ответ, дайлер не прекращает дозвон и не увеличивает количество выполненных попыток.

Загрузка абонентов

Абоненты могут быть добавлены в кампанию с помощью web-клиента Webitel, импортом из CSV файла, либо с использованием REST API интерфейса.

Image Removed

Дозвон на номера указанные в карточках абонентов осуществляется с использованием стандартной исходящей маршрутизации

Info
the dealer waits for the time (in seconds) specified in this field. If the subscriber hangs up earlier, then the diler will consider such a call not successful and will resume dialing attempts after the time specified in #2, but not exceeding the number of attempts specified in #3. If the subscriber is on the line more than this time, then at the end of the call, the dialer will set the end result as NORMAL_CLEARING, and stop dialing attempts.
5Originate timeoutThe parameter indicates how long it is necessary to wait for the answer of the subscriber before calculating that there is no answer, and continue the attempts to dial through the time specified in #2, but not exceeding the number of attempts specified in #3.


Info

If it is necessary for all subscribers in the campaign to transfer the same variables to the channel, you can use the Variables tab for this task.


JSON Scheme

After successfully dialing one of the subscribers in the campaign, the dealer performs the scheme from the Callflow tab. You can use any elements of routing, refer to variables that set globally on a campaign, or on a specific subscriber.

Image Added

Cause

On the Cause tab, call completion codes are listed from the list and how the dealer must handle these codes.

Image Added

  • Error - having received one of these codes, the dialer stops calling the subscriber immediately.
  • Retry - having received one of these codes, the dialer continues to dial to the subscriber within the specified number of attempts.
  • OK - successful completion of the dialer for this subscriber.
  • Minus - codes from this list do not affect the number of dialing attempts. Receiving this answer, the dialer does not stop dialing and does not increase the number of attempts made.

Upload subscribers

Subscribers can be added to the campaign using the Webitel web client, importing from a CSV file, or using the REST API interface.

Image Added

Dialing the numbers specified in the subscriber cards is performed using standard outbound routing

Info


Upload using Web client

Just press the green "Add" button and enter the customer data for the call:

Image Added

  • Name - Arbitrary subscriber name
  • Priority - The priority of processing this subscriber by the dealer from the list of all subscribers.
  • Expire - If the subscriber was not processed before the specified time and date, it is automatically excluded from further dialing with the termination code MEMBER_EXPIRED
  • Communications - A list of telephone numbers where you can reach this subscriber. Please note that within the same campaign, the numbers cannot be the same for different subscribers.
  • Variables - Individual variables for a given subscriber. They also get into the call channel and can be used in the

Загрузка с помощью web-клиента

Просто нажимаете зеленую кнопку "Добавить" и вводите данные клиента для прозвона:

Image Removed

  • Name - Произвольное название абонента
  • Priority - Приоритет обработки этого абонента дайлером из списка всех абонентов.
  • Expire - Если абонент не был обработан до указанного времени и даты, то он автоматически исключается из дальнейшего прозвона с кодом завершения MEMBER_EXPIRED
  • Communications - Список номеров телефонов, по которым можно дозвониться этому абоненту. Обратите внимание, что в рамках одной кампании не могут быть одинакове номера у разных абонентов.
  • Variables - Индивидуальные переменные для данного абонента. Так же попадают в канал звонка и могут использоваться в JSON Scheme.
  • Run after adding members - Если включен этот параметр, то после добавления нового абонента, кампания автоматически запуститься в работу.

Загрузка с помощью CSV файла

Для загрузки списка абонентов из файла CSV, воспользуйтесь кнопкой "Загрузить".

Image Removed

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

  •  - If this option is enabled, after adding a new subscriber, the campaign will automatically start.

Upload using CSV file

To upload the list of subscribers from a CSV file, use the "Upload" button.

Image Added

In the file pre-processing window, you can specify the character set, the separator used, ignore the first line. For the necessary columns from the file, specify the destination of loading in the subscriber's card fields.


Upload using REST API

The list of clients to be dialed is transmitted via a JSON file using the POST method to the Webitel server.

Request example

Загрузка с помощью 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

 

Code Block
languagejs
titleBody
{
	"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

Переменная

Variable

Тип

Type

Описание

Description

namestring
Произвольное название абонента
Arbitrary subscriber name
priorityint
Приоритет обзвона (любой целое число). По умолчанию,
Call priority (any integer). The default is 0.
timezonestring
Часовая зона абонента. Если не задано, берется значение из настроек кампании

Time zone of the subscriber. If not specified, the value is taken from the campaign settings.

http://api.webitel.com/en/latest/tz-table.html -

значение из колонки

value from the fs_timezone column

communications

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

An array of telephone numbers with priorities for dialing one subscriber, if it is necessary to specify more than one means of communication for enumeration.

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


variablesobject

JSON

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

object with variables and their values that the dialer will transmit to the call channel. Here you can set any variables from the list required in the project, like:

  • Contact ID
  • Credit Application ID
  • Product
  • Customer status
  • The language of communication

Filling example

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

:

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



Campaign start and stop

After completing all the presets, the campaign can be started by pressing the RUN button. When the dialer processes the entire subscriber list or ends the “before” period specified in the calendar, the campaign will automatically stop. You can also stop a campaign by pressing the STOP button

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

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