IP-PBX CRM

Приложение для интеграции вашей АТС Yeastar P-Series с Bitrix24.

Возможности интеграции

Карточка клиента

При входящем звонке открывается карточка найденного клиента в Bitrix24.

Создание лидов

Для новых номеров можно включить автоматическое создание лидов в Bitrix24.

Запись разговоров

Записи разговоров из Yeastar прикрепляются к звонкам в Bitrix24 CRM.

Исходящие звонки

Совершайте исходящие звонки через Yeastar прямо из Bitrix24 CRM, нажимая на номер телефона.

Трансфер звонков

При переводе звонка карточка клиента открывается у сотрудника, принимающего вызов.

История звонков

В кабинете доступны последние входящие и исходящие звонки: время, сотрудник и длительность.

Пропущенные звонки

Пропущенные звонки отображаются в истории звонков приложения и Bitrix24 CRM.

Настройки сотрудников

Для каждого сотрудника можно настроить участие в интеграции и автоподнятие трубки при звонке из CRM.

Подключение

Пошаговая инструкция по первоначальной настройке.

Приложение предоставляет 7 дней бесплатного тестирования. Получите код активации у администратора N-LINK, установите приложение из Bitrix24 Маркета и откройте его. После ввода кода приложение покажет адрес для настройки Yeastar.

Шаг 1 — Установка приложения и получение Webhook URL

Найдите приложение IP-PBX CRM в Bitrix24 Маркете и нажмите Установить. Затем откройте приложение.

На первом шаге приложения введите одноразовый ключ, который лично предоставил администратор N-LINK, и нажмите Продолжить. Код активации имеет формат NL-XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX, где X — цифра или латинская буква от A до F.

На втором шаге приложения, Настройка Yeastar, появится готовый Webhook URL. Скопируйте его для следующего шага. Оставьте приложение открытым: после настройки Yeastar вы вернётесь к этой форме.

Шаг 2 — Настройка Yeastar

Зайдите в панель управления Yeastar и перейдите в Integrations → API.

2.1 Client ID и Client Secret

Скопируйте Client ID и Client Secret — они понадобятся при подключении.

2.2 IP Restriction

Рекомендуется ограничить доступ к API только с сервера интеграции. Включите IP Restriction и добавьте:

Permitted IP: •••.•••.•••.•••
Netmask: 255.255.255.255

Разрешите доступ к API с указанного IP сервера интеграции. Перед сохранением проверьте IP: неверный адрес может нарушить подключение к Yeastar.

2.3 Webhook Event Push

Не выходя из Integrations → API, нажмите Add в блоке Webhook Event Push и заполните:

Webhook URL — скопируйте готовый адрес, указанный на втором шаге приложения IP-PBX CRM, и вставьте его в соответствующее поле Yeastar
Secret — скопируйте значение, оно понадобится при подключении
Request Method: POST
Event: 30011 30012

2.4 Advanced Settings

Завершите настройки раздела Integrations → API. В Extension Status Monitor включите для каждого сотрудника, который будет участвовать в интеграции:

Registration Status
Call Status Monitor (Монитор статуса вызова)
Presence Status Monitor

Это обязательная настройка. Включите Монитор статуса вызова для сотрудников, участвующих в интеграции: без необходимых событий обработка звонков может работать некорректно.

В Trunk Status Monitor включите Call Status Monitor (Монитор статуса вызова) для транков, которые будут использоваться в интеграции.

Это обязательная настройка. Монитор статуса вызова для используемых линий нужен, чтобы приложение получало события о звонках через них.

Control Inbound Call включать не нужно.

2.5 Yeastar FQDN — Remote Access

После завершения настроек API перейдите в System → Network → Yeastar FQDN → Remote Access → Edit и установите:

API Access: ENABLED
Remote Access Service Port: 443

2.6 Security Rules Опционально

Security → Security Rules — рекомендуемое дополнительное усиление безопасности, а не обязательное условие работы интеграции. При необходимости добавьте правило:

Name: Bitrix24 Integration
Action: Accept
Object Type: IP Address
Protocol: Both
Source IP Address: •••.•••.•••.•••
Subnet Mask: 255.255.255.255

Шаг 3 — Завершение подключения в приложении

Вернитесь к открытому приложению IP-PBX CRM. Готовый Webhook URL уже показан над формой настройки Yeastar.

