Views: 2662
Last Modified: 08.09.2022

Bitrix24 On-premise requires additional server and module configuration for Open Channels to operate correctly.

Open Channels is a method of communication with company customers, site visitors, allowing to collect messages from various channels (messengers, social networks) in Bitrix24. Such messaging the distributed by queue rules between employees and securely saved inside CRM.

Attention! Such configuration is accessible for a System administrator only.

  General server settings


  1. Full external access to http://website address/pub/imconnector/, to the root and all files and subdirectories.
  2. Active license key.
  3. Access from the account to all external third-party URLs, specifically to Facebook and others via http and https.
  4. Nginx parameter setup: nginx proxy_ignore_client_abort on. This setting must be enabled for a specific location.
  5. When using php-fpm, instead of nginx proxy_ignore_client_abort on use the parameter fastcgi_ignore_client_abort on.
  6. For Online chat connector:
    • allow X-Frame-Options SAMEORIGIN for location /online/(/?)([^/]*) (opens this page as a frame from any site or a site, containing this frame). Such settings are available in both Nginx and in the module Proactive protection in the section Anti-frame protection (Settings > Proactive protection > Anti-frame protection);

Note: In some cases, redirects must be disabled for such connector file, as ~/index.php for /.

  Connectors for external messengers

The External messenger connectors module settings (Settings > System Settings > Module settings > External messenger connectors) is simple:

  • Website public address - ensure that, account's URL was identified correctly after installation. It must be indicated jointly with account URL and protocol. Closing slash character is optional.
  • Enable debug mode - this option enables error log for connectors in the file /bitrix/modules/imconnector_error.log.

    Note: Only error log is written into the file; enabling this option is only sensible for debugging, this file won't contain a trace log.

  • Connectors in use - selects connectors (channels), ready to be connected.

Attention! When you are unable to connect channels and encounter an error, first and foremost, check a domain name and protocol in the module settings and make sure that this URL can be accessed from the Internet.

  Open Channels

In addition to the The Open Channel module error log (Settings > System Settings >Module Settings > Open Channels) you can enable the Debug mode as well:

Error log is written into the file /bitrix/modules/imopenlines.log.

Note: Only error log is written into the file; enabling this option is only sensible for debugging, this file won't contain a trace log.

Attention! Open Channels create an individual extranet user at the account for each third-party customer. Do not worry, when finding such users in the list of users, this is standard procedure. These are system-generated users.

  Bitrix24 chatbots

The Bitrix24 chatbots module settings (Settings > System Settings >Module Settings > Bitrix24 Chatbots) also have a simple setup:

  • Website public address - ensure that account's URL was identified correctly after installation. It must be indicated jointly with account URL and protocol. Closing slash character is optional.
  • Enable debug mode - this option enables error log for connectors in the file /bitrix/modules/imconnector_error.log.

    Note: Only error log is written into the file; enabling this option is only sensible for debugging, this file won't contain a trace log.

  • Allow longer wait time - option appears after enabling the Debug mode. Enabling it affects the number of occupied hosting workers. When this option is disabled, message is sent to a chatbot and a worker becomes available. When option is enabled, worker will be busy until the chatbot response (and this can take up to dozens of seconds). Enable this option only when failing to configure environment which blocks the incoming queries from marta.bitrix.info.
  • Chatbots option enables chatbots. Default available chatbots include Giphy, Contact Details and etc.

    Note: Find more details about Support chatbot for Bitrix24 On-premise in this article.

0


Courses developed by Bitrix24