Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Перейдите в раздел Система → Кастомизация системных файлов.
Откройте для редактирования конфигурационный файл extensions.conf.
Установите режим "Добавлять в конец файла" и вставьте следующий код:
Белый список номеров иногда требуется описать для конкретных провайдеров:
ID-ПРОВАЙДЕРА - значение, которое вы можете найти в адресной строке в момент конфигурации провайдера
В MikoPBX в разделе Маршрутизация → Нерабочее время настроены правила маршрутизации вызовов в нерабочее время. Данные правила распространяются на все вызовы, независимо от того на какой номер компании позвонил клиент. Необходимо для провайдера Zadarma настроить индивидуальное нерабочее время. Рабочее время для данного провайдера: с 9.00 до 18.00 по МСК.
Перейдите в раздел Модули → Приложения диалпланов. Создайте новое приложение (диалплан Asterisk) по инструкции. Параметры приложения принимают вид:
Программный код созданного приложения:
Команда ExecIfTime выполняет указанное приложение Asterisk, если текущее время соответствует заданной спецификации времени. Если нам позвонят с 9:00 до 18:00 в любой будний день (с понедельника по пятницу), то мы перенаправляем вызов (команда Goto) на номер 2003. 2003 - это номер IVR-меню.
Иначе вызов направится сотруднику с внутренним номером 201.
Настраиваем правила входящей маршрутизации для созданного провайдера. Переходим в раздел Маршрутизация → Входящие маршруты. Направляем все входящие вызовы на созданное приложение.
Найдите и скопируйте ID-провайдера. Чтобы это сделать - перейдите в конфигурацию необходимого провайдера. В нашем примере - это SIP-1687941868
Перейдите в раздел Система -> Кастомизация системных файлов
Откройте для редактирования конфигурационный файл extensions.conf.
Установите режим «Добавлять в конец файла». В черное окно добавьте следующий фрагмент кода:
В выше приведенном фрагменте кода Вам необходимо составить правильное наименование контекста. Формат создаваемого контекста:
ID-ПРОВАЙДЕРА - значение, которое вы сохранили на втором шаге данной инструкции. В нашем примере это SIP-1687941868.
Рабочее время с 9.00 до 18.00, следовательно необходимо задать два интервала для нерабочего времени: 00:00-09:00 и 18:00-23:59.
Более подробно разберём команду ExecIfTime. Эта команда выполняет указанное приложение Asterisk, если текущее время соответствует заданной спецификации времени. В нашем случае команда выполняет проигрывание звукового файла, расположенного в директории /offload/asterisk/sounds/other/out_work_times в MikoPBX. Синтаксис команды:
times - Диапазоны времени в 24-часовом формате
weekdays - Дни недели (mon, tue, wed, thu, fri, sat, sun)
mdays - Дни месяца (1-31)
months - Месяцы (jan, feb, mar, apr и т. д.)
appname[(appargs)] - команда Asterisk с указанием параметров вызова
В нашем примере указаны диапазон времени, диапазон дней недели. Вместо указания дней месяцев и месяцев введены *. Этот символ означает «для всех остальных случаев».
При настройке входящей маршрутизации часто возникает ситуация, когда провайдер предоставляет учетную одну запись SIP для нескольких купленных номеров телефонов.
К примеру у МИКО есть номера телефонов:
+7(495)229-30-42
+7(499)638-25-84
В интерфейсе MikoPBX создана только одна учетная запись «Провайдер телефонии». Каждый номер телефона необходимо направить на свой маршрут, к примеру на различные IVR.
Тут к приходит на помощь DID номер, который провайдер может передавать при входящих звонках. Зная DID номер, можно для провайдера описать несколько входящие маршрутов, с различными DID, что позволит решить описанную выше задачу.
Для анализа звонков я обычно использую «приложение Sngrep». Вот пример запроса от провайдера при входящем:
При получении такого пакета, MikoPBX проанализирует первую строку с ключевым словом «INVITE», значение «84996382584» и будет являться DID номером.
На практике, не всегда все так просто. К примеру я встречал провайдера, который присылает следующий INVITE:
В этом случае в строке «INVITE» описывается логин учетной записи, в вот DID уже описывается в заголовке «To». Для корректной настройки достаточно в разделе Кастомизация системных файлов добавить в конец файла «extensions.conf» следующие строки:
функция «PJSIP_HEADER» считывает значение заголовка «To»
функция «PJSIP_PARSE_URI» получает из значения заголовка поле «user», которое соответствует значению DID
Gosub перемещает канал в начало, для повторной инициализации маршрута
SIP-1622040384 - это ID учетной записи провайдера MikoPBX, можно подсмотреть в адресной строке браузера при редактировании учетной записи
Такое встречается при использовании сервиса roistat. Сервис при входящем может прислать следующий запрос:
Корректного DID нет ни в INVITE, ни в поле To, но при этом появился новый заголовок «x-roistat-phone».
Для корректной настройки достаточно в разделе Кастомизация системных файлов добавить в конец файла «extensions.conf» следующие строки:
функция «PJSIP_HEADER» считывает значение заголовка «x-roistat-phone»
Gosub перемещает канал в начало, для повторной инициализации маршрута
Получение номера, на который позвонил клиент из поля «Diversion»:
Получение номера, на который позвонил клиент из заголовка «CALLED_DID»:
Клиент звонит в компанию, звучит приветственное сообщение (голосовое приветствие).
Во время проигрывания голосового приветствия клиент может набрать любой внутренний номер, например, добавочный номер сотрудника.
Также клиент может ввести с телефона цифры:
1 - вызов в этом случае направится на сотрудника с внутренним номером 201.
2 - вызов направится на сотрудника с внутренним номером 202.
Если клиент ничего не ввел / некорректно набрал номер, то происходит переадресация на номер по умолчанию - сотрудника с внутренним номером 201.
Схематично задачу можно представить следующим образом:
При звонке на голосовое меню (Номер IVR меню) начинает проигрываться звуковой файл «Голосовое приветствие».
Во время проигрывания голосового меню можно набрать:
любой внутренний номер, например, добавочный номер сотрудника. За эту возможность отвечает флаг Разрешить донабор любого внутреннего номера.
цифру 1 - вызов направится на сотрудника с внутренним номером 201
цифру 2 - вызов направится на сотрудника с внутренним номером 202
Если во время проигрывания голосового меню клиент ничего не ввел, то после проигрывания голосового меню происходит ожидание 7 секунд для набора комбинации цифр. «Общее время для набора номера» = «Длительность звукового файла» + 7 секунд.
Если «Общее время для набора номера» истекло, то происходит переадресация на «Номер по умолчанию», т.е. на сотрудника с внутренним номером 101.
Если необходимо повторно воспроизвести голосовое приветствие и дать клиенту возможность снова ввести номер, то установите «Количество повторов, перед переводом на номер по умолчанию» в значение 2 и более. Происходит повторное голосовое оповещение и ожидание 7 секунд, то есть следующая попытка IVR. Как только попытки превышают указанное значение - происходит переадресация на «Номер по умолчанию».
Если пользователь некорректно набирает номер или вообще ничего не набирает, то происходит повторное голосовое оповещение (в случае если Количество повторов установлено больше 2-х), либо происходит переадресация на «Номер по умолчанию» (в случае если Количество повторов равно 1).
Настраиваем прием всех входящих звонков через заведенного провайдера на IVR-меню.
Клиент звонит в компанию, звучит приветственное сообщение (голосовое приветствие).
Во время проигрывания голосового приветствия клиент может набрать любой внутренний номер, например, добавочный номер сотрудника или добавочный номер отдела.
После проигрывания голосового приветствия клиент может ввести с телефона цифры:
1 - вызов в этом случае направится в отдел продаж. Отдел продаж - это очередь вызовов, состоящая из двух агентов очереди (двух сотрудников). При звонке в отдел продаж вызов должен поступать на телефоны сотрудников одновременно. Если в течение 25 секунд никто из сотрудников не ответил на звонок клиента, то вызов должен направиться на мобильные номера сотрудников.
2 - вызов направится в отдел технической поддержки. Отдел технической поддержки - это очередь вызовов, состоящая из трех агентов очереди (трех сотрудников). Вызов должен поступать на любого свободного сотрудника (агента очереди). Если клиент ожидает ответ на свой звонок более 30 секунд, то вызов должен быть переведен на секретаря.
Если клиент ничего не ввел / некорректно набрал номер, то происходит повторное голосовое оповещение и клиент может снова ввести номер. Как только все попытки ввода корректного номера для клиента завершатся, то происходит переадресация вызова на секретаря.
Для нашего примера необходимо создать три очереди вызова:
Отдел продаж (мобильные номера сотрудников)
Отдел продаж (внутренние номера сотрудников)
Отдел технической поддержки
Перейдите в раздел Телефония → Очереди вызовов. Нажмите на кнопку «Создать новую очередь».
Создаем очередь вызовов для отдела продаж (для мобильных номеров сотрудников).
Создаем очередь вызовов для отдела продаж (для внутренних номеров сотрудников).
Указываем, что если в течение 25 секунд никто из сотрудников не ответил на звонок клиента, то вызов должен направиться на мобильные номера сотрудников.
Создаем очередь вызовов для отдела технической поддержки.
Перейдите в раздел Телефония → IVR меню. Нажмите на кнопку «Создать новое IVR меню».
Указываем настройки IVR согласно нашему описанию.
На последнем шаге создаем входящий маршрут вызова для нашего провайдера. В разделе Маршрутизация → Входящие маршруты добавляем новое правило.
Заполните данные согласно шаблону:
MikoPBX может определить номер телефона, на который пришел звонок от клиента. Например, сотрудникам компании при поступлении входящего звонка от клиента необходимо понимать, на какой номер позвонил клиент. Данная информация должна выводиться при поступлении звонка от клиента и отображаться на телефоне. Номер, на который позвонил клиент, называется did-номером. Далее в инструкции рассмотрим, каким образом вывести информацию о did-номере на экране Вашего телефона.
Перейдите в раздел Маршрутизация → Провайдеры телефонии. Откройте для редактирования учетную запись провайдера для редактирования. Скопируйте в адресной строке ID провайдера, через которого абоненты звонят Вам в компанию. Обращаем Ваше внимание, что в нашем примере используется единственный провайдер. Если у Вас настроено подключение нескольких провайдеров, то ниже описанные действия необходимо выполнить для каждого провайдера. В нашем примере ID провайдера принимает вид: SIP-1687941868
Перейдите в раздел Система -> Кастомизация системных файлов
Откройте для редактирования конфигурационный файл extensions.conf.
Установите режим «Добавлять в конец файла». В черное окно добавьте следующий фрагмент кода:
В выше приведенном фрагменте кода Вам необходимо составить правильное наименование контекста. Формат создаваемого контекста:
ID-ПРОВАЙДЕРА - значение, которое вы сохранили на первом шаге данной инструкции. В нашем примере это SIP-1687941868.
Помимо did-номера можно вывести наименование провайдера / линии, через которую прошел вызов. Для этого необходимо выполнить следующие действия:
Перейдите в раздел Маршрутизация → Провайдеры телефонии. Откройте учетную запись провайдера для редактирования. В поле Дополнительные параметры задайте переменную с указанием наименования провайдера.
В нашем примере наименование линии будет идентично наименованию провайдера - PT.
Перейдите в раздел Система -> Кастомизация системных файлов
Откройте для редактирования конфигурационный файл extensions.conf.
Установите режим «Добавлять в конец файла». В черное окно добавьте следующий фрагмент кода:
В выше приведенном фрагменте кода Вам необходимо составить правильное наименование контекста. Формат создаваемого контекста:
ID-ПРОВАЙДЕРА - значение, которое вы сохранили на первом шаге данной инструкции. В нашем примере это SIP-1687941868.
1. Создаем учетные записи сотрудников по . Подключаем программные или аппаратные телефоны к данным учетным записям.
Добавляем звуковой файл приветствия по , который будет слышать клиент при звонке на номер компании.
Добавляем новое IVR-меню по .
Добавляем учетную запись провайдера, через которого будут совершаться звонки, по . Примеры подключения провайдеров приведены .
Инструкции по настройке входящей маршрутизации доступны по .
Инструкции по очередям вызовов доступны по .
Предварительно необходимо создать внутренние учетные записи для сотрудников по с указанием их мобильных номеров.
Инструкции по IVR-меню доступны по .
Инструкции по входящим маршрутам доступны по .
Такая необходимость может возникнуть во многих случаях, К примеру когда клиент устал ждать на линии, можно предложить ему оставить голосовое сообщение, соединить с известным клиенту внутренним номером.
Перейдите во вкладку "Кастомизация системных файлов"
Откройте для редактирования файл "queues.conf"
В черном окне найдите секцию очереди, которую необходимо настроить
Выберите режим "Добавлять в конец файла". Добавьте аналогичную секцию с приставкой (+) :
В данном примере мы описали контекст internal, разрешен набор всех внутренних номеров. Можно указать контекст IVR меню, в формате ivr<ВнутреннийНомерIVR>
Задача: На АТС заведено несколько провайдеров А,Б,В,Г… Вызов поступает на MikoPBX через провайдера А. При наборе мобильного номера сотрудника вызов должен также идти через провайдера А. Провайдер должен поддерживать более одного одновременного вызова.
Перейдите в раздел Система → Кастомизация системных файлов
Откройте для редактирования конфигурационный файл extensions.conf.
Установите режим «Добавлять в конец файла». В черное окно добавьте следующий фрагмент кода:
Для каждого провайдера необходимо описать исходящий маршрут
Заполните для сотрудников мобильные номера см. документацию
Ограничьте использование исходящих маршрутов для пользователей, используйте модуль «Группы пользователей»
Теперь если выходящий вызов направить на мобильный сотрудника, к примеру через IVR меню, то вызов будет направлен через того же провайдера, через которого пришел
ВНИМАНИЕ: Инструкции актуальны только для MikoPBX 2022.2.96+
Перейдите в раздел Кастомизация системных файлов
Перейдите к редактированию файла "modules.conf"
Добавьте в конец файла следующий код:
Перейдите к редактированию файла "extensions.conf"
Добавьте в конец файла следующий код:
В карточке сотрудника, в поле «Расширенные настройки» - «Дополнительные параметры» установите значение
Если сотрудник будет занят, то звонящему будет проигран файл beep (короткий гудок), затем вместо гудков будет проигрываться музыка, пока сотрудник не ответит на вызов
device_state_busy_at - это то количество разговоров, при котором следует считать сотрудника «занятым», в этом случае начнут работать правила «Настройки маршрутизации», описанные в карточке сотрудника.
В случае некорректной работы решения задачи, измените код в extensions.conf на:
При подключении к MikoPBX более одного провайдера может сложится ситуация, что номер телефона клиентов поступает в различном формате:
В 7и значном виде - 2293042
Через «+», к пример +79257184444
Через «8», к примеру 89257184444
Появляется необходимость привести все к одному формату.
Перейдите в раздел Маршрутизация → Провайдеры телефонии. Откройте для редактирования учетную запись провайдера для редактирования. Скопируйте в адресной строке ID провайдера, через которого абоненты звонят Вам в компанию. Обращаем Ваше внимание, что в нашем примере используется единственный провайдер. Если у Вас настроено подключение нескольких провайдеров, то ниже описанные действия необходимо выполнить для каждого провайдера.
В нашем примере ID провайдера принимает вид: SIP-1687947415
Перейдите в раздел Система → Кастомизация системных файлов.
Откройте для редактирования конфигурационный файл extensions.conf.
Выберите режим "Добавлять в конец файла". В черное окно добавьте следующий фрагмент кода:
В выше приведенном фрагменте кода Вам необходимо составить правильное наименование контекста. Формат создаваемого контекста:
ID-ПРОВАЙДЕРА - значение, которое вы сохранили на первом шаге данной инструкции. В нашем примере это SIP-1687947415.
Обращаем Ваше внимание, если у Вас в MikoPBX подключено несколько провайдеров, выше описанный фрагмент кода нужно составить для каждого провайдера, учитывая уникальность ID каждого из провайдеров.
Если необходимо добавить нормализацию для всех провайдеров сразу, то достаточно описать контекст «add-trim-prefix-clid-custom». Пример, все 10ти значным АОН добавить 7ку: