[ADD] Misc: VoIP Axivox Dial Plan Edits

closes #5256

Signed-off-by: Zachary Straub (zst) <zst@odoo.com>

Author: tiku-odoo

content/applications/general/voip.rst

@@ -1,12 +1,21 @@
-:nosearch:
+:show-content:
+:hide-page-toc:
+:show-toc:
 
 ===================================
 VoIP (Voice over Internet Protocol)
 ===================================
 
+.. seealso::
+   For more information, reference the `Odoo eLearning (video tutorials) on VoIP
+   <https://www.odoo.com/slides/voip-voice-over-ip-315>`_
+
 .. toctree::
    :titlesonly:
 
    voip/asterisk
    voip/onsip
    voip/axivox
+   voip/voip_widget
+   voip/devices_integrations
+   voip/transfer_forward

content/applications/general/voip/axivox.rst

@@ -1,86 +1,17 @@
-=====================================
-Use VoIP services in Odoo with Axivox
-=====================================
-
-Introduction
-============
-
-Odoo VoIP can be set up to work together with `Axivox <https://www.axivox.com/>`_. In that case, an
-:doc:`Asterisk server <asterisk>` is not necessary as the infrastructure is hosted and managed by
-Axivox.
-
-To use this service, `contact Axivox <https://www.axivox.com/contact/>`_ to open an account. Before
-doing so, verify that Axivox covers your area and the areas you wish to call.
-
-Configuration
-=============
-
-Go to :menuselection:`Apps` and install the **VoIP Module**.
-
-.. image:: axivox/voip-installation.png
-   :align: center
-   :alt: VoIP module installation on an Odoo database
-
-Go to :menuselection:`Settings --> General Settings --> Integrations`, and fill out the **Asterisk
-(VoIP)** field:
-
-- **PBX Server IP**: set the domain created by Axivox for your account (e.g.,
-  *yourcompany.axivox.com*)
-- **WebSocket**: type in ``wss://pabx.axivox.com:3443``
-- **VoIP Environment**: set as *Production*
-
-.. image:: axivox/voip-configuration.png
-   :align: center
-   :alt: Integration of Axivox as VoIP provider in an Odoo database
-
-Configure the VOIP user in the Odoo's user
-------------------------------------------
-
-Go to :menuselection:`Settings --> Users & Companies --> Users`, then open the user's form you want
-to configure. Under the **Preferences** tab, fill out the section **PBX Configuration**:
-
-- **SIP Login / Browser's Extension**: the Axivox *username*
-- **SIP Password**: the Axivox *SIP Password*
-
-.. image:: axivox/odoo-user.png
-   :align: center
-   :alt: Integration of Axivox user in the Odoo user preference
-
-.. note::
-   You can find all this information by logging in at https://manage.axivox.com/, selecting the user
-   you want to configure, and referring to the fields as pictured below.
-
-   .. image:: axivox/manager-sip.png
-      :align: center
-      :alt: SIP credentials in the Axivox manager
-
-Phone Calls
-===========
-
-You can make phone calls by clicking on the phone icon in the navigation bar.
-
-You can also receive phone calls. Odoo rings and displays a notification.
-
-.. note::
-   Your number is the one provided by Axivox.
-
-.. image:: axivox/incoming-call.png
-   :align: center
-   :alt: Incoming VoIP call in Odoo
-
-.. tip::
-   If you see a *Missing Parameter* message in the **Odoo softphone**, refresh your Odoo window and
-   try again.
-
-   .. image:: axivox/missing-parameter.png
-      :align: center
-      :alt: "Missing Parameter" error message in the Odoo softphone
-
-.. tip::
-   If you see an *Incorrect Number* message in the Odoo softphone, make sure to use the
-   international format, leading with the plus (+) sign followed by the international country code.
-   E.g., +16506913277 (where +1 is the international prefix for the United States).
-
-   .. image:: axivox/incorrect-number.png
-      :align: center
-      :alt: "Incorrect Number" error message in the Odoo softphone
+:nosearch:
+
+====================
+Axivox configuration
+====================
+
+.. toctree::
+   :titlesonly:
+
+   axivox/axivox_config
+   axivox/manage_users
+   axivox/vm_audio_messages
+   axivox/dynamic_caller_id
+   axivox/conference_calls
+   axivox/dial_plan_basics
+   axivox/dial_plan_advanced
+   axivox/call_queues