3.1 Данные Yeastar

Заполните поля:

Yeastar FQDN — адрес сервера Yeastar, например company.ras.yeastar.com
Client ID — скопированный на шаге 2.1
Client Secret — скопированный на шаге 2.1
Webhook Secret — скопированный на шаге 2.3
Страна телефонной нумерации — нужна для корректного определения номера при исходящих звонках без кода страны и его сопоставления с CRM. Страна не определяется автоматически и не влияет на входящие звонки.

Нажмите Подключить Yeastar.

3.2 Выбор транков

Отображаются транки из вашей АТС. Для каждого транка:

Включите Интегрировать с Bitrix24 если хотите чтобы звонки через этот транк регистрировались в CRM
При необходимости укажите Caller ID шаблон
Включите «Создавать лид», если для новых номеров на этой линии нужны лиды. Эта настройка также должна быть включена у сотрудника

Нажмите Завершить подключение.

Бренд (название линии в CRM) можно настроить позже в кабинете — вкладка «Транки». Выбранные при подключении параметры «Интегрировать с Bitrix24» и «Создавать лид» отображаются там же.

3.3 Готово

Подключение сохранено. Проверьте настройки сотрудников и линий. После завершения настройки входящие звонки смогут отображаться в Bitrix24.

Кабинет

Управление интеграцией прямо в приложении IP-PBX CRM внутри Bitrix24.

Приложение разделено на вкладки:

Общее — режим ответственного при трансфере, обработка звонков при нескольких активных сделках и последние звонки.
Сотрудники — участники интеграции (см. раздел «Сотрудники»).
Транки — линии и их настройки (см. раздел «Транки»).
Telegram — подключение уведомлений (см. раздел «Telegram-уведомления»).
Подключение — данные доступа к Yeastar.

В верхней части кабинета отображаются статус подписки, состояние подключения к Yeastar, количество подключённых линий, информация о сотрудниках и срок действия подписки.

Первый принявший — ответственный

Тумблер во вкладке Общее. Определяет, кто становится ответственным за лид/сделку при переводе звонка между сотрудниками:

Включено — ответственным остаётся первый принявший звонок, даже если далее звонок перевели на другого сотрудника.

Выключено — ответственным становится последний сотрудник, на которого перевели звонок.

Если найдено несколько активных сделок

Настройка применяется к персональным транкам и определяет, куда добавить звонок, если у клиента найдено несколько активных сделок.

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

Последние звонки

Во вкладке Общее отображается список последних звонков: время, номер, сотрудник, тип (входящий/исходящий), длительность и статус.

Данные подключения

Во вкладке «Подключение» можно изменить параметры подключения к Yeastar:

Yeastar FQDN, Client ID, Client Secret, Webhook Secret.
Здесь же указан IP адрес сервера интеграции (•••.•••.•••.•••) для настроек Yeastar.
Состояние подключения к Yeastar (токен активен или нет) и число активных линий.

После изменения параметров подключения убедитесь, что Yeastar доступна, затем нажмите «Синхронизировать» во вкладке «Транки». Приложение обновит список линий в соответствии с данными АТС. Важно: перед синхронизацией убедитесь, что Yeastar возвращает полный список линий.

Сотрудники

Управление участниками интеграции телефонии и CRM.

Чтобы сотрудник появился в списке, ему необходимо заполнить поле Внутренний телефон в своём профиле Bitrix24.

Как добавить сотрудника

1

Заполните внутренний номер

Сотрудник открывает свой профиль в Bitrix24 и в поле Внутренний телефон указывает внутренний номер из АТС (например: 101).
2

Обновите список

На странице Телефония → приложение IP-PBX CRM во вкладке «Сотрудники» нажмите «Синхронизировать», чтобы загрузить сотрудников из Bitrix24. Для корректного подключения у сотрудников должны быть указаны внутренние номера.
3

Включите тумблер

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

Настройки сотрудника

Участие в интеграции — определяет, будут ли звонки сотрудника обрабатываться приложением и передаваться в Bitrix24. Отключение этой настройки не влияет на работу телефона в Yeastar.

Создавать лид — если автоматическое создание лидов отключено, приложение не будет создавать новые лиды для неизвестных номеров. При этом поиск существующих клиентов и обработка звонков продолжают работать в соответствии с настройками интеграции.

