Атс ростелеком битрикс 24 настройка
К Битрикс24 можно, помимо офисной, подключить еще и облачные АТС (не более 10). Под подключением понимается использование одного sip-логина. То есть, если в рамках подключения 4-х АТС имеется по 15 номеров на каждую АТС, но все они обращаются к одному sip-логину, то такие подключения будут работать все. Каждое подключение облачной АТС не ограничено по количеству входящих линий, то есть на это подключение можно направлять неограниченное количество звонков (но число звонков может быть ограничено вашим оператором облачной АТС).
Подключение облачной АТС доступно в двух случаях – Бесплатное подключение своей АТС по Rest API и Интеграция с АТС через SIP-коннектор. Вы можете их использовать эти подключения как отдельно, так и совместно.
Доступ ко всей телефонии Битрикс24 и функциям CRM. Все входящие телефонные звонки будут бесплатными, и вы будете платить за исходящие звонки по вашим текущим расценкам вашему текущему поставщику услуг телефонии. Данная опция доступна во всем мире. Оплачивается ежемесячно отдельно от баланса телефонии. При использовании SIP-коннектора Битрикс24 можно звонить прямо из браузера, десктоп- и мобильного приложения Битрикс24, в отличие от REST-приложений.
Маршрутизация звонков и голосовой трафик полностью остается на стороне вашей АТС. В сравнении с SIP-коннектором это позволяет уменьшить время соединения и улучшить качество связи.
Для REST-приложений недоступны возможности:
- инфозвонок CRM-Маркетинга;
- разговор прямо в браузере/десктопе/мобильном приложении - необходимо использовать отдельное приложение-софтфон или телефон;
- расшифровка звонка в текст (скоро будет в REST API).
В REST API доступно, но возможности зависят от провайдера или разработчика приложения:
- запись звонка;
- поддержка обратного звонка;
- оценка звонка;
- связь номера, на который поступил звонок, с источником лида в CRM.
Т.к настройка подключения своей АТС по Rest API не зависит от Битрикс24, а полностью настраивается в стороннем приложении, мы эти подключения не будем рассматривать – это подробно расписано на странице загрузки этих приложений в Маркете.
Итак, Интеграция с АТС через SIP-коннектор.
Для тестирования функционала вам доступны бесплатные минуты для исходящих звонков. Число бесплатных минут и срок активной лицензии SIP-коннектора выводится на странице Подключение в разделе Телефония.
Если после тестирования вас устроила работа сервиса, и вы собираетесь использовать АТС для исходящих звонков, необходимо оплатить лицензию по кнопке Оплатить подключение модуля для исходящей связи.
- Лицензия на SIP-коннектор приобретается на весь Битрикс24. То есть, если вы будете подключать более одной SIP АТС к вашему Битрикс24, то дополнительно покупать SIP-коннектор не нужно.
- Лицензия на SIP-коннектор приобретается отдельно, т.е она не привязана к счету Телефонии Битрикс24.
- Мы не рекомендуем использовать одновременно REST-приложение телефонии и SIP-подключение от одного и того же провайдера телефонии. Это может вызывать различные ошибки: дублирование вызовов в детализации звонков, отсутствие кнопки «Ответить», при звонке карточка звонка может появляться у другого сотрудника и т.д.
На текущий момент протестирована и проверена работа следующих АТС:
-
. . . . . . .
- Tekmi.
- Telphin (только "Телфин.Офис").
- Youmagic.pro.
- Интертелеком.
- Telecom.kz.
Каких-то специальных технических требований к подключаемым АТС нет, кроме поддержки SIP-протокола. Вы всегда можете попробовать подключить любого оператора. Если он работает по стандартам SIP, проблем с его работой быть не должно.
Для обработки звонков, кроме настроек в Битрикс24, необходимо будет выполнить настройки на сетевом экране (firewall) вашей локальной сети.
Исходящие вызовы
Исходящие вызовы делаются так: пользователь Bitrix24 использует персональный SIP транк Bitrix > 3CX для подключения с учетными данными своего добавочного номера к системе 3CX и звонит через нее точно так же, как он звонил бы из клиента 3CXPhone или любого другого SIP телефона. Единственное отличие – номер должен набираться в полном международном формате, т.е. включая код страны.
Если вы используете облачную версию Bitrix24, разрешите на сетевом экране входящие соединения для IP адреса SIP коннектора Bitrix. Если Bitrix24 расположен локально, это делать необязательно.
Узнаем IP адрес коннектора.
Далее нужно разрешить соответствующим пользователям (добавочным номерам) внешние SIP подключения, поскольку облако Bitrix24 подключается с 3CX извне. Если Bitrix24 расположен локально, этого делать не нужно.
Теперь создадим Bitrix коннектор для добавочного номера. Пусть это будет номер 10.
В данном случае указан публичный IP адрес системы 3CX Phone System и учетные данные добавочного номера 10, которые можно посмотреть в консоли управления 3CX. Аналогично создаются подключения для всех добавочных номеров.
Теперь каждому пользователю Bitrix24 нужно указать такой же внутренний номер и указать, через какой SIP транк делать исходящие вызовы. Это будет персональный SIP транк пользователя. Делается это в разделе Телефония > Пользователи.
После настройки список пользователей будет иметь такой вид.
Теперь пользователь сможет делать исходящие вызовы через 3CX Phone System. Если у вас в 3CX для некоторых операторов используется укороченный набор номера, например, без кода страны, создайте соответствующие преобразующие исходящие правила (как было сказано, Bitrix24 не понимает сокращенный набор номера).
Интеграция с вашей офисной АТС позволяет автоматически выводить карточку клиента при входящем звонке, это упрощает поиск всей необходимой информации по клиенту, в том числе, активные и завершенные сделки, а так же, контактную информацию и всю историю общения.
- CRM уведомляет о вызовах и позволяет в один клик переключаться на карточку сделки или контакта;
- создание сделок, контактов и задач автоматизируется и гибко настраивается;
- звонки автоматически прикрепляются к карточке клиента с возможностью прослушивать записи разговоров (при наличии);
- интеграция позволяет звонить клиентам из карточки контакта в CRM;
- при входящем звонке на экране IP-телефона или коммуникатора отображается имя клиента;
- вызовы автоматически распределяются на ответственных менеджеров и пр.
Подключение интеграции CRM «Битрикс24» с «Виртуальная АТС Ростелеком»
- авторизуйтесь в учетной записи CRM «Битрикс24» как пользователь с правами администратора.
- перейдите в раздел «Приложения» – «Интеграция с телефонией».
- Найдите виджет «ВАТС Ростелеком».
- Нажмите «Посмотреть».
- На открывшейся странице: ознакомьтесь с возможностями виджета и нажмите «Установить», чтобы инициировать включение виджета.
- ознакомьтесь и согласитесь с положениями лицензионного соглашения и политикой конфиденциальности;
- нажмите «Установить», чтобы завершить установку виджета.
- если услуга «Виртуальная АТС» ещё не куплена, нажмите «Подключить услугу "Виртуальная АТС Ростелеком"» – откроется сайт поставщика, где услугу можно заказать;
- если услуга уже приобретена, нажмите «Подключить» – в соседней вкладке откроется страница авторизации в ЛК ВАТС.
- направление вызова, входящий номер;
- имя контакта;
- кнопка перехода на страницу контакта;
- кнопка перехода на страницу лида.
- пропадёт возможность делать исходящие вызовы, прослушивать записи разговоров со страницы контакта в CRM «Битрикс24»;
- перестанут автоматически создаваться лиды для входящих и исходящих звонков;
- не будет работать интеллектуальная маршрутизация.
Версия 1
Интеграция с вашей офисной АТС позволяет автоматически выводить карточку клиента при входящем звонке, это упрощает поиск всей необходимой информации по клиенту, в том числе, активные и завершенные сделки, а так же, контактную информацию и всю историю общения.
- Кликните «Подключить».
- В открывшейся вкладке на странице авторизации «Виртуальной АТС» введите учетные данные администратора.
- Подтвердите подключение CRM в открывшемся модальном окне личного кабинета Виртуальной АТС.
- Вернитесь в виджет для настройки параметров взаимодействия с «Виртуальной АТС» Ростелеком.
- Сопоставьте номера телефонов менеджеров, с внутренними номерами ваших сотрудников «Виртуальной АТС» Ростелеком.
Настройка исходящих вызовов
1. Выберите раздел "Телефония", далее "Настройка телефонии"
2. В меню выберите раздел "Пользователи телефонии"
3. Выберите настройки пользователя,
4. В модальном окне для поля "Номер для исходящиего звонка" выберите Приложение: ВАТС Ростелеком и нажмите на кнопку "Сохранить".
Выбираем пользователя для интеграции
Перед началом интеграции стоит изучить пользовательские настройки маршрутизации и переадресации в личном кабинете ВАТС Ростелеком — далее «ЛК». Они могут быть «чистыми» или уже содержать правила маршрутизации, пользователей и переадресации.
Есть два варианта дальнейших действий:
-
Создать нового отдельного пользователя для интеграции и тестов.
- Есть тарифные ограничения на количество пользователей. Возможно, придется доплатить за нового пользователя. Это стоит выяснить в техподдержке.
- Стоит проверить пользовательские настройки переадресации (ЛК → Пользователи → Пользователь → Переадресация), так как после интеграции с Битрикс24 они перестанут работать. Например, если есть переадресация на мобильный телефон.
- Нужно проверить, залогинен ли этот пользователь на каком-либо другом устройстве или в другой системе. Я запрашивал анализ логов звонков в техподдержке. Если залогинен (первичный признак — зеленый индикатор напротив имени пользователя), то при переадресации будет использоваться тот коннект, который имеет активную сессию с сервером Ростелекома. Это приведет к нестабильной работе интеграции: входящий звонок иногда будет попадать в Битрикс24, иногда на другое устройство.
Пользователь может быть залогинен на маршрутизаторе, однако маршрутизатор может не использоваться по назначению. Решения три:
1) выключить маршрутизатор;
2) изменить регистрационные данные пользователя;
3) разлогинить пользователя на маршрутизаторе.
Настройка supervisor
Supervisor служит для запуска процесса-обработчика событий от Asterisk CallMeIn.php, который отслеживает входящие звонки и взаимодействует с Битрикс24 (показать карточку, скрыть карточку и т.д.).
Файл настроек, который необходимо создать:
Запуск и рестарт приложения:
просмотр статуса работы приложения:
Тестируем звонки в Битрикс24
-
После успешного подключения пользователя к ВАТС Ростелеком, напротив его имени в системе загорится зеленый индикатор.
После выполнения п.2 настройки переадресации пользователя «admin» перестанут работать, и это может привести к тому, что клиенты не дозвонятся до менеджеров компании. Поэтому тестировать лучше либо в нерабочее время, либо по согласованию с компанией, и после окончания тестирования не забыть вернуть правила в исходное состояние.
В сети есть разные варианты интеграции IP-АТС Asterisk и CRM Битрикс24, но мы, все таки, решили написать свою.
По функционалу все стандартно:
- Кликом на ссылку с номером телефона клиента в Битрикс24, Asterisk соединяет внутренний номер пользователя, от имени которого это клик совершен, с номером телефона клиента. В Битрикс24 фиксируется запись о звонке и по окончании вызова подтягивается запись разговора.
- На Asterisk поступает звонок извне — в интерфейсе Битрикс24 показываем карточку клиента тому сотруднику, на номер которого этот звонок прилетел.
Если такого клиента нет, откроем карточку создания нового лида.
Как только звонок завершен, отражаем это в карточке и подтягиваем запись разговора.
Настройки в Битрикс24
Воспользуйтесь кнопкой Облачная АТС.
Далее нажмите кнопку Подключить облачную АТС:
Заполните поля формы для подключения:
-
Название подключения – произвольное название соединения.
Исключение: Для SIPNET в этом поле должен быть указан номер, привязанный к порталу. Этот номер должен обязательно быть в международном 11-значном формате: некоторые национальные операторы могут присылать номер в национальном формате.
Для подключения некоторых облачных АТС требуется указание дополнительных параметров авторизации: пользователь для авторизации (указываются данные из поля auth user в настройках облачной АТС) и прокси-сервер (указываются данные из поля sip outbound proxy в настройках облачной АТС).
Нажмите Сохранить. Данные сохранятся, система перейдет к настройкам маршрутизации.
Статусы подключения облачной АТС
Подключение АТС происходит не сразу, оно проходит несколько статусов:
- в обработке: Идет процесс подключения, через несколько минут вы сможете принимать входящие вызовы.
- получение данных: Идет процесс получения данных о текущем статусе, пожалуйста, подождите.
- ошибка: Во время подключения произошла ошибка. В первую очередь, проверьте корректность указанных вами параметров подключения. Причину ошибки можно увидеть ниже. Эту информацию необходимо передать своему оператору АТС, чтобы решить проблему.
Примечание: Настройка телефонии через MANGO требует изменения настроек в личном кабинете Манго Офис. Подключение Мегафона требует использование услуги Мультифон.
Настройки Firewall локальной сети
По умолчанию используются порты:
- для звонков из браузера: 443 TCP, 3478 TCP/UDP, 8000-48000 UDP.
- для звонков с SIP-аппарата: 5060 TCP/UDP, 3478 TCP/UDP, 8000-48000 UDP.
Обычно для SIP важно, чтобы исходящий трафик был разрешен (с АТС например), а входящие коннекты будут работать автоматически. RTP обычно используется как UDP (чтобы при потере пакетов данные продолжали передаваться).
Сами порты можно настраивать в свойствах АТС: какой там задан, такой нужно открывать и в firewall.
Внимание! Настройка АТС для коробочной версии Битрикс24 должна производиться после настройки модуля для работы с облачной телефонией Телефония (voximplant).
Привет, Хабр! Меня зовут Артем, я бизнес-аналитик и недавно на проекте интегрировал модуль CRM Битрикса c виртуальной АТС Ростелеком.
Делал по стандартной инструкции, где пошагово показано, какие поля заполнять. Оказалось, следование ей не гарантирует, что все заработает: по доброй традиции в какой-то момент «что-то пошло не так». В итоге вместе со специалистами техподдержки Ростелекома мы выяснили, в чем проблема. У клиента в телефонии уже были настроены активные подключения, которые блокировали связь с другими софтфонами или SIP-устройствами.
После того, как я потратил день на поиск причины неполадок и переписку с поддержкой, решил составить расширенную инструкцию с комментариями. Она учитывает «подводные камни» интеграции Битрикса с АТС Ростелеком, и надеюсь, поможет сэкономить время с этой рядовой, но местами хитрой задачей. Поехали.
Заключение
Получилось достаточно сложно, но уверен — опытный администратор сумеет внедрить у себя и порадовать своих пользователей.
Вопросы, пожелания — прошу в комменты. Также если интересно как шла разработка этой интеграции, напишите, а в очередной статье я постараюсь раскрыть все более детально.
Многие компании заинтересованы в интеграции установленной IP АТС 3CX Phone System с корпоративным порталом Bitrix24. В этой статье мы рассмотрим, как произвести такую интеграцию.
Прежде всего отметим недостатки такой интеграции. Дело в том, что в данном случае АТС превращается в простой шлюз, обеспечивающий связь по своим внешним линиям (подключениям). Вы можете видеть статистику, направлять вызовы по наиболее выгодному маршруту и использовать свои SIP номера и шлюзы, однако весь широкий функционал АТС будет вам недоступен. Он доступен только, если вы будете выполнять вызовы из фирменного клиента 3CXPhone или подключенного IP телефона, но не из приложения Bitrix24 Desktop. Это связано с технологией SIP коннектора Voximplant, которую использует Bitrix24. Объединяя системы, мы создаем коннектор, который перехватывает в 3CX все входящие вызовы и направляет их на обработку в Bitrix24. Далее сам Bitrix24 распределяет вызовы между пользователями.
Исходящие вызовы работают по тому же принципу, но с небольшим отличием. Пользователь Bitrix24 подключается с учетными данными своего добавочного номера к 3CX Phone System и делает вызов через ядро системы. Благодаря этому в 3CX доступна статистика вызовов, и возможна некая универсальность, т.е. пользователь может использовать как приложение Bitrix24, так и клиент 3CXPhone.
Настройку интеграции начнем создания коннектора 3CX > Bitrix24. В Bitrix24 в разделе Телефония > Баланс и статистика проверьте возможность подключения SIP коннектора и нажмите кнопку Подключить.
В разделе Телефония > Управление номерами нажмите Подключить офисную АТС.
Вы можете указать публичный IP адрес вашего сервера 3CX и любые логин и пароль. На самом деле эти данные значения не имеют. Затем нажмите кнопку Подключить.
Теперь настроим SIP транк со стороны 3CX Phone System. Выбираем Generic – Generic VoIP Provider.
Имя SIP сервера берется из настроек, выданных Bitrix24.
Поле Внешний номер значения не имеет. Параметр Максимум одновременных вызовов должен быть не меньше максимального количества вызовов, которые могут поступить по внешним линиям 3CX Phone System.
Поскольку этот коннектор служит только для отправки вызовов 3CX > Bitrix24, входящие вызовы на него не предусмотрены.
Исходящее правило мы пока создавать не будем. Нажмите Пропустить.
Затем зайдите в настройки транка и перейдите на закладку Исходящие параметры. Параметр From: Display Name поменяйте на Originator Caller ID. Это нужно сделать для того, чтобы Caller ID входящего вызова корректно передавался из 3CX в Bitrix24. На забудьте нажать OK, чтобы применить изменения.
Убедитесь, что транк успешно зарегистрировался на Bitrix24.
Затем, на всех внешних линиях, которые должны заводится в Bitrix24, установите перевод на внешний номер bitrix24. Теперь все вызовы, приходящие на эти линии, пойдут в обход 3CX в облако Bitrix24 и там распределяться на пользователей средствами Bitrix24.
Заметим, что при необходимости точно знать, на какую именно внешнюю линию пришел вызов, вы можете создать индивидуальные транки между 3CX и Bitrix24 для каждой внешней линии 3CX и дать им характерные названия. А затем направлять вызовы из определенной внешней линии 3CX на соответствующий ей транк.
Схема
Маршрутизация звонков через АТС Ростелеком. Схема условная, сделана на основе авторской реконструкции для иллюстрации процессов маршрутизации, переадресации и возможных конфликтов. Не является первоисточником.
Настройка приложения
Описание параметров приложения:
- CallMeDEBUG — если 1, то в лог файл будут писаться все события, обрабатываемые приложением, 0 — ничего не пишем
- tech — SIP/PJSIP/IAX/etc
- authToken — токен авторизации битрикс24, код авторизации исходящего вебхука
- bitrixApiUrl — URL входящего вебхука, без profile/
- extentions — список внешних номеров
- context — контекст для оригинации звонка
- listener_timeout — скорость обработки событий от asterisk
- asterisk — массив с настройками подключения к астериску:
- host — ip или hostname сервера астериск
- scheme — схема подключения (tcp://, tls://)
- port — порт
- username — имя пользователя
- secret — пароль
- connect_timeout — таймаут подключения
- read_timeout — таймаут чтения
Настройка asterisk
Для успешного взаимодействия Asterisk и Bitrix24 нам нужно добавить AMI-пользователя callme в manager.conf:
Далее есть несколько хитростей, которые потребуется внедрить посредствам dialplan (у нас это extensions.ael).
Привожу весь файл, а после дам пояснения:
Начнем с самого начала: директива globals.
Переменная URLRECORDS хранит в себе URL к файлам записей разговоров, по которому Bitrix24 будет их подтягивать в карточку контакта.
Далее нам интересен макрос макрос recording.
Здесь, помимо записи разговоров, мы установим переменную FullFname.
Она хранит полный URL к конкретному файлу (макрос вызывается везде).
Разберем исходящий звонок:
Допустим мы звоним на 89991234567, первым делом попадаем сюда:
т.е. вызывается макрос записи разговора и проставляются нужные переменные.
записываем кто инициировал звонок и фиксируем время старта звонка.
И по его завершению, в специальном контексте h
отключаем запись в таблицу CDR для этого экстеншена (не нужно оно там), выставляем время завершения звонка, вычисляем продолжительность, если результат звонка не известен — ставим (переменная CallMeDISPOSITION) и, последним шагом, шлем все битриксу через системный curl.
И еще немного магии — входящий звонок:
Здесь нас интересует только одна строка.
Она говорит АТС установить CallerID(name) равным переменной CallMeCallerIDName.
Сама переменная CallMeCallerIDName, в свою очередь, устанавливается приложением CallMe (если в Bitrix24 есть ФИО для номера позвонившего — установим в качестве CallerID(name), нет — ничего не будем делать).
Настройки в Битрикс24
Воспользуйтесь кнопкой Облачная АТС.
Далее нажмите кнопку Подключить облачную АТС:
Заполните поля формы для подключения:
-
Название подключения – произвольное название соединения.
Исключение: Для SIPNET в этом поле должен быть указан номер, привязанный к порталу. Этот номер должен обязательно быть в международном 11-значном формате: некоторые национальные операторы могут присылать номер в национальном формате.
Для подключения некоторых облачных АТС требуется указание дополнительных параметров авторизации: пользователь для авторизации (указываются данные из поля auth user в настройках облачной АТС) и прокси-сервер (указываются данные из поля sip outbound proxy в настройках облачной АТС).
Нажмите Сохранить. Данные сохранятся, система перейдет к настройкам маршрутизации.
Статусы подключения облачной АТС
Подключение АТС происходит не сразу, оно проходит несколько статусов:
- в обработке: Идет процесс подключения, через несколько минут вы сможете принимать входящие вызовы.
- получение данных: Идет процесс получения данных о текущем статусе, пожалуйста, подождите.
- ошибка: Во время подключения произошла ошибка. В первую очередь, проверьте корректность указанных вами параметров подключения. Причину ошибки можно увидеть ниже. Эту информацию необходимо передать своему оператору АТС, чтобы решить проблему.
Примечание: Настройка телефонии через MANGO требует изменения настроек в личном кабинете Манго Офис. Подключение Мегафона требует использование услуги Мультифон.
Настраиваем Битрикс24
Дисклеймер
Общее описание
Свою интеграцию мы назвали CallMe. CallMe — это небольшое веб-приложение, написанное на PHP.
Используемые технологии и сервисы
- PHP 5.6
- Composer
- Nginx + php-fpm
- supervisor
- AMI (Asterisk Manager Interface)
- Вебхуки Bitrix (упрощенная реализация REST API)
Предварительная настройка
На сервере с Asterisk необходимо установить web-сервер (у нас это nginx+php-fpm), supervisor и git.
Команда для установки (CentOS):
Переходим директорию, доступную веб-серверу, тянем из гита приложение и выставляем нужные права на папку:
Далее настроим nginx, наш конфиг разместился в
Если вы все сделали правильно, то перейдя по ссылке должны увидеть нечто подобное
Создаем нового пользователя в ВАТС Ростелеком
Настройка Битрикс24
Создадим два вебхука.
Заполняем параметры входящего вебхука как на скринах:
И жмем сохранить.
После сохранения Битрикс24 предоставит URL входящего вебхука, например:
Сохраните себе ваш вариант URL без завершающего /profile/ — он будет использоваться в приложении для работы с входящими звонками.
Исходящий вебхук.
Приложения -> Вебхуки -> Добавить вебхук -> Исходящий вебхук
Подробности снова на скринах:
Сохраняем и получаем код авторизации
У меня это xcrp2ylhzzd2v43cmfjqmkvrgrcbkni6 . Его тоже нужно скопировать себе, он нужен для совершения исходящих звонков.
На сервере Битрикс24 должен быть настроен ssl-сертификат (можно использовать letsencrypt), иначе api битрикса не будет работать. Если у вас облачная версия, можете не волноваться — там уже есть ssl.
И последним штрихом установим наш CallMeOut в качестве приложения для совершения звонков (чтобы по клику на номер на АТС улетала команда для оригинации звонка).
В меню выбираем: Еще -> Телефония -> Еще -> Настройки, ставим в «Номер для исходящего звонка по-умолчанию» Приложение: CallMeOut и жмем «Сохранить»
Читайте также: