Clarify Webtop/Ejabberd integration (#119)

Refs NethServer/dev#7008

ejabberd.rst

@@ -6,8 +6,7 @@ Ejabberd
 
 The Ejabberd module installs the ejabberd Community Server Docker Image (standard protocol Jabber/XMPP) and supports TLS on standard ports (5222 or 5223).
 
-.. warning::
-   Only one instance of Ejabberd can run in a node because of TCP port requirements
+Only one instance of Ejabberd can run on a node to prevent TCP port conflicts.
 
 .. note::
    Ejabberd does not expose anymore the BOSH protocol (NethCTI and other browser-based applications might not work)
@@ -26,7 +25,11 @@ Ejabberd needs a dedicated virtual host name, a FQDN like ``nethserver.org``, Th
 
 Before proceeding with the configuration, make sure to create the corresponding name record inside your DNS server.
 
-.. warning::
+If you want to use the Ejabberd instance as :ref:`Webtop chat engine
+<webtop-chat>`, ensure you enter the same domain name used by Webtop in
+the ``Mail domain`` field on its Settings page.
+
+.. note::
    Let's Encrypt certificate is a mandatory for file sharing clients. Such clients refuse to connect to the server if the certificate is self-signed
 
 How to configure:

webtop.rst

@@ -411,7 +411,7 @@ One of the best functionalities of custom fields is the possibility to perform m
 Custom panels
 =============
 
-Custom panels display the `:ref:`custom_fields-section` and associated them with resources.
+Custom panels display the :ref:`custom_fields-section` and associated them with resources.
 
 Users with the authorization to manage custom fields can access the configuration panel using the button at the top right:
 
@@ -779,16 +779,22 @@ To download the files just access your personal :menuselection:`Cloud --> Upload
 
 .. image:: _static/webtop-doc_cloud11.png
 
+.. _webtop-chat:
+
 Chat integration
 ================
 
 Web chat integration installation is disabled by default for all users.
 
 To enable chat integration:
 
-1. Install the "Instant messaging" module from :guilabel:`Software Center`.
+#. Install the "Ejabberd" application from the ``Software center`` page
+   See :ref:`install-applications` and :ref:`ejabberd-section`.
+
+#. In Ejabberd ``Settings`` page, the field ``Ejabberd domain (FQDN)``
+   must match the value of ``Mail domain`` in Webtop's settings.
 
-2. Access WebTop as admin user then enable the web chat authorization:
+#. Access WebTop as admin user then enable the web chat authorization:
 
    - Access the :guilabel:`Administration` menu, then :menuselection:`Domains --> NethServer --> Groups --> Users --> Authorizations`
    - :menuselection:`Add (+) --> Services --> com.sonicle.webtop.core (WebTop) --> Resource --> WEBCHAT --> Action --> ACCESS`