Установка модуля

Облачный Битрикс24

Облачная версия Битрикс24 пока не поддерживается: там нужен не модуль, а отдельное приложение Маркетплейса. Поддержка облака — скоро, но сроки пока под вопросом.

Что понадобится

• Коробочная версия Битрикс24 с модулями main, im, intranet и ui версии 23.0 или новее. Мастер установки сам проверит совместимость и покажет, чего не хватает. Проверено на коробке Битрикс24 версий 26.x.
• База данных MySQL или MariaDB. PostgreSQL не поддерживается — мастер не даст установить.
• PHP 8.1 или новее.
• HTTPS с действительным сертификатом (по http и с самоподписанным сертификатом приложение не подключится), и портал должен открываться с телефона — из интернета или через VPN.
• Учётная запись администратора портала; для загрузки файлов — доступ по SSH или FTP/SFTP.
• iPhone с iOS 26 и приложение «NeonWorks Голос» из App Store — бесплатное (до публикации — бета в TestFlight, приглашение можно запросить в поддержке).

Перед установкой

Сделайте резервную копию портала (Настройки → Инструменты → Резервное копирование) — это стандартная предосторожность перед установкой любого модуля.

Установка — шаг за шагом

1. Скачайте архив neonworks.voice-1.1.1.zip по кнопке выше и при желании сверьте SHA-256.
2. Распакуйте его так, чтобы получилась папка /local/modules/neonworks.voice/ в корне сайта (если папки /local/modules/ нет — создайте её). Подойдёт и /bitrix/modules/neonworks.voice/. Владелец файлов — пользователь веб-сервера.
3. Через SSH это три команды: cd /home/bitrix/www/local/modules → unzip ~/neonworks.voice-1.1.1.zip → chown -R bitrix:bitrix neonworks.voice (путь и владелец — как на «Виртуальной машине Битрикс»; у вас могут отличаться). Через FTP/SFTP — распакуйте архив на компьютере и загрузите папку neonworks.voice целиком.
4. Откройте административную часть портала: Marketplace → Установленные решения.
5. Найдите строку «Голос для Битрикс24» (описание — «Голосовые сообщения в чат с iPhone») и нажмите «Установить».
6. В мастере выберите, кому можно писать из приложения: «Тестовый режим: только тестовым пользователям и себе» (по умолчанию; укажите ID тестовых пользователей) или «Всем сотрудникам». Для начала рекомендуем тестовый режим.
7. Укажите путь страницы подключения телефона — по умолчанию /voice/. Служебные каталоги нельзя: путь не может быть внутри /bitrix/, /local/, /upload/ или /extranet/. Завершите установку — модуль создаст таблицы, страницу и фоновую задачу очистки журнала. Ядро портала и файлы меню не меняются.
8. Сотрудник открывает на компьютере страницу /voice/ и нажимает «Подключить телефон» — появляется QR-код и запасной код из 10 символов (действует 5 минут). Подключать телефон могут только действующие сотрудники — не экстранет, не боты и не внешние пользователи.
9. В приложении на iPhone сотрудник сканирует QR-код (или вводит код вручную).
10. На странице /voice/ появляется запрос «Подключить „iPhone …“?» — сотрудник нажимает «Да». Телефон подключён: можно говорить.

Ссылка на страницу в меню

Пункт левого меню модуль не добавляет. Чтобы сотрудники нашли страницу подключения телефона, добавьте в левое меню ссылку на /voice/ через настройку меню портала или просто разошлите адрес страницы.

Как переключить режим адресатов

По умолчанию включён тестовый режим. Переключение — в настройках модуля: Настройки → Настройки продукта → Настройки модулей → «Голос для Битрикс24» (или /bitrix/admin/settings.php?mid=neonworks.voice). Выберите «Тестовый режим: только тестовым пользователям и себе» или «Всем сотрудникам», при тестовом — перечислите ID тестовых пользователей, сохраните. Изменение действует сразу, переподключать телефоны не нужно.

По умолчанию приложению через API доступны только сообщения в чат.

Обновление

1. Распакуйте новую версию поверх папки /local/modules/neonworks.voice/.
2. Откройте настройки модуля «Голос для Битрикс24» и нажмите «Обновить файлы» (страница настроек сама предупредит, что файлы от старой версии). Обновятся API, компонент и страница подключения, докатятся таблицы; устройства, журнал и настройки сохраняются.

Другой путь: «Удалить» с включённой галочкой «Сохранить данные» → «Установить» заново.

Лицензия

• Лицензия считается по местам: место — это сотрудник с подключённым телефоном (несколько телефонов одного человека — одно место). Лицензия привязана к адресу портала.
• При установке модуль сам включает пробный период — 30 дней на 5 мест, если у портала есть выход в интернет к https://b24voice.neonworks.app. Нет сети — модуль ставится, а пробный период включится при следующей проверке.
• Для портала на внутреннем адресе (например, portal.local или IP) пробный период автоматически не включается — модуль покажет ошибку с кодом host_not_public. Пробный ключ для такого портала можно запросить через форму поддержки.
• Купленный ключ (NW-XXXX-XXXX-XXXX-XXXX) вводится в настройках модуля: Настройки → Настройки продукта → Настройки модулей → «Голос для Битрикс24» → блок «Лицензия» → «Ключ лицензии» → «Сохранить ключ». Там же — статус («пробный период: осталось N дн.», «активна до …», «занято X из N»), кнопка «Проверить сейчас» и список сотрудников, занимающих места, с кнопкой «Освободить место» (отключает все телефоны сотрудника).
• Неверный ключ не сохраняется: прежний ключ и статус остаются, а модуль показывает причину отказа. Кнопка «Удалить ключ» возвращает портал к лицензии на его адрес или к пробному периоду.
• Места занимают только работающие телефоны: заявки без ответа дольше 10 минут, телефоны с истёкшим токеном и телефоны без активности дольше 60 дней (срок меняется в настройках) мест не занимают — модуль отключает их сам.
• Когда все места заняты, новый сотрудник на странице подключения увидит «Все N мест заняты. Обратитесь к администратору портала». При истёкшей или отозванной лицензии отправка из приложения останавливается.
• Модуль проверяет лицензию раз в сутки. Если у портала нет выхода в интернет, приложение на iPhone проверит лицензию само.
• Стоимость — по запросу через форму поддержки. Что передаётся при проверке лицензии — в политике конфиденциальности.

Как удалить модуль

Marketplace → Установленные решения → «Голос для Битрикс24» → «Удалить». Галочка «Сохранить данные (устройства, журнал команд, настройки)» по умолчанию включена:

оставить галочку — таблицы и настройки остаются, после повторной установки телефоны работают без нового подключения;

снять галочку — таблицы и настройки удаляются, токены перестают действовать.

В обоих случаях удаляются API, компонент, страница подключения, обработчик событий и агент. Папку /local/modules/neonworks.voice/ после удаления сотрите вручную. Сообщения, уже отправленные в чат, остаются в чате.

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