Подключение своих номеров к Коллтрекингу Roistat¶
К Коллтрекингу Roistat можно подключать не только номера, приобретенные через Roistat, но и ваши собственные номера. Вы можете добавлять номера разных стран и регионов.
Чтобы использовать номера стороннего оператора в Коллтрекинге Roistat, убедитесь, что:
- Есть возможность переадресовывать номера стороннего оператора на SIP URL pbx.roistat.com;
- Ваш оператор АТС позволяет переадресацию входящих звонков на свои номера на SIP URL вида
[email protected]
, где 7XXXXXXXXXX – номер оператора, используемый в сценарии Коллтрекинга. Если это невозможно, на стороне АТС вы можете настроить передачу в Roistat данных по звонкам на номера АТС с помощью API или Webhook.
Требования для подключения с помощью API
Чтобы сторонняя АТС могла передавать в Roistat данные по звонкам на свои номера, в АТС должен быть доступен API-метод, который:
- Принимает дату и время начала и конца интервала, за который требуется передавать в Roistat информацию о звонках;
- В пределах принятого интервала времени передает, как минимум, первые три пункта из списка данных:
- Номер телефона, с которого звонили;
- Номер АТС, на который звонили;
- Дату и время, когда был совершен звонок;
- Продолжительность разговора;
- Ссылку на запись разговора;
- Статус звонка. Рекомендуем использовать следующие статусы:
- ACTIVE – звонок в процессе;
- ANSWER – звонок был принят и обработан сотрудником;
- BUSY – входящий звонок был, но линия была занята;
- NOANSWER – входящий вызов состоялся, но в течение времени ожидания ответа не был принят сотрудником;
- CANCEL – входящий вызов состоялся, но был завершен до того, как сотрудник ответил;
- CONGESTION – вызов не состоялся из-за технических проблем;
- CHANUNAVAIL – вызываемый номер был недоступен;
- DONTCALL – входящий вызов был отменен;
- TORTURE – входящий вызов был перенаправлен на автоответчик.
Требования для подключения с помощью Webhook
Создайте Webhook, который вызывает методы phone-call и call/update. После этого разместите в АТС адрес вашего Webhook. Ваш Webhook будет принимать данные из АТС и передавать эти данные в Roistat.
-
Webhook с данными на момент начала звонка:
- Номер телефона, с которого звонили;
- Номер АТС, на который звонили;
- Дата и время, когда был совершен звонок.
-
Webhook с данными после окончания звонка:
- Номер телефона, с которого звонили;
- Номер АТС, на который звонили;
- Дату и время, когда был совершен звонок;
- Продолжительность разговора;
- Ссылку на запись разговора;
- Статус звонка. Рекомендуем использовать следующие статусы:
- ANSWER – звонок был принят и обработан сотрудником;
- BUSY – входящий звонок был, но линия была занята;
- NOANSWER – входящий вызов состоялся, но в течение времени ожидания ответа не был принят сотрудником;
- CANCEL – входящий вызов состоялся, но был завершен до того, как сотрудник ответил;
- CONGESTION – вызов не состоялся из-за технических проблем;
- CHANUNAVAIL – вызываемый номер был недоступен;
- DONTCALL – входящий вызов был отменен;
- TORTURE – входящий вызов был перенаправлен на автоответчик.
-
Должна быть возможность передавать в Roistat номер звонящего (А-номер).
-
В сценарии при настройке переадресации нужно выбрать опцию Учетная запись SIP и ввести адрес 1@noneed.ru:
Настройка подключения¶
Шаг 1. Настройте переадресацию звонков с вашего номера на учетную запись SIP от Roistat¶
Для этого нужно:
- Зайти в настройки сервиса (например, в Личный кабинет) оператора связи, у которого вы приобрели номер.
-
В качестве назначения для переадресации звонка укажите учетную запись SIP от Roistat в формате:
ваш номер@pbx.roistat.com
.Пример: 74991111111@pbx.roistat.com, где 74991111111 – номер, который вы планируете добавлять.
Активный проброс (использование учетной записи SIP оператора) не поддерживается. Поэтому необходимо уточнить у оператора, через которого вы приобретали номера, возможен ли пассивный проброс звонков на учетные записи SIP.
Шаг 2. Добавьте ваши номера в Roistat¶
Это можно сделать двумя способами.
Способ 1
-
Раскройте меню Roistat в левом верхнем углу, перейдите в раздел Коллтрекинг. Откройте вкладку Сценарии и нажмите Добавить сценарий. Вы также можете добавить номера в существующий сценарий, нажав на иконку шестеренки в столбце Действия.
-
В настройках сценария на стадии 1. Подключите номера выберите опцию Добавить свои номера и в поле ввода укажите один или несколько ваших номеров через запятую (без символов и пробелов):
-
Перейдите к шагу 3, чтобы продолжить настройку сценария.
-
Если номера подключаются к новому сценарию, они начнут отображаться на сайте только после активации сценария.
-
Если вы редактируете активный сценарий, ротация номеров начнется сразу после нажатия кнопки Сохранить сценарий.
-
Абонентская плата за использование стороннего номера будет списана с вашего баланса как при простом сохранении нового сценария (кнопка Сохранить, не включая), так и при активации сценария.
-
Номера отобразятся также на странице Коллтрекинг → Номера.
Способ 2
-
Раскройте меню Roistat в левом верхнем углу, перейдите в раздел Коллтрекинг и кликните на вкладку Номера:
-
Нажмите Добавить номера, в открывшемся окне выберите опцию Добавить свои номера и в поле ввода укажите один или несколько ваших номеров через запятую (без символов и пробелов):
-
Чтобы добавить номера к вашему проекту, нажмите кнопку Подключить. После этого абонентская плата будет списана с вашего баланса.
-
Вы можете подключать как российские, так и иностранные номера.
-
Номера оператора Телезон нельзя подключить в качестве внешних номеров.
-
Разговоры по SIP бесплатны.
Формат номеров
Номера должны указываться в следующем формате:
74991112233
– для российских номеров (без пробелов);- Номер должен содержать 11 цифр;
- Номера перечисляются в поле через запятую с пробелом.
Обратите внимание:
-
Если хотя бы один из номеров указан некорректно, система не подключит ни один из них и сообщит об ошибке.
-
Дублирование номеров невозможно: система их не подключит.
Шаг 3. Активируйте сценарий с вашими номерами¶
Чтобы Roistat отслеживал звонки на добавленные номера, их необходимо подключить к сценарию и активировать его.
Подробнее читайте в инструкциях:
Подключение и настройка сценариев коллтрекинга
номера для коллтрекинга
Поддерживаемые операторы¶
Вы можете подключить номера следующих операторов:
AirCall, AltegroFON, АТС Hive от iptelefon.ru, CallGear, Mango Office, MCN Telecom, Neirika, New-Tel, onlinePBX, Runtel, SIPMarket, SIPNET, SipOut, Sipuni, UISCOM, Voice_Connect, Voip.kz, Zadarma, Zebra Telecom, 8800 Ассоциация, Билайн, Битрикс24, Дом.Ру Бизнес, Гравител, МГТС, МегаФон (ВАТС), Мобилон, Мосинтер, МТТ, Новотелс, Нью-Тел, ОТК (Открытая телекоммуникационная компания), Связь-Холдинг, ТелеСтор, Телфин.
Операторы, чьи номера технически невозможно подключить: CoMagic, Ростелеком.
Номера остальных операторов нужно проверять на возможность подключения к нашей системе.