Модуль для MikoPBX

Готовое подключение АТС MikoPBX к функции «Звонки»: модуль ставится в саму АТС и сам отдаёт записи разговоров в dxCAR — ничего писать и настраивать «после звонка» не нужно. Подходит для MikoPBX 2026.1 и новее (в поле «минимальная версия» модуля стоит 2025.1.1 — релизов 2025 у MikoPBX не было).

Установка

1. Скачайте пакет модуля ModuleDxCar-<версия>.zip: в dxCAR откройте «Настройки → Звонки», нажмите «Подключить АТС» → MikoPBX — появится карточка с кнопкой «Скачать модуль» и короткой версией этой инструкции. Нажмите «Сохранить» внизу, чтобы карточка осталась.

2. В MikoPBX: Модули расширения → Установить из файла → выберите zip. После установки включите модуль переключателем.

3. Откройте страницу модуля (левое меню, «dxCAR — записи разговоров») и заполните:

   Поле	Откуда взять
   Адрес вебхука dxCAR	dxCAR → Настройки → «Звонки» → «Адрес приёма» (обычно https://<ваш адрес>/calls-hook.php). Адрес с http:// подходит только для dxCAR в локальной сети: через интернет секрет, записи и номера клиентов пошли бы открытым текстом, и страница модуля об этом предупреждает
   Секрет	там же, «Секрет», кнопка «Копировать»
   Минимальная длительность, секунды	по умолчанию 5; разговоры короче не отправляются — в них нечего расшифровывать
   Отправлять входящие / исходящие	что именно слать; внутренние звонки между сотрудниками не отправляются никогда

   Если в MikoPBX включена стереозапись, в карточке MikoPBX в dxCAR укажите, в каком канале голос сотрудника (по умолчанию левый): если в расшифровке сотрудник и клиент поменялись местами — переключите. При моно-записи выбор ни на что не влияет.

4. Нажмите «Проверить связь» — АТС обратится к dxCAR с введённым секретом (сохранять заранее не нужно). Ответы:

   • «dxCAR принял секрет, функция „Звонки“ подключена» — всё готово, сохраняйте;
   • «dxCAR принял секрет. Записи разговоров не принимаются…» — в тарифе есть карточка клиента и дозвон, но не подключено дополнение «Звонки»: они работают, а записи модуль не отправляет (см. «Если что-то не так»);
   • «dxCAR не принял секрет» — секрет скопирован не тот или уже сменён в dxCAR;
   • «В тарифе dxCAR не подключена функция „Звонки“» — включите дополнение в разделе «Подписка»;
   • «dxCAR недоступен» — адрес неверный, либо АТС не выпускают в интернет;
   • «По этому адресу нет вебхука dxCAR» или «Адрес отвечает, но это не вебхук dxCAR» — адрес вписан не тот (например, адрес сайта без /calls-hook.php).

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

Как это работает

• Модуль раз в десять секунд просматривает журнал звонков АТС и ставит новые разговоры в очередь. Запись отправляется, когда АТС закончит её сжимать (обычно через полминуты после разговора). В dxCAR звонок появляется на экране «Звонки» в течение минуты, расшифровка — позже (сроки — в статье Звонки).
• Отправляются только звонки с внешним номером: входящий — от клиента сотруднику, исходящий — от сотрудника клиенту. Внутренний номер сотрудника уходит вместе с записью, поэтому в карточках сотрудников dxCAR заполните поле «Внутренний номер АТС».
• Каждый звонок отправляется один раз: повторная отправка того же разговора (например, после переустановки модуля) dxCAR распознаёт и не дублирует.
• Включили модуль на работающей АТС — старые звонки из журнала не отправляются, только те, что произошли после включения.

Страница модуля

Вверху — состояние: сколько звонков в очереди, отправлено, пропущено (внутренние, короткие, без номера) и с ошибкой; когда модуль последний раз опрашивал журнал; последняя ошибка, если была; строки «Дозвон» и «Карточка клиента». Ниже — форма настроек, ещё ниже — последние двадцать звонков с результатом: номер dxCAR у отправленных, причина у пропущенных и ошибочных.

Если что-то не так

Модуль ничего не удаляет и не меняет в АТС: записи остаются в хранилище MikoPBX как обычно.

Дозвон из dxCAR

Начиная с версии 1.1.0 модуль умеет и обратное: в истории звонков клиента в dxCAR появляется кнопка «Позвонить» — АТС звонит на внутренний номер сотрудника, а после ответа набирает клиента через обычный исходящий маршрут. На странице модуля это переключатель «Дозвон из dxCAR» (после обновления включён) и строка «Дозвон: на связи, опрос …» в блоке состояния. Модуль сам спрашивает dxCAR каждые две секунды, не нажал ли кто «Позвонить», — открывать порты или менять NAT не нужно, достаточно того же адреса и секрета, что для записей.

Обновление: скачайте новый zip на вкладке «Звонки» в dxCAR и установите его поверх — АТС сама добавит новое поле настроек, адрес и секрет сохранятся. В dxCAR у сотрудника должен быть заполнен «Внутренний номер АТС», и он должен существовать в MikoPBX — иначе в dxCAR будет ответ «внутренний номер … в АТС не найден».

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

Пока у сотрудника звонит телефон, в dxCAR всплывает окно с клиентом: кто звонит, его машины и наряды (что именно в окне и кому оно показывается — в статье Звонки). Для этого нужен модуль 1.2.0 и новее: на странице модуля переключатель «Карточка клиента в dxCAR» (после установки и обновления включён) и строка «Карточка клиента: …» в блоке состояния. Модуль сам присылает события в dxCAR на тот же адрес приёма и с тем же секретом, что записи, — открывать порты не нужно. Переключатель, адрес и секрет модуль подхватывает в течение 30 секунд после сохранения.

Что модуль сообщает dxCAR:

• звонит — на внутренний номер сотрудника пришёл звонок с внешней линии; окно получает сотрудник, у которого в dxCAR в карточке указан этот «Внутренний номер АТС»;
• звонок пришёл — через секунду после того, как звонок поступил на АТС, даже если он ещё в голосовом меню или в очереди и ни один телефон не звонит (тогда — через одну–три секунды); такое окно получают сотрудники с галочкой «Показывать все входящие»;
• ответили — кто-то из сотрудников снял трубку; у остальных окно закрывается;
• звонок окончен.

Не передаются: внутренние звонки между сотрудниками, исходящие (в том числе дозвон из dxCAR и обратные звонки, которые АТС начинает сама) и звонки с мобильного сотрудника, заведённого в АТС внутренним номером. Номер клиента в событии — тот, что видит АТС, не длиннее 20 цифр; если номер скрыт, в окне будет «Номер скрыт».

Если звонок идёт по очереди поочерёдно (сначала одному сотруднику, потом следующему), окно у того, кому уже звонили, остаётся до ответа или конца звонка: очередь может позвонить ему снова. Так же, если сотрудник отвечает не на телефон, подключённый к АТС, а на мобильный, куда АТС переадресует вызов, окно у него остаётся до конца звонка: ответ на мобильном модуль не видит.

Новому сотруднику, только что заведённому в MikoPBX, окно может не прийти на первый звонок: модуль перечитывает список внутренних номеров в течение 15 секунд после первого звонка на его телефон или с него, а сам — раз в пять минут.

Если dxCAR не ответил (нет связи, сбой), модуль повторяет отправку через 3, 6, 12 и 15 секунд — но не дольше 30 секунд от события: окно о звонке, который уже закончился, бесполезно.