Автоподнятие трубки — если включено, при исходящем звонке из CRM трубка поднимается автоматически без участия сотрудника

Автоподнятие трубки работает только при включённой настройке Auto Answer Paging/Intercom Call в приложении Linkus Desktop или Linkus Mobile. Для аппаратных SIP-телефонов настройка выполняется на самом устройстве.

Количество активных сотрудников ограничено вашей подпиской. Лимит и срок подписки отображаются в верхней части приложения.

Транки

Управление линиями подключения к телефонной сети.

Транки — это линии по которым проходят звонки через вашего оператора связи.

Важно: голосовыми соединениями управляет Yeastar. В приложении IP-PBX CRM вы настраиваете, какие линии участвуют в интеграции с Bitrix24, как обрабатываются звонки и нужно ли создавать лиды.

Голосовой поток звонков не проходит через сервер IP-PBX CRM. Звонки обслуживает ваша АТС Yeastar, а интеграция передаёт в Bitrix24 необходимые сведения о вызовах и доступные записи разговоров.

Настройки транка

Интегрировать с Bitrix24

Включите эту настройку, чтобы звонки выбранной линии обрабатывались интеграцией и отображались в Bitrix24. После синхронизации линия станет доступна в настройках телефонии Bitrix24.

Назначение транка: обычный или персональный

Обычный

По умолчанию линия считается общей. Если она предназначена для конкретного сотрудника, укажите его во вкладке «Транки».

Персональный транк

Линия, закреплённая за конкретным сотрудником. Выберите Ответственный сотрудник — звонки через этот транк будут относиться к нему.

Если для персонального транка ответственный сотрудник не выбран или настроен неверно, регистрация звонка в Bitrix24 может быть пропущена в целях безопасности. Не выбирайте это назначение для общей линии, которой пользуются несколько сотрудников.

Пример

Если отдельная линия закреплена за конкретным сотрудником, выберите Назначение транка → Персональный транк и укажите ответственного сотрудника.

Создавать лид

Отдельный тумблер на каждом транке — создавать ли лид для звонков через эту линию. Лид создаётся только когда «Создавать лид» включено и на транке, и у сотрудника (оба условия). Удобно, если по одним линиям лиды нужны, а по другим — нет.

Бренд / название линии

Название которое будет отображаться в комментарии к лиду/сделке при входящем звонке. Например: Отдел продаж, Филиал 1. Если не заполнено — используется название транка из Yeastar.

Caller ID шаблон

Применяется к номеру входящего абонента для корректного поиска и создания контакта в CRM. Например, для номеров Азербайджана можно использовать шаблон +994{number}. Для других стран укажите соответствующий международный код. К исходящим звонкам не относится.

Синхронизация

Синхронизация транков

Кнопка «Синхронизировать» обновляет список линий по данным Yeastar: добавляет новые и удаляет отсутствующие. Перед синхронизацией убедитесь, что АТС доступна и возвращает полный список линий. Обновление данных в Bitrix24 может занять некоторое время.

Исходящие звонки

Настройте IP-PBX CRM как исходящую линию для вашего портала Bitrix24. Затем убедитесь, что сотрудники, которые будут совершать звонки, выбрали нужную исходящую линию.

1

Откройте настройки телефонии

Bitrix24 → Телефония → Настройки телефонии.
2

Выберите исходящую линию

В поле "Номер для исходящего звонка по умолчанию" — выберите Приложение: IP-PBX CRM.
3

Отключите телефонный аппарат

В поле Телефонный аппарат статус должен быть "Не подключен".

После настройки исходящих звонков сотрудники смогут звонить клиентам прямо из Bitrix24 CRM, нажимая на номер телефона. Вызов выполняется через АТС Yeastar.

Telegram-уведомления

Получайте уведомления о работе интеграции в Telegram.

Во вкладке Telegram можно подключить уведомления в личный чат или группу.

1

Откройте бота

Нажмите Открыть бота во вкладке Telegram (бот @nlink_pbx_bot) и нажмите Старт.
2

Получите Chat ID

Бот пришлёт ваш Chat ID — числовой идентификатор чата.
3

Вставьте и сохраните

Скопируйте Chat ID, включите Получать уведомления, выберите нужные категории и нажмите Сохранить. Без Chat ID галочки недоступны.

Настройки во вкладке Telegram

Получать уведомления — общий переключатель сообщений для вашего чата.
Телефония — сообщения о проблемах обработки звонков, включая длительный сбой регистрации новых звонков в Bitrix24 и подтверждённое восстановление. Один отдельный неудачный звонок не вызывает клиентское сообщение. Важно: даже если уведомления отключены, отдельные сообщения об ошибках обработки звонков могут продолжать поступать в Telegram.
Интеграция — проблемы подключения к Yeastar: уведомление, если приложение потеряло связь с АТС, и сообщение после восстановления подключения.
Подписка — предупреждения об окончании срока, приостановлении доступа и подтверждение продления.

Какие уведомления приходят

Напоминания об окончании подписки — за 7 дней и за 1 день до окончания срока.
Подписка закончилась — доступ к интеграции приостановлен.
Продление подписки — уведомление о новом сроке действия подписки. Для бессрочной подписки сообщается, что ограничение по сроку снято.
Проблемы подключения к Yeastar — уведомление, если приложение потеряло связь с АТС, и сообщение после восстановления подключения.
Два новых звонка за короткое время не удалось зарегистрировать в Bitrix24 — сообщение о проблеме; после подтверждённой регистрации новых звонков — сообщение о восстановлении. Это не подтверждение завершения всех звонков или сохранения записей разговоров.

Chat ID можно указать личный (уведомления придут вам) или группы (для группы идентификатор отрицательный) — тогда их получат все участники.

Частые вопросы

Сотрудника нет в списке или он показан неактивным

Нажмите «Синхронизировать», чтобы обновить список сотрудников из Bitrix24. Если нужный сотрудник не появился, проверьте, указан ли у него внутренний номер.

Сотрудника уволили и завели заново с тем же внутренним номером

Нажмите «Синхронизировать» во вкладке «Сотрудники». После синхронизации проверьте, что сотрудник правильно привязан к внутреннему номеру и его настройки сохранились. Затем убедитесь, что новые звонки отображаются в CRM.

Лиды не создаются

Проверьте обе галочки «Создавать лид»: у сотрудника (вкладка «Сотрудники») и у транка (вкладка «Транки»). Лид создаётся только когда включены обе.

Не приходят Telegram-уведомления

Убедитесь, что вы нажали «Старт» в Telegram-боте @nlink_pbx_bot и правильно указали Chat ID в приложении. Проверьте, включён ли переключатель «Получать уведомления» и выбраны ли нужные категории.

Исходящие не работают

Убедитесь что в Bitrix24 → Телефония → Настройки телефонии → Пользователи телефонии выбрана исходящая линия для сотрудника и статус телефонного аппарата — "Не подключен". Также убедитесь что по умолчанию выбрана исходящая линия Приложение: IP-PBX CRM.

Карточка не всплывает при звонке

Включите Call Status Monitor (Монитор статуса вызова) для нужных внутренних номеров в разделе Advanced Settings → Extension Status Monitor. Для обработки звонков через линии также включите Call Status Monitor в разделе Trunk Status Monitor.

Запись не прикрепляется к CRM

Проверьте, включён ли Монитор статуса вызова (Call Status Monitor) для нужной линии в разделе Advanced Settings → Trunk Status Monitor и настроена ли запись разговоров в Yeastar. Если запись есть в АТС, но не появилась в Bitrix24, обратитесь в поддержку, указав время звонка.

Автоподнятие трубки не работает

В приложении Linkus Desktop или Linkus Mobile включите настройку Auto Answer Paging/Intercom Call. Для аппаратных SIP-телефонов включите автоответ на интерком в настройках самого устройства.

Транки не синхронизируются

Проверьте состояние подключения к Yeastar во вкладке «Подключение», затем повторите синхронизацию. Если ошибка сохраняется, обратитесь в поддержку.

Ошибка подключения к Yeastar

Убедитесь что IP адрес сервера •••.•••.•••.••• добавлен в IP Restriction. Проверьте, что в System → Network → Yeastar FQDN → Remote Access включён API Access и указан порт 443. Security Rules можно настроить дополнительно для усиления безопасности.

Тех. поддержка

По вопросам работы интеграции обращайтесь в поддержку N-LINK: service@n-link.az.

При обращении укажите:

Домен вашего Bitrix24 (например: company.bitrix24.ru)
Описание проблемы