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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Подключение и настройка сценариев Коллтрекинга
• Номера для подмены