content/applications/general/voip/axivox/axivox_config.rst

@@ -0,0 +1,73 @@
+=================================
+VoIP services in Odoo with Axivox
+=================================
+
+Introduction
+============
+
+Odoo VoIP (Voice over Internet Protocol) can be set up to work together with `Axivox
+<https://www.axivox.com/>`_. In that case, an :doc:`Asterisk server <../asterisk>` is **not**
+necessary, as the infrastructure is hosted and managed by Axivox.
+
+To use this service, `contact Axivox <https://www.axivox.com/contact/>`_ to open an account. Before
+doing so, verify that Axivox covers the company's area, along with the areas the company's users
+wish to call.
+
+Configuration
+=============
+
+To configure Axivox in Odoo, go to the :menuselection:`Apps` application, and search for `VoIP`.
+Then, install the :guilabel:`VoIP` module.
+
+Next, go to :menuselection:`Settings app --> General Settings --> Integrations section`, and fill
+out the :guilabel:`Asterisk (VoIP)` field:
+
+- :guilabel:`OnSIP Domain`: set the domain created by Axivox for the account (e.g.,
+  `yourcompany.axivox.com`)
+- :guilabel:`WebSocket`: type in `wss://pabx.axivox.com:3443`
+- :guilabel:`VoIP Environment`: set as :guilabel:`Production`
+
+.. image:: axivox_config/voip-configuration.png
+   :align: center
+   :alt: Integration of Axivox as VoIP provider in an Odoo database.
+
+.. tip::
+   Access the domain on the Axivox administrative panel by navigating to `https://manage.axivox.com/
+   <https://manage.axivox.com/>`_. After logging into the portal, go to :menuselection:`Users -->
+   Edit (next to any user) --> SIP Identifiers tab --> Domain`.
+
+Configure VoIP user in Odoo
+---------------------------
+
+Next, the user is configured in Odoo, which **must** take place for every Axivox/Odoo user using
+VoIP.
+
+In Odoo, go to :menuselection:`Settings app --> Users & Companies --> Users`, then open the desired
+user's form to configure :abbr:`VoIP (Voice over Internet Protocol)`. Under the
+:guilabel:`Preferences` tab, fill out the :guilabel:`VOIP Configuration` section:
+
+- :guilabel:`SIP Login` / :guilabel:`Browser's Extension`: (Axivox) :guilabel:`SIP username`
+- :guilabel:`Handset Extension`: SIP external phone extension
+- :guilabel:`SIP Password`: (Axivox) :guilabel:`SIP Password`
+- :guilabel:`Mobile call`: method to make calls on a mobile device
+- :guilabel:`OnSIP authorization User`: (Axivox) :guilabel:`SIP username`
+- :guilabel:`Always Redirect to Handset`: option to always transfer phone calls to handset
+- :guilabel:`Reject All Incoming Calls`: option to reject all incoming calls
+
+.. image:: axivox_config/odoo-user.png
+   :align: center
+   :alt: Integration of Axivox user in the Odoo user preference.
+
+.. tip::
+   Access the domain on the Axivox administrative panel by navigating to `https://manage.axivox.com/
+   <https://manage.axivox.com/>`_. After logging into the portal, go to :menuselection:`Users -->
+   Edit (next to the user) --> SIP Identifiers tab --> SIP username / SIP password`.
+
+   .. image:: axivox_config/manager-sip.png
+      :align: center
+      :alt: SIP credentials in the Axivox manager.
+
+.. important::
+   When entering the :guilabel:`SIP Password` into the user's :guilabel:`Preferences` tab, this
+   value **must** be typed out manually and **not** pasted in. Pasting in causes a `401 server
+   rejection error`.