odoo-forge-bundle 0.1.0

package/payload/skills/odoo18-docs/references/docs/applications/productivity/voip/axivox/vm_audio_messages.md

@@ -0,0 +1,257 @@
+---
+title: "Voicemails and audio messages"
+source_url: "https://docs.odoo.sbggai.top/applications/productivity/voip/axivox/vm_audio_messages.html"
+---
+
+=============================
+# Voicemails and audio messages
+
+.. _axivox_admin: https://manage.axivox.com/
+
+Managing voicemail is an important part of any business. A company needs to access their messages
+with ease, and stay on top of any missed calls. Recording audio messages, like thanking a caller for
+reaching out, or directing them to the right extension, is also a great way to personalize the
+business interaction, and set the tone with the customer.
+
+This document covers the configuration of both voicemail and audio messages in the Axivox
+administrative portal.
+
+.. _voip/axivox/global_language:
+
+# Set global language
+
+To start using voicemails and audio messages with Axivox, the global language should be set in the
+Axivox admin portal settings. To do that, navigate to [manage.axivox.com ](axivox_admin_). After
+logging into the portal, go to :menuselection:`Settings --> Global language (e.g.: voicemail
+messages,...)`.
+
+From here, set the language to either: :guilabel:`Francais`, :guilabel:`English`,
+:guilabel:`Espanol`, or :guilabel:`Deutsch`.
+
+Then, click :guilabel:`Save`, followed by :guilabel:`Apply changes` in the upper-right corner of the
+:guilabel:`General Settings` page to implement the change into production.
+
+.. _voip/axivox/activate_voicemail:
+
+# Activate voicemail
+
+In order for a user to utilize voicemail in Axivox, the voicemail feature **must** be turned on in
+the Axivox administrative portal. To begin using voicemail with a user, navigate to
+[manage.axivox.com ](axivox_admin_). Then, log in with the appropriate administrator credentials.
+
+On the left menu of the Axivox administrative panel, click into :guilabel:`Users`.
+
+Then, click into the specific user the voicemail should be activated for. Under the section marked,
+:guilabel:`Voicemail`, open the drop-down menu, and click on :guilabel:`Yes`.
+
+Lastly, :guilabel:`Save` the change, then click :guilabel:`Apply changes` in the upper-right corner
+of the screen.
+
+# Voicemail
+
+The next step is to set up the individual voicemail boxes on the Axivox administrative portal. To
+access the portal, visit [manage.axivox.com ](axivox_admin_) and log in. Then, navigate to
+:menuselection:`Voicemails`, located in the menu on the left.
+
+If the voicemail option was activated in the user profile, using this process
+:ref:`voip/axivox/activate_voicemail`, then a voicemail is automatically created on the
+:guilabel:`Voicemails` page.
+
+> **tip**:
+>    It should be noted that some of the administrative portal language is in French, as Axivox is a
+   Belgian company. The global language is still set to one of the four options as seen here:
+   :ref:`voip/axivox/global_language`.
+
+## Manually create voicemail
+
+To manually create a new voicemail box, click :guilabel:`Add a voicemail` on the
+:guilabel:`Voicemails` page. Or, edit an existing voicemail box, by clicking :guilabel:`Edit` to the
+far-right of an existing voicemail box on the :guilabel:`Voicemails` page.
+
+.. example::
+   Suppose a sales or support team needs a general voicemail box. The voicemail would need to be
+   created manually, and attached to an incoming number.
+
+The new, manually-created voicemail box should be attached to an incoming number, so it can receive
+messages. To do so, navigate to :menuselection:`Incoming numbers`, located in the menu on the left.
+Then, click :guilabel:`Edit` to the far-right of the specific number the voicemail should be linked
+to.
+
+In the :guilabel:`Destination type for voice call` field, click the drop-down menu, and select
+:guilabel:`Voicemail`. Then, open the drop-down menu on the next line labeled,
+:guilabel:`Voicemail`, and select the manually-created voicemail box.
+
+> **important**:
+>    If an incoming number is capable of receiving SMS/text messages, an additional field,
+   :guilabel:`Destination email address for Incoming SMS`, is present.
+
+   To determine whether an incoming number is capable of receiving SMS/text messages, click
+   :guilabel:`Incoming numbers` from the menu on the left, then check the :guilabel:`SMS compatible`
+   column for the incoming number.
+
+Then, if applicable, in the field labeled, :guilabel:`Destination email address for Incoming SMS`,
+enter an email to which incoming text messages sent to the incoming number can be received. Some
+incoming numbers (US +1) in Axivox are capable of receiving text messages from individuals and
+automated numbers.
+
+Should this field be left empty, the default destination address is used, instead (as previously set
+in the beginning of the process for manually creating a voicemail).
+
+Once all desired configurations are complete, click :guilabel:`Save`, then click :guilabel:`Apply
+changes` in the upper-right corner of the screen to implement the change into production.
+
+## Notifications
+
+Now, whenever a voicemail is received on any of the automatically pre-configured or manually-linked
+voicemail boxes, an email is sent to the user's email address, as listed in the
+:guilabel:`Voicemails` page, or in the user's Axivox profile.
+
+This information can be accessed by navigating to :menuselection:`Users` in the left menu, and
+clicking :guilabel:`Edit` next to the specific user in question.
+
+.. _voip/axivox/vm_forwarding:
+
+# Forwarding to voicemail
+
+In Axivox, there are also numerous forwarding settings for a user. To access these forwarding
+settings, go to [manage.axivox.com ](axivox_admin_) and log in.
+
+Next, navigate to :menuselection:`Users`, located in the menu on the left.
+
+From there, click into the specific user the forwarding should be added to. Then, open the
+:guilabel:`Forwardings` tab.
+
+If the user is busy on another call, or away from the phone, there is an option present in this tab
+to :guilabel:`Send to voicemail as a last resort`, located in the :guilabel:`Forwarding on no
+answer` and :guilabel:`Forwarding on busy` fields.
+
+.. image:: vm_audio_messages/forwardings.png
+   :align: center
+   :alt: Send to voicemail as a last resort options highlighted on the Forwardings tab of the user.
+
+If the :guilabel:`Send to voicemail as a last resort` box is ticked, when the forwarding actions
+stated in each section are not successful, the caller is routed to the voicemail set on the
+particular user.
+
+.. seealso::
+   For more information on forwarding and transfers, visit :ref:`voip/axivox/forwardings_tab`.
+
+When all the desired configurations are complete, click :guilabel:`Save`, then click
+:guilabel:`Apply changes` in the upper-right corner of the screen to implement the change.
+
+.. _voip/axivox/audio_messages:
+
+# Audio messages
+
+It is possible to add audio messages *before* a customer's call is even taken, to inform them about
+the waiting time for deliveries, the availability of a product, or any other important promotional
+messages.
+
+To record an audio message in Axivox, navigate to [manage.axivox.com ](axivox_admin_) and log in.
+
+Next, click on :guilabel:`Audio messages` in the menu on the left. From the :guilabel:`Audio
+messages` page, click :guilabel:`Add a message`.
+
+Type in a :guilabel:`Name`, and click :guilabel:`Save`.
+
+Upon clicking :guilabel:`Save`, the browser redirects back to the main :guilabel:`Audio messages`
+page, where the newly-created message can be found on the list.
+
+There are two different ways to make the audio message. The user could either record the message
+over the phone, or type the message (in text), and select a computer-generated speaker to read the
+message.
+
+## Record audio message
+
+To record an audio message over the phone, click the orange button labeled,
+:guilabel:`Record/Listen`, located to the right of the desired message on the list to record, on the
+:guilabel:`Audio messages` page.
+
+When clicked, a :guilabel:`Record / listen to a message` pop-up window appears. From here, the
+message is then recorded, via one of the extensions that is associated with the user. Under
+:guilabel:`Extension to use for message management` field, click the drop-down menu, and select the
+extension where Axivox should call to record the message.
+
+Then, click :guilabel:`OK` to begin the call.
+
+> **note**:
+>    The user **must** be active in the production database with :abbr:`VoIP (Voice over Internet
+   Protocol)` configured. To configure :abbr:`VoIP (Voice over Internet Protocol)` for a user, see
+   this documentation: :doc:`axivox_config`.
+
+Upon connecting to the Axivox audio recorder management line, a recorded French-speaking operator
+provides the following options:
+
+#. Press `1` to record a message.
+#. Press `2` to listen to the current message.
+
+Press either `1` or `2`, depending on whether or not there is already a message present in the
+system for this particular audio message that requires a review, before recording a new one.
+
+Record the new audio message after pressing `1`, then press `#` to end the recording.
+
+The French-speaking operator returns to the line presenting the first set of questions again:
+
+#. Press `1` to record a message.
+#. Press `2` to listen to the current message.
+
+Press `#` to end the call.
+
+## Write audio message
+
+To type the message, and select a computerized speaker to say the text, navigate to the
+:menuselection:`Audio messages` in the menu on the left.
+
+From the :guilabel:`Audio messages` page, select the blue button labeled, :guilabel:`Text message`,
+next to the corresponding audio message :guilabel:`Name` that the message should be attached to.
+
+Doing so reveals a :guilabel:`Convert text to message` pop-up window.
+
+From the :guilabel:`Convert to text message` pop-up window, click the drop-down menu next to the
+field labeled, :guilabel:`Voice`, and select an option for the :guilabel:`Text` to be read in.
+
+After the :guilabel:`Voice` selection has been made, and the message has been written in the
+:guilabel:`Text` field, click :guilabel:`Generate` to process the audio file.
+
+The text is read in the same language it is written in the :guilabel:`Text` field. Should the
+language differ in the :guilabel:`Voice` field, then an accent is used by the computerized speaker.
+
+Finally, when these steps are complete, click :guilabel:`Save` to save the audio message.
+
+To implement the changes, click :guilabel:`Apply changes` in the upper-right corner of the screen.
+
+.. image:: vm_audio_messages/sample-message.png
+   :align: center
+   :alt:  Convert text to message window with voice, text, generate button and save highlighted.
+
+> **tip**:
+>    To set a greeting or audio message in a dial plan element double-click on the element. This could
+   be a :guilabel:`Play a file` element, or a :guilabel:`Menu` element, in which the caller should
+   encounter an urgent message, or a dial-by-number directory.
+
+   For more information on dial plans see this documentation: :doc:`dial_plan_basics` or
+   :doc:`dial_plan_advanced`.
+
+.. _voip/axivox/music_on_hold:
+
+# Music on-hold
+
+Axivox has the option to add custom hold music to the call whenever a caller is waiting for their
+call to be answered. To add hold music to the Axivox administrative portal, navigate to the
+[manage.axivox.com ](axivox_admin_), and log in.
+
+Then, click on :guilabel:`Music on hold` from the menu on the left, and a :guilabel:`Change the
+music on hold` pop-up window appears.
+
+On the :guilabel:`Change the music on hold` pop-up window, click the :guilabel:`Choose File` button
+to select an MP3 (MPEG Audio Layer 3) or WAV (Waveform Audio File Format ) file to be uploaded.
+
+> **note**:
+>    Only :abbr:`MP3 (MPEG Audio Layer 3)` or :abbr:`WAV (Waveform Audio File Format)` files can be
+   uploaded to the Axivox administrative portal.
+
+Once the file is selected, the :guilabel:`Progression` bar shows an upload status. When this
+activity completes, the window can be closed, by clicking :guilabel:`Close`.
+
+When the desired changes are complete, click :guilabel:`Apply changes` in the upper-right corner of
+the screen.

