Перейти к содержанию

Подключение своих номеров к Коллтрекингу 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-метод, который:

  1. Принимает дату и время начала и конца интервала, за который требуется передавать в Roistat информацию о звонках.
  2. В пределах принятого интервала времени передает, минимум, первые три пункта из списка данных:
    • номер телефона, с которого звонили;
    • номер АТС, на который звонили;
    • дату и время, когда был совершен звонок;
    • продолжительность разговора;
    • ссылку на запись разговора;
    • статус звонка. Рекомендуем использовать следующие статусы:
    • ANSWER - звонок был принят и обработан сотрудником;
    • BUSY - входящий звонок был, но линия была занята;
    • NOANSWER - входящий вызов состоялся, но в течение времени ожидания ответа не был принят сотрудником;
    • CANCEL - входящий вызов состоялся, но был завершен до того, как сотрудник ответил;
    • CONGESTION - вызов не состоялся из-за технических проблем;
    • CHANUNAVAIL - вызываемый номер был недоступен;
    • DONTCALL - входящий вызов был отменен;
    • TORTURE - входящий вызов был перенаправлен на автоответчик.

Требования к АТС для передачи в Roistat данных по звонкам с помощью Webhook

Создайте Webhook, который вызывает методы phone-call и call/update. После этого разместите в АТС адрес вашего Webhook. Ваш Webhook будет принимать данные из АТС и передавать эти данные в Roistat. 

  1. Webhook с данными на момент начала звонка:
    • номер телефона, с которого звонили;
    • номер АТС, на который звонили;
    • дата и время, когда был совершен звонок.
  2. Webhook с данными после окончания звонка:

    • номер телефона, с которого звонили;
    • номер АТС, на который звонили;
    • дату и время, когда был совершен звонок;
    • продолжительность разговора;
    • ссылку на запись разговора;
    • статус звонка. Рекомендуем использовать следующие статусы:
    • ANSWER - звонок был принят и обработан сотрудником;
    • BUSY - входящий звонок был, но линия была занята;
    • NOANSWER - входящий вызов состоялся, но в течение времени ожидания ответа не был принят сотрудником;
    • CANCEL - входящий вызов состоялся, но был завершен до того, как сотрудник ответил;
    • CONGESTION - вызов не состоялся из-за технических проблем;
    • CHANUNAVAIL - вызываемый номер был недоступен;
    • DONTCALL - входящий вызов был отменен;
    • TORTURE - входящий вызов был перенаправлен на автоответчик.
  3. Возможность передавать в Roistat номер звонящего (А-номер).

Настройка подключения

Шаг 1. Настройте переадресацию звонков с вашего номера на учетную запись SIP от Roistat

Для этого нужно:

  1. Зайти в настройки сервиса (например, в Личный кабинет) оператора связи, у которого вы приобрели номер.
  2. В качестве назначения для переадресации звонка укажите учетную запись SIP от Roistat в формате: ваш номер @pbx.roistat.com .

Пример: 74991111111@pbx.roistat.com, где 74991111111 - тот номер, который вы планируете добавлять.

Активный проброс (использование учетной записи SIP оператора) не поддерживается. Поэтому необходимо уточнить у оператора, через которого вы приобретали номера, возможен ли пассивный проброс звонков на учетные записи SIP.

Шаг 2. Добавьте ваши номера в Roistat

Это можно сделать двумя способами.

  1. Откройте страницу Коллтрекинг  →  Сценарии : 1.png
  2. В настройках сценария на стадии Шаг 1. Подключите номера выберите опцию Свои номера и в поле ввода укажите один или несколько ваших номеров: 2.png
  3. Сохраните настройки шага и перейдите к шагу 3 данной инструкции.

Если номера подключаются к новому сценарию, то они начнут подменяться на сайте только после активации сценария.

Если вы редактируете активный сценарий, то подмена номеров начнется сразу после сохранения сценария (кнопка ** Сохранить сценарий**).

Абонентская плата за использование стороннего номера будет списана с вашего баланса как при простом сохранении нового сценария (кнопка ** Сохранить, не включая**), так и при активации сценария.

Номера отобразятся также на странице ** Коллтрекинг **  →  ** Номера**.

  1. Откройте страницу Коллтрекинг   →   Номера: 3.png
  2. Нажмите Добавить номер, в открывшемся окне выберите опцию Свои номера и в поле ввода укажите один или несколько ваших номеров: 4.png
  3. Чтобы добавить номера к вашему проекту, нажмите кнопку Подключить. После этого абонентская плата будет списана с вашего баланса.

Внимание!

Вы можете подключать как российские, так и иностранные номера.

Стоимость обслуживания внешнего номера составляет 50 рублей в месяц. 

Номера оператора Телезон нельзя подключить в качестве внешних номеров.

Минута разговора стоит 1,4 рубля при переадресации на телефонный номер, разговоры по SIP бесплатны.

Формат номеров

Номера должны указываться  в следующем формате:

  • 74991112233 - для российских номеров (без пробелов);

  • номер содержит 11 цифр;

  • номера перечисляются в поле через запятую с пробелом.

Внимание!

Если хотя бы один из номеров указан некорректно, система не подключит ни один из них и сообщит об ошибке:

3.png

Внимание!

Дублирование номеров невозможно: система их не подключит.

Шаг 3. Активируйте сценарий с вашими номерами

Чтобы Roistat отслеживал звонки на добавленные номера, их необходимо подключить к сценарию и активировать его.

Подробнее читайте в инструкциях Подключение и настройка сценариев коллтрекинга, Номера для подмены.

Поддерживаемые операторы

Вы можете подключить номера следующих операторов:

Гравител, Дом.ru Бизнес, Мегафон (ВАТС), МТТ, ОТК (Открытая телекоммуникационная компания), Телезон, Телфин, Mango Office, MCN Telecom, New-Tel, OnlinePBX, SIPNET, SipOut, Voip.kz, Zadarma, Zebra Telecom.

Операторы, чьи номера  технически невозможно подключить:

CoMagic, Ростелеком

Номера клиентов Билайн могут быть подключены к сценарию, если используется сторонняя конфигурируемая АТС. Порядок подключения следующий: настраивается переадресация на АТС клиента, оттуда переадресация на нашу SIP, а затем переадресация обратно на АТС.

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

Рекомендуемые статьи