Для работы открытых линий в «Битрикс24 в коробке» необходимо сделать предварительные настройки сервера и модуля портала.

Общие серверные настройки

Для начала необходимо убедиться в правильности серверных настроек:

1. Доступ извне к адресу https://адрес_портала/pub/imconnector/, к корню и всем файлам и поддиректориям.

2. Должен быть действующий лицензионный ключ.

3. Доступ со стороны сервера ко всем внешним адресам сервисов, которые будут использоваться в качестве коннекторов (Viber, ВКонтакте и т.п) по протоколам http и https.

4. Параметр Nginx: nginx proxy_ignore_client_abort on необходимо включать для конкретного location.

5. Если используется php-fpm, вместо nginx proxy_ignore_client_abort on нужно использовать параметр fastcgi_ignore_client_abort on.

6. Для работы коннектора Онлайн-чат: для location /online/(/?)([^/]*) разрешить X-Frame-Options SAMEORIGIN (открывать эту страницу как фрейм из любого сайта или только того, где будет расположен фрейм). Такие настройки могут быть в Nginx и в модуле Проактивная защита в разделе Защита от фреймов (Настройки > Проактивная защита > Защита от фреймов);

7. Для работы коннектора Битрикс24.Нетворк:

   • установленный и настроенный модуль Чат-боты Битрикс24 (imbot);
   • доступ без авторизации к странице /pub/imbot.php;
   • если возникают проблемы с прохождением сообщений даже при таких настройках, необходимо включить опцию Долгое ожидания ответа в опциях модуля Чат-боты Битрикс24.

Настройка модуля Коннекторы для внешних мессенджеров

Настройка модуля Коннекторы для внешних мессенджеров (Настройки > Настройки продукта > Настройки модулей > Коннекторы для внешних мессенджеров) проста:

• Публичный адрес сайта – нужно убедиться, что после установки был верно определен адрес портала. Он должен быть указан вместе с адресом портала и протоколом. Закрывающий слэш не обязателен.

• Включить режим отладки – эта опция включает лог ошибок работы коннекторов в файл /bitrix/modules/imconnector_error.log.

  Примечание: В файл пишется только лог ошибок, включать данную опцию имеет смысл только для отладки, лог трассировки сообщений в этот файл не пишется.

• Список используемых коннекторов – здесь выбираются коннекторы (каналы), доступные к подключению.

Настройка модуля Открытые линии

Для ведения лога ошибок самого модуля Открытые линии (Настройки > Настройки продукта >Настройки модулей > Открытые линии) можно также включить Режим отладки:

Лог ошибок пишется в файл /bitrix/modules/imopenlines.log. В этот файл пишется только лог ошибок, включать данную опцию имеет смысл только для отладки, лог трассировки сообщений в этот файл не пишется.

Настройка модуля Чат-боты Битрикс24

Настройки модуля Чат-боты Битрикс24 (Настройки > Настройки продукта >Настройки модулей > Чат-боты Битрикс24) также особой сложности не вызывают:

• Публичный адрес сайта – также должен быть правильно определен адрес портала. Он должен быть указан вместе с адресом портала и протоколом. Закрывающий слэш не обязателен.

• Режим отладки – опция включает логгирование работы модуля в файле /bitrix/modules/imbot.log.

  Примечание: В файл пишется только лог ошибок, включать данную опцию имеет смысл только для отладки, лог трассировки сообщений в этот файл не пишется.

• Долгое ожидание ответа – опция появляется после включения Режима отладки. Включение влияет на количество занятых worker-ов хостинга. Без активации этой опции сообщение чат-боту отправляется и worker освобождается. В случае активации опции worker будет занят до момента ответа чат-ботом (а это может занимать десятки секунд). Поэтому включать эту опцию нужно, только если не получилось корректно настроить окружение, и оно блокирует входящие запросы от marta.bitrix.info.

• Чат боты – опции включения чат-ботов. По умолчанию есть возможность включить чат-боты Giphy, Реквизиты контрагента и Поддержка Битрикс24 в коробке.

  Примечание: Подробнее про чат-бот Поддержка Битрикс24 в коробке можно прочитать в одноименной статье.