package/payload/skills/odoo18-docs/references/docs/applications/productivity/voip/axivox.md

@@ -0,0 +1,20 @@
+---
+title: ""
+source_url: "https://docs.odoo.sbggai.top/applications/productivity/voip/axivox.html"
+---
+
+: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

package/payload/skills/odoo18-docs/references/docs/applications/productivity/voip/devices_integrations.md

@@ -0,0 +1,196 @@
+---
+title: "Devices and integrations"
+source_url: "https://docs.odoo.sbggai.top/applications/productivity/voip/devices_integrations.html"
+---
+
+========================
+# Devices and integrations
+
+:abbr:`VoIP (Voice over Internet Protocol)` can be used on many different devices, such as a
+computer, tablet, mobile phone, and many more. This is helpful in that it reduces costs, and
+employees can work from anywhere in the world, so long as they have a broadband internet connection.
+
+Odoo *VoIP* is SIP (Session Initiation Protocol) compatible, which means it can be used with *any*
+:abbr:`SIP (Session Initiation Protocol)` compatible application.
+
+This document covers the process of setting up Odoo *VoIP* across different devices and
+integrations.
+
+Odoo is fully-integrated with all Odoo apps, allowing users to click into any app, and schedule a
+call as an activity in the chatter.
+
+.. example::
+   For example, in the *CRM* app, a user can click into an opportunity, and click on
+   :guilabel:`Activities` in the chatter.
+
+   Next, they can choose :guilabel:`Call`, and under :guilabel:`Due Date`, they can select a date.
+
+   Once they click :guilabel:`Save`, an activity shows up in the chatter.
+
+   Should the :guilabel:`Due Date` be for today's date, the activity shows up in the :abbr:`VoIP
+   (Voice over Internet Protocol)` widget.
+
+   .. image:: devices_integrations/crm-voip-widget.png
+      :align: center
+      :alt: View of CRM leads and the option to schedule an activity for Odoo Discuss.
+
+# Odoo VoIP (laptop/desktop computer)
+
+The Odoo *VoIP* (Voice over Internet Protocol) module and widget can be used from any browser on a
+laptop or desktop device. Simply click on the :guilabel:`☎️ (phone)` icon in the upper-right corner,
+while in the Odoo database, and the widget appears.
+
+.. seealso::
+   To see how to use the :abbr:`VoIP (Voice over Internet Protocol)` widget on a desktop/laptop
+   computer, check out this documentation: :doc:`voip_widget`.
+
+# Odoo VoIP (tablet/mobile device)
+
+The Odoo *VoIP* app can be used on tablets and mobile phones, through the Odoo Android or Apple IOS
+applications. Additionally, a mobile web browser can be used to access the database.
+
+> **warning**:
+>    Odoo Android and Apple IOS applications are no longer being maintained by Odoo on the Android and
+   Apple portals. This means Odoo support only handles limited scopes of Odoo Android or Apple IOS
+   support tickets.
+
+> **important**:
+>    While outgoing calls can be placed using Odoo on a mobile device, be aware that Odoo is **not** a
+   full :abbr:`VoIP (Voice over Internet Protocol)` application, and does **not** ring on incoming
+   calls. If the user needs to be reachable on a mobile device at all times, an app, like Zoiper,
+   should be used. Apps like that stay connected in the background at all times.
+
+   For more information, see this documentation: :ref:`voip/zoiper`.
+
+While in the mobile application on a mobile device/tablet, access the Odoo *VoIP* widget, by tapping
+on the :guilabel:`☎️ (phone)` icon in the upper-right corner. The widget appears in the lower-left
+corner.
+
+When first making a call from the tablet using the mobile application, the user is prompted to
+:guilabel:`Allow` the database to use the microphone. Click :guilabel:`Allow` when prompted to
+continue with the call using the microphone.
+
+This step is **necessary**, whether using the mobile Odoo application or web browser.
+
+.. image:: devices_integrations/allow-mic.png
+   :align: center
+   :alt: Allow the database to access the microphone.
+
+Odoo then asks how to make the call. The two options are : :guilabel:`VOIP` or :guilabel:`Phone`
+(should the tablet be enabled for calling). Click the box next to :guilabel:`Remember ?` should this
+decision be the default moving forward.
+
+.. image:: devices_integrations/voip-phone.png
+   :align: center
+   :alt: Window prompt to choose whether to use VOIP or the devices phone to make the call.
+
+Here is the layout of what the Odoo *VoIP* app looks like on a mobile device:
+
+.. image:: devices_integrations/voip-odoo-dashboard.png
+   :align: center
+   :alt: Layout of what the VoIP app looks like on the a mobile device.
+
+.. _voip/zoiper:
+
+# Zoiper Lite
+
+*Zoiper Lite* is a free :abbr:`VoIP (Voice over Internet Protocol)` :abbr:`SIP (Session Initiation
+Protocol)` dialer with voice and video.
+
+To start using the *Zoiper* app, download it to the device, via the [Zoiper download page
+](https://www.zoiper.com/en/voip-softphone/download/current).
+
+A mobile device is the most common installation, and this document covers how to set up on the
+*Zoiper* IOS application. Screenshots and steps may differ depending on the set up conditions.
+
+After installing the *Zoiper* application on the mobile phone, open the application, and tap on
+:guilabel:`Settings`. Navigate to :menuselection:`Accounts`, and tap on the :guilabel:`+ (plus)`
+icon to add an account.
+
+If the :abbr:`VoIP (Voice over Internet Protocol)` account is already set up, then click
+:guilabel:`Yes`. This means an account username and password has already been produced.
+
+.. image:: devices_integrations/account-settings-zoiper-group.png
+   :align: center
+   :alt: Zoiper account setup, shown in the view from a mobile device.
+
+Next, tap on :guilabel:`Select a provider`. On the screen that populates, tap :guilabel:`Country`,
+in the upper-right corner, to narrow the providers down to a specific country. Choose the country
+for the provider that is being configured, then find the :guilabel:`Provider`, and select it.
+
+.. example::
+   If the provider being configured is *Axivox*, then select :guilabel:`Belgium`. Then, choose
+   :guilabel:`Axivox` as the provider.
+
+.. image:: devices_integrations/provider-zoiper-odoo.png
+   :align: center
+   :alt: Zoiper account setup, choosing the provider.
+
+Under :abbr:`SIP (Session Initiation Protocol)` options, enter the :guilabel:`Account name`,
+:guilabel:`Domain`, :guilabel:`Username`, and :guilabel:`Password`. All this information varies,
+based on the account.
+
+> **tip**:
+>    To access this information, via the *Axivox* portal, navigate to :menuselection:`Users --> Choose
+   user --> Edit --> SIP Identifiers tab`. The :guilabel:`SIP username`, :guilabel:`Domain`,
+   :guilabel:`SIP password`, and :guilabel:`Address of the proxy server` are all present in this
+   tab.
+
+.. list-table::
+   :header-rows: 1
+
+   * - Zoiper Field
+     - Axivox Field
+   * - Account name
+     - *Can be anything*
+   * - Domain
+     - Domain
+   * - Username
+     - SIP username
+   * - Password
+     - SIP password
+
+Once this account information is entered, click the green :guilabel:`Register` button at the top of
+the screen. Once the registration information is checked, *Zoiper* populates a message, stating
+:guilabel:`Registration Status: OK`.
+
+At this point, *Zoiper* is now set up to make phone calls using the :abbr:`VoIP (Voice over Internet
+Protocol)` service.
+
+.. image:: devices_integrations/sip-options-zoiper.png
+   :align: center
+   :alt: Zoiper account setup, registration successful.
+
+# Linphone
+
+*Linphone* is an open-source :abbr:`VoIP (Voice over Internet Protocol)` :abbr:`SIP (Session
+Initiation Protocol)` softphone, used for voice, video, messaging (group and individual), as well as
+conference calls.
+
+To start using the *Linphone* app, download it to the device, via the [Linphone download page
+](https://new.linphone.org/technical-corner/linphone?qt-technical_corner=2#qt-technical_corner).
+
+A mobile device is the most common installation, and this document covers how to set up the
+*Linphone* IOS application. Screenshots and steps may differ depending on the circumstances.
+
+To begin configuring *Linphone* for use with a :abbr:`SIP (Session Initiation Protocol)` provider,
+first open *Linphone*, and an assistant screen appears.
+
+From this screen, select :guilabel:`Use SIP Account`. Then, on the following screen, enter the
+:guilabel:`Username`, :guilabel:`Password`, :guilabel:`Domain`, and :guilabel:`Display Name`. Once
+complete, press :guilabel:`Login`.
+
+At this point, *Linphone* is ready to start making calls, once there is a green button at the top of
+the application screen that reads, :guilabel:`Connected`.
+
+.. image:: devices_integrations/linphone-odoo-setup.png
+   :align: center
+   :alt: Linphone account setup, registration successful.
+
+> **tip**:
+>    *Linphone* makes a variety of applications for mobile and desktop devices in operating systems,
+   such as Windows, Linux, Apple, and Android. Because *Linphone* is an open-source project, many
+   new updates are released on a regular basis.
+
+   See [Linphone's wiki-documentation page
+   ](https://wiki.linphone.org/xwiki/wiki/public/view/Linphone/).

package/payload/skills/odoo18-docs/references/docs/applications/productivity/voip/onsip.md

@@ -0,0 +1,162 @@
+---
+title: "Use VoIP services in Odoo with OnSIP"
+source_url: "https://docs.odoo.sbggai.top/applications/productivity/voip/onsip.html"
+---
+
+====================================
+# Use VoIP services in Odoo with OnSIP
+
+> **important**:
+>    OnSIP :abbr:`VoIP (voice over internet protocol)` services are only available in the **United
+   States** (US). OnSIP :abbr:`VoIP (voice over internet protocol)` services are widely available in
+   the lower-48, contiguous United States. In Alaska or Hawaii, charges for service can be higher.
+
+   Additionally, a :abbr:`US (United States)` billing address, and :abbr:`US (United States)` credit
+   card are required to use the service.
+
+   Before setting up an account with OnSIP, the business will need to make sure the business
+   telephone numbers are portable to OnSIP.
+
+   OnSIP makes every attempt to work with all telephone service providers. However, certain local or
+   regional guidelines may preclude the company's current provider from releasing the number.
+
+# Introduction
+
+Odoo *VoIP* can be set up to work together with [OnSIP (Odoo Landing Page)
+](https://info.onsip.com/odoo/). OnSIP is a VoIP provider. An account is needed with OnSIP in order
+to use this service.
+
+Before setting up an account with OnSIP, make sure the company's home area, and the areas that will
+be called, are covered by OnSIP services.
+
+After opening an OnSIP account, follow the configuration procedure below to configure it on an Odoo
+database.
+
+# Configuration
+
+To configure the Odoo database to connect to OnSIP services, first navigate to the
+:menuselection:`Apps application` from the main Odoo dashboard. Then, remove the default `Apps`
+filter from the :guilabel:`Search...` bar, and search for `OnSIP`.
+
+Next, activate the :guilabel:`VOIP OnSIP` module.
+
+.. image:: onsip/install-onsip.png
+   :align: center
+   :alt: View of OnSIP app in the app search results.
+
+## Odoo VoIP setting
+
+After installing the *VOIP OnSIP* module, go to the :menuselection:`Settings app`, scroll down to
+the :guilabel:`Integrations` section, and locate the :guilabel:`VoIP` fields. Then, proceed to fill
+in those three fields with the following information:
+
+- :guilabel:`OnSIP Domain`: the domain that was assigned when creating an account on [OnSIP
+  ](https://www.onsip.com/).
+- :guilabel:`WebSocket`: `wss://edge.sip.onsip.com`
+- :guilabel:`VoIP Environment`: :guilabel:`Production`
+
+.. image:: onsip/voip-setting.png
+   :align: center
+   :alt: VoIP configuration settings in Odoo Settings app.
+
+> **tip**:
+>    To access the OnSIP domain, navigate to [OnSIP ](https://www.onsip.com/) and log in. Then, click
+   the :guilabel:`Administrators` link in the top-right of the page.
+
+   Next, in the left menu, click :guilabel:`Users`, and then select any user. By default, the
+   selected user opens on the :guilabel:`User Info` tab.
+
+   Click on the :guilabel:`Phone Settings` tab to reveal OnSIP configuration credentials (first
+   column).
+
+   .. image:: onsip/domain-setting.png
+      :align: center
+      :alt: Domain setting revealed (highlighted) on administrative panel of OnSIP management
+            console.
+
+## Odoo user setting
+
+Next, the user needs to be set up in Odoo. Every user associated with an OnSIP user **must** also be
+configured in the Odoo user's settings/preferences.
+
+To do that, navigate to :menuselection:`Settings app --> Manage Users --> Select the User`.
+
+On the user form, click :guilabel:`Edit` to configure the user's OnSIP account. Then, click the
+:guilabel:`Preferences` tab, and scroll to the :guilabel:`VoIP Configuration` section.
+
+In this section, fill in the fields with OnSIP credentials.
+
+Fill in the following fields with the associated credentials listed below:
+
+- :guilabel:`Voip Username` = OnSIP :guilabel:`Username`
+- :guilabel:`OnSIP Auth Username` = OnSIP :guilabel:`Auth Username`
+- :guilabel:`VoIP Secret` = OnSIP :guilabel:`SIP Password`
+
+> **tip**:
+>    The OnSIP extension can be found in the *User* banner line above the tabs.
+
+When these steps are complete, navigate away from the user form in Odoo to save the configurations.
+
+Once saved, Odoo users can make phone calls by clicking the :guilabel:`☎️ (phone)` icon in the
+top-right corner of Odoo.
+
+.. seealso::
+   Additional setup and troubleshooting steps can be found on [OnSIP's knowledge base
+   ](https://support.onsip.com/hc/en-us).
+
+## Incoming calls
+
+The Odoo database also receives incoming calls that produce pop-up windows in Odoo. When those call
+pop-up windows appear, click the green :guilabel:`📞 (phone)` icon to answer the call.
+
+To ignore the call, click the red :guilabel:`📞 (phone)` icon.
+
+
+.. image:: onsip/incoming-call.png
+   :align: center
+   :alt: Incoming call shown in the Odoo VoIP widget.
+
+.. seealso::
+   :doc:`voip_widget`
+
+## Troubleshooting
+
+### Missing parameters
+
+If a *Missing Parameters* message appears in the Odoo widget, make sure to refresh the Odoo browser
+window (or tab), and try again.
+
+.. image:: onsip/onsip04.png
+   :align: center
+   :alt: Missing parameter message in the Odoo VoIP widget.
+
+### Incorrect number
+
+If an *Incorrect Number* message appears in the Odoo widget, make sure to use the international
+format for the number. This means leading with the international country code.
+
+A country code is a locator code that allows access to the desired country's phone system. The
+country code is dialed first, prior to the target number. Each country in the world has its own
+specific country code.
+
+For example, `16505555555` (where `1` is the international prefix for the United States).
+
+.. image:: onsip/onsip05.png
+   :align: center
+   :alt: Incorrect number message populated in the Odoo VoIP widget.
+
+.. seealso::
+   For a list of comprehensive country codes, visit: [https://countrycode.org
+   ](https://countrycode.org).
+
+# OnSIP on mobile phone
+
+In order to make and receive phone calls when the user is not in front of Odoo on their computer, a
+softphone app on a mobile phone can be used in parallel with Odoo *VoIP*.
+
+This is useful for convenient, on-the-go calls, and to make sure incoming calls are heard. Any SIP
+softphone will work.
+
+.. seealso::
+   - :doc:`devices_integrations`
+   - [OnSIP App Download ](https://www.onsip.com/app/download)