IP-PBX CRM

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

После подключения система автоматически:

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

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

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

Если номер незнакомый — система создаёт лид автоматически. Настраивается для каждого сотрудника.

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

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

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

Звонить можно прямо из Bitrix24 — нажатием на любой номер телефона в CRM.

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

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

Подключение

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

Перед началом обратитесь к администратору N-LINK — он предоставит ключ активации.

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

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

1.1 Client ID и Client Secret

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

1.2 IP Restriction

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

Permitted IP: 128.140.123.164
Netmask: 255.255.255.255

После включения IP Restriction к API Yeastar сможет обращаться только сервер интеграции — это защищает вашу АТС от несанкционированного доступа.

1.3 Firewall — Security Rules

Убедитесь что в разделе Security → Security Rules разрешены входящие соединения с нашего сервера. Добавьте правило:

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

1.4 Webhook Event Push

Нажмите Add и заполните:

Webhook URL:
https://pbx.n-link.az/api/webhook/{slug}
где {slug} — первая часть домена вашего Bitrix24. Например если портал company.bitrix24.ru — URL будет https://pbx.n-link.az/api/webhook/company
Secret — скопируйте значение, оно понадобится при подключении
Request Method: POST
Event: 30011 30012

1.5 Advanced Settings

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

Registration Status
Call Status Monitor
Presence Status Monitor

Это обязательная настройка. Без включения Extension Status Monitor сервер интеграции не получает события о звонках — карточки не будут всплывать, лиды не создадутся, записи не прикрепятся к CRM.

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

Это обязательная настройка. Без включения Trunk Status Monitor сервер интеграции не получает события о звонках через линии оператора — карточки не будут всплывать, лиды не создадутся, записи не прикрепятся к CRM.

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

Шаг 2 — Установка приложения

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

Шаг 3 — Подключение

После открытия приложения появится форма подключения из 4 шагов.

3.1 Ключ активации

Введите ключ активации который предоставил администратор N-LINK. Формат: NL-XXXX-XXXX.

3.2 Настройка Yeastar

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

Yeastar FQDN — адрес сервера Yeastar, например company.ras.yeastar.com
Client ID — скопированный на шаге 1.1
Client Secret — скопированный на шаге 1.1
Webhook Secret — скопированный на шаге 1.4

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

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

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

Включите Интегрировать с Bitrix24 если хотите чтобы звонки через этот транк регистрировались в CRM
При необходимости укажите Бренд — название отображаемое в CRM (например: Отдел продаж, Филиал 1)
При необходимости укажите Caller ID шаблон

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

3.4 Готово

Интеграция настроена. Входящие звонки уже будут регистрироваться в CRM.

Сотрудники

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

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

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

1

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

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

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

На странице Телефония → приложение IP-PBX CRM нажмите кнопку Update Users — сотрудники появятся в списке.
3

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

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

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

Тумблер участия — если включён, звонки сотрудника регистрируются в CRM

Создавать лид — если включено, при незнакомом номере создаётся лид автоматически

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

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

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

Транки

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

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

Важно: интеграция не использует транки напрямую и не влияет на маршрутизацию звонков. Транки нужны только для того чтобы система знала через какую линию пришёл звонок и отобразила её название в CRM. Вся маршрутизация звонков остаётся на стороне Yeastar.

Голосовой SIP трафик за рамки вашей АТС никуда не выходит. В Bitrix24 передаются только: API запросы о событиях звонков, номера телефонов и файлы записей разговоров.

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

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

Если включено — звонки через этот транк регистрируются в CRM и создаётся линия в телефонии Bitrix24.

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

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

Caller ID шаблон

Форматирование номера при исходящих звонках. Например: +994{number}

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

Sync Trunks

Кнопка Sync Trunks синхронизирует список транков с Yeastar — удаляет транки которых больше нет в АТС, импортирует новые и пересоздаёт линии в Bitrix24. Используйте после любых изменений в транках Yeastar.

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

Настройка выполняется один раз для всего портала.

1

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

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

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

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

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

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

После настройки сотрудник может звонить нажатием на любой номер в CRM — звонок пройдёт через АТС автоматически.

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

Сотрудника нет в списке

Попросите сотрудника заполнить поле "Внутренний телефон" в профиле Bitrix24, затем нажмите Update Users в приложении.

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

Проверьте что у сотрудника включена галочка "Создавать лид" в приложении.

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

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

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

Проверьте что в Yeastar включён Call Status Monitor для нужных extensions в разделе Advanced Settings → Extension Status Monitor. Trunk Status Monitor включать не нужно.

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

Убедитесь что запись разговоров включена в настройках Yeastar для нужных extensions и транков. Запись должна быть доступна в Yeastar в течение 30 минут после звонка — сервер скачивает и передаёт её в Bitrix24.

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

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

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

Убедитесь что токен Yeastar активен — первый токен генерируется в течение 15 минут после подключения. Нажмите Sync Trunks повторно после обновления токена.

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

Убедитесь что IP адрес сервера 128.140.123.164 добавлен в IP Restriction и Security Rules в настройках Yeastar. Проверьте что FQDN вашей АТС доступен извне.

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

По всем вопросам обращайтесь к администратору по адресу service@n-link.az.

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

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