Подключение своих номеров к Коллтрекингу Roistat¶
С помощью Коллтрекинга Roistat вы можете отслеживать звонки не только на номера, приобретенные через Roistat, но и на другие ваши номера телефонов.
Внимание!
Чтобы использовать номера стороннего оператора в Коллтрекинге Roistat, требуется:
- Возможность переадресовывать номера стороннего оператора на SIP URL pbx.roistat.com.
- Оператор АТС, номера которого вы хотите использовать, должен иметь возможность переадресовывать входящие звонки на свои номера на SIP URL вида 7XXXXXXXXXX@pbx.roistat.com, где 7XXXXXXXXXX - номер оператора, используемый в сценарии Коллтрекинга для подмены.
- Если оператор АТС не может переадресовывать входящие звонки на свои номера на SIP URL вида 7XXXXXXXXXX@pbx.roistat.com, на стороне АТС вы можете настроить передачу в Roistat данных по звонкам на номера АТС с помощью Webhook или API.
Требования к API АТС для передачи в Roistat данных по звонкам на свои номера
Чтобы сторонняя АТС могла передавать в Roistat данные по звонкам на свои номера, в АТС должен быть доступен API-метод, который:
- Принимает дату и время начала и конца интервала, за который требуется передавать в Roistat информацию о звонках.
- В пределах принятого интервала времени передает, минимум, первые три пункта из списка данных:
- номер телефона, с которого звонили;
- номер АТС, на который звонили;
- дату и время, когда был совершен звонок;
- продолжительность разговора;
- ссылку на запись разговора;
- статус звонка. Рекомендуем использовать следующие статусы:
- ANSWER - звонок был принят и обработан сотрудником;
- BUSY - входящий звонок был, но линия была занята;
- NOANSWER - входящий вызов состоялся, но в течение времени ожидания ответа не был принят сотрудником;
- CANCEL - входящий вызов состоялся, но был завершен до того, как сотрудник ответил;
- CONGESTION - вызов не состоялся из-за технических проблем;
- CHANUNAVAIL - вызываемый номер был недоступен;
- DONTCALL - входящий вызов был отменен;
- TORTURE - входящий вызов был перенаправлен на автоответчик.
Требования к АТС для передачи в Roistat данных по звонкам с помощью Webhook
Создайте Webhook, который вызывает методы phone-call и call/update. После этого разместите в АТС адрес вашего Webhook. Ваш Webhook будет принимать данные из АТС и передавать эти данные в Roistat.
- Webhook с данными на момент начала звонка:
- номер телефона, с которого звонили;
- номер АТС, на который звонили;
- дата и время, когда был совершен звонок.
-
Webhook с данными после окончания звонка:
- номер телефона, с которого звонили;
- номер АТС, на который звонили;
- дату и время, когда был совершен звонок;
- продолжительность разговора;
- ссылку на запись разговора;
- статус звонка. Рекомендуем использовать следующие статусы:
- ANSWER - звонок был принят и обработан сотрудником;
- BUSY - входящий звонок был, но линия была занята;
- NOANSWER - входящий вызов состоялся, но в течение времени ожидания ответа не был принят сотрудником;
- CANCEL - входящий вызов состоялся, но был завершен до того, как сотрудник ответил;
- CONGESTION - вызов не состоялся из-за технических проблем;
- CHANUNAVAIL - вызываемый номер был недоступен;
- DONTCALL - входящий вызов был отменен;
- TORTURE - входящий вызов был перенаправлен на автоответчик.
-
Возможность передавать в Roistat номер звонящего (А-номер).
Настройка подключения¶
Шаг 1. Настройте переадресацию звонков с вашего номера на учетную запись SIP от Roistat¶
Для этого нужно:
- Зайти в настройки сервиса (например, в Личный кабинет) оператора связи, у которого вы приобрели номер.
- В качестве назначения для переадресации звонка укажите учетную запись SIP от Roistat в формате: ваш номер @pbx.roistat.com .
Пример: 74991111111@pbx.roistat.com, где 74991111111 - тот номер, который вы планируете добавлять.
Активный проброс (использование учетной записи SIP оператора) не поддерживается. Поэтому необходимо уточнить у оператора, через которого вы приобретали номера, возможен ли пассивный проброс звонков на учетные записи SIP.
Шаг 2. Добавьте ваши номера в Roistat¶
Это можно сделать двумя способами.
- Откройте страницу Коллтрекинг → Сценарии :
- В настройках сценария на стадии Шаг 1. Подключите номера выберите опцию Свои номера и в поле ввода укажите один или несколько ваших номеров:
- Сохраните настройки шага и перейдите к шагу 3 данной инструкции.
Если номера подключаются к новому сценарию, то они начнут подменяться на сайте только после активации сценария.
Если вы редактируете активный сценарий, то подмена номеров начнется сразу после сохранения сценария (кнопка ** Сохранить сценарий**).
Абонентская плата за использование стороннего номера будет списана с вашего баланса как при простом сохранении нового сценария (кнопка ** Сохранить, не включая**), так и при активации сценария.
Номера отобразятся также на странице ** Коллтрекинг ** → ** Номера**.
- Откройте страницу Коллтрекинг → Номера:
- Нажмите Добавить номер, в открывшемся окне выберите опцию Свои номера и в поле ввода укажите один или несколько ваших номеров:
- Чтобы добавить номера к вашему проекту, нажмите кнопку Подключить. После этого абонентская плата будет списана с вашего баланса.
Внимание!
Вы можете подключать как российские, так и иностранные номера.
Стоимость обслуживания внешнего номера составляет 50 рублей в месяц.
Номера оператора Телезон нельзя подключить в качестве внешних номеров.
Минута разговора стоит 1,4 рубля при переадресации на телефонный номер, разговоры по SIP бесплатны.
Формат номеров
Номера должны указываться в следующем формате:
-
74991112233 - для российских номеров (без пробелов);
-
номер содержит 11 цифр;
-
номера перечисляются в поле через запятую с пробелом.
Внимание!
Если хотя бы один из номеров указан некорректно, система не подключит ни один из них и сообщит об ошибке:
Внимание!
Дублирование номеров невозможно: система их не подключит.
Шаг 3. Активируйте сценарий с вашими номерами¶
Чтобы Roistat отслеживал звонки на добавленные номера, их необходимо подключить к сценарию и активировать его.
Подробнее читайте в инструкциях Подключение и настройка сценариев коллтрекинга, Номера для подмены.
Поддерживаемые операторы¶
Вы можете подключить номера следующих операторов:
Гравител, Дом.ru Бизнес, Мегафон (ВАТС), МТТ, ОТК (Открытая телекоммуникационная компания), Телезон, Телфин, Mango Office, MCN Telecom, New-Tel, OnlinePBX, SIPNET, SipOut, Voip.kz, Zadarma, Zebra Telecom.
Операторы, чьи номера технически невозможно подключить:
CoMagic, Ростелеком
Номера клиентов Билайн могут быть подключены к сценарию, если используется сторонняя конфигурируемая АТС. Порядок подключения следующий: настраивается переадресация на АТС клиента, оттуда переадресация на нашу SIP, а затем переадресация обратно на АТС.
Номера остальных операторов нужно проверять на возможность подключения к нашей системе.