Шаг 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

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

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

---

Шаг 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
• При необходимости укажите Caller ID шаблон

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

3.4  Готово

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

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

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

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

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

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

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

Во вкладке Подключение можно в любой момент изменить параметры доступа к Yeastar:

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

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

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

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

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

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

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

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

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

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

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

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

  Bitrix24 → Телефония → Настройки телефонии.
• 2
  Выберите исходящую линию

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

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

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

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

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

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

  Скопируйте Chat ID в поле Chat ID во вкладке Telegram и нажмите Сохранить.

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

• Подписка истекает через 7 дней и за 1 день.
• Подписка истекла — доступ приостановлен.
• Не удалось обновить токен Yeastar — звонки могут не работать, нужно проверить подключение.

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

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

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