mirror of
https://github.com/odoo/documentation.git
synced 2026-03-27 14:10:23 +07:00
[IMP] voip: update (remaining) articles for odoo phone rebrand
closes odoo/documentation#16314 Signed-off-by: Rex Hu (rexhu) <rexhu@odoo.com> Co-authored-by: Jess Rogers <104637850+jero-odoo@users.noreply.github.com> Co-authored-by: Felicia Kuan <feku@odoo.com>
This commit is contained in:
@@ -2,67 +2,67 @@
|
||||
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.
|
||||
The **Phone** app 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*
|
||||
Odoo **Phone** 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
|
||||
This document covers the process of setting up *Odoo Phone* 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.
|
||||
The **Phone** app 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
|
||||
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.
|
||||
Should the :guilabel:`Due Date` be for today's date, the activity shows up in the **Phone** 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.
|
||||
:alt: View of CRM leads and the option to schedule an activity for *Odoo Discuss*.
|
||||
|
||||
Odoo VoIP (laptop/desktop computer)
|
||||
===================================
|
||||
Use Odoo Phone on a 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.
|
||||
The Odoo **Phone** app and widget can be used from any browser on a laptop or desktop device. Simply
|
||||
click on the :icon:`oi-voip` :guilabel:`(Phone)` icon 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`.
|
||||
To see how to use the *Phone* widget on a desktop/laptop computer, check out this documentation:
|
||||
:doc:`voip_widget`.
|
||||
|
||||
Odoo VoIP (tablet/mobile device)
|
||||
================================
|
||||
Use Odoo Phone on a mobile device
|
||||
=================================
|
||||
|
||||
The Odoo *VoIP* app can be used on tablets and mobile phones, through the Odoo Android or Apple IOS
|
||||
.. important::
|
||||
While outgoing calls can be placed using Odoo on a mobile device, the Odoo **Phone** app 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. 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 :ref:`the Zoiper Lite section <voip/zoiper>`.
|
||||
|
||||
The Odoo **Phone** 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
|
||||
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.
|
||||
While in the mobile application on a mobile device/tablet, access the Odoo **Phone** widget, by
|
||||
tapping on the :icon:`oi-voip` :guilabel:`(Phone)` icon in the top-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
|
||||
@@ -74,7 +74,7 @@ This step is **necessary**, whether using the mobile Odoo application or web bro
|
||||
: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`
|
||||
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.
|
||||
|
||||
@@ -82,7 +82,7 @@ decision be the default moving forward.
|
||||
: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:
|
||||
Here is the layout of what the **Phone** app looks like on a mobile device:
|
||||
|
||||
.. image:: devices_integrations/voip-odoo-dashboard.png
|
||||
:align: center
|
||||
@@ -93,16 +93,16 @@ Here is the layout of what the Odoo *VoIP* app looks like on a mobile device:
|
||||
Zoiper Lite
|
||||
===========
|
||||
|
||||
*Zoiper Lite* is a free :abbr:`VoIP (Voice over Internet Protocol)` :abbr:`SIP (Session Initiation
|
||||
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
|
||||
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.
|
||||
Zoiper iOS application. Screenshots and steps may differ depending on the setup conditions.
|
||||
|
||||
After installing the *Zoiper* application on the mobile phone, open the application, and tap on
|
||||
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.
|
||||
|
||||
@@ -118,7 +118,7 @@ in the upper-right corner, to narrow the providers down to a specific country. C
|
||||
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
|
||||
If the provider being configured is Axivox, select :guilabel:`Belgium`. Then, choose
|
||||
:guilabel:`Axivox` as the provider.
|
||||
|
||||
.. image:: devices_integrations/provider-zoiper-odoo.png
|
||||
@@ -130,7 +130,7 @@ Under :abbr:`SIP (Session Initiation Protocol)` options, enter the :guilabel:`Ac
|
||||
based on the account.
|
||||
|
||||
.. tip::
|
||||
To access this information, via the *Axivox* portal, navigate to :menuselection:`Users --> Choose
|
||||
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.
|
||||
@@ -153,7 +153,7 @@ Once this account information is entered, click the green :guilabel:`Register` b
|
||||
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
|
||||
At this point, Zoiper can now make phone calls using the :abbr:`VoIP (Voice over Internet
|
||||
Protocol)` service.
|
||||
|
||||
.. image:: devices_integrations/sip-options-zoiper.png
|
||||
@@ -163,24 +163,24 @@ Protocol)` service.
|
||||
Linphone
|
||||
========
|
||||
|
||||
*Linphone* is an open-source :abbr:`VoIP (Voice over Internet Protocol)` :abbr:`SIP (Session
|
||||
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
|
||||
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.
|
||||
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.
|
||||
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
|
||||
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
|
||||
@@ -188,9 +188,9 @@ the application screen that reads, :guilabel:`Connected`.
|
||||
: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.
|
||||
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/>`_.
|
||||
|
||||
@@ -1,19 +1,24 @@
|
||||
================================
|
||||
VoIP services in Odoo with DIDWW
|
||||
================================
|
||||
.. |VOIP| replace:: :abbr:`VoIP (Voice over Internet Protocol)`
|
||||
.. |SIP| replace:: :abbr:`SIP (Session Initiation Protocol)`
|
||||
|
||||
*DIDWW* is a global *VoIP* and SIP trunking provider. An active account with DIDWW is required to
|
||||
use this service.
|
||||
=====================
|
||||
Odoo Phone with DIDWW
|
||||
=====================
|
||||
|
||||
Before creating an account with DIDWW, make sure that the company's location and the applicable
|
||||
regions are supported by DIDWW's services.
|
||||
`DIDWW <https://www.didww.com/>`_ is a global |VoIP| and |SIP| trunking provider that can be set up
|
||||
to work with Odoo **Phone**. A DIDWW account is required to use this service.
|
||||
|
||||
DIDWW setup
|
||||
===========
|
||||
.. important::
|
||||
Before setting up an account with DIDWW, verify the following requirements:
|
||||
|
||||
After verifying country coverage and availability, create an account with `DIDWW
|
||||
<https://www.didww.com/>`_. Then navigate to the `DIDWW Dashboard
|
||||
<https://my.didww.com/#/dashboard>`_.
|
||||
- The business phone numbers are portable to DIDWW. Some providers may be unable to release the
|
||||
phone number due to local or regional guidelines.
|
||||
- The locations of the company and its call recipients are covered by DIDWW services.
|
||||
|
||||
Configure credentials in DIDWW
|
||||
==============================
|
||||
|
||||
Navigate to the `DIDWW Dashboard <https://my.didww.com/#/dashboard>`_.
|
||||
|
||||
To transfer existing numbers from an existing telephone network service provider, follow the steps
|
||||
outlined on the `DIDWW website <https://doc.didww.com/phone-numbers/number-porting/index.html>`_.
|
||||
@@ -55,7 +60,7 @@ Configure or add the following parameters:
|
||||
- :guilabel:`Transport protocol`: `UDP`, `TCP`, `WSS`, `TLS`
|
||||
|
||||
.. important::
|
||||
The SRTP media encryption and TLS SIP transport are disabled by default in DIDWW. Contact the
|
||||
The SRTP media encryption and TLS |SIP| transport are disabled by default in DIDWW. Contact the
|
||||
DIDWW sales team sales@didww.com to allow traffic encryption for your account.
|
||||
|
||||
.. image:: didww/sip-device-route.png
|
||||
@@ -67,28 +72,42 @@ Configure or add the following parameters:
|
||||
then click :guilabel:`My Numbers`. Scroll to :guilabel:`Configuration`. In the :guilabel:`Inbound
|
||||
voice trunk` field, select :guilabel:`phone.systems`.
|
||||
|
||||
Lastly, verify that the DID number is selected in the *Inbound Calls* section of the SIP Device
|
||||
Lastly, verify that the DID number is selected in the *Inbound Calls* section of the |SIP| Device
|
||||
Route settings.
|
||||
|
||||
.. image:: didww/did-number.png
|
||||
:alt: The DID numbers field in DIDWW.
|
||||
|
||||
Odoo setup
|
||||
==========
|
||||
Configure DIDWW in Odoo
|
||||
=======================
|
||||
|
||||
In *Odoo*, navigate to :menuselection:`Settings app --> Integrations --> VoIP --> Manage Providers`.
|
||||
Click :guilabel:`New`.
|
||||
Add DIDWW credentials
|
||||
---------------------
|
||||
|
||||
Enter the name, `DIDWW`, then update the :guilabel:`WebSocket` field with `wss://sip.phone.systems`.
|
||||
Under :guilabel:`PBX Server IP`, enter `sip.phone.systems`.
|
||||
To set up DIDWW as a |VOIP| provider in Odoo, navigate to :menuselection:`Phone app -->
|
||||
Configuration --> Providers`. Locate the *DIDWW* provider entry, and verify the following settings:
|
||||
|
||||
.. image:: didww/new-provider.png
|
||||
:alt: The VoIP providers page in Odoo.
|
||||
- :guilabel:`OnSIP Domain`: should already be set to `sip.phone.systems`.
|
||||
- :guilabel:`WebSocket`: should already be set to `wss://sip.phone.systems`.
|
||||
- :guilabel:`VoIP Environment`: select :guilabel:`Production`.
|
||||
|
||||
To configure a user's VoIP provider, click the user avatar icon in the top-right corner of the
|
||||
database, and then choose :guilabel:`My Preferences` from the sub-menu. Then click into the
|
||||
:guilabel:`VoIP` tab, and under the :guilabel:`Voip Provider` field, select :guilabel:`DIDWW`.
|
||||
Finally, enter the :guilabel:`Voip Username` and :guilabel:`Voip Secret`, then save.
|
||||
.. image:: didww/didww-provider-config.png
|
||||
:alt: DIDWW configuration settings in the *Odoo Phone* app.
|
||||
|
||||
.. image:: didww/odoo-credentials.png
|
||||
:alt: DIDWW provider, username, and secret credentials entered.
|
||||
Configure user settings
|
||||
-----------------------
|
||||
|
||||
Next, each user's OnSIP credentials must be configured in Odoo. Navigate to :menuselection:`Settings
|
||||
app --> Users & Companies --> Users` select the user, and click the **VoIP** tab.
|
||||
|
||||
Add the following credentials for the user:
|
||||
|
||||
- :guilabel:`Username`: the user's DIDWW username.
|
||||
- :guilabel:`Secret`: the user's password.
|
||||
|
||||
Once the DIDWW credentials have been saved, the user can make calls with Odoo **Phone** by clicking
|
||||
the :icon:`oi-voip` :guilabel:`(Show Softphone)` icon in the top-right corner of Odoo.
|
||||
|
||||
.. seealso::
|
||||
For additional setup and troubleshooting steps, see `DIDWW's documentation
|
||||
<https://doc.didww.com/>`_.
|
||||
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 30 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 12 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 7.5 KiB |
@@ -1,15 +1,15 @@
|
||||
======================
|
||||
Sales calls with VoIP
|
||||
======================
|
||||
|
||||
.. |VOIP| replace:: :abbr:`VoIP (Voice over Internet Protocol)`
|
||||
|
||||
Using |VOIP| increases call efficiency, reduces costs, and allows a salesperson to access the Odoo
|
||||
database while on a call. Instead of relying on a separate phone for sales calls, a salesperson can
|
||||
make calls directly from the Odoo database.
|
||||
============================
|
||||
Sales calls with Odoo Phone
|
||||
============================
|
||||
|
||||
This article goes over setting up Odoo |VOIP| for a sales team that already has |VOIP| configured.
|
||||
If |VOIP| is **not** configured, refer to the :doc:`configure VoIP <../voip>` documentation
|
||||
Using Odoo **Phone** increases call efficiency, reduces costs, and allows a salesperson to access the
|
||||
Odoo database while on a call. Instead of relying on a separate phone for sales calls, a salesperson
|
||||
can make calls directly from the Odoo database.
|
||||
|
||||
This article goes over setting up Odoo **Phone** for a sales team that already has the **Phone** app
|
||||
configured. If it is **not** configured, refer to the :doc:`Phone <../voip>` documentation
|
||||
to get started.
|
||||
|
||||
.. seealso::
|
||||
@@ -34,10 +34,10 @@ From here, there are three ways to begin a phone call with the customer:
|
||||
:icon:`fa-phone` :guilabel:`(phone)` icon near the bottom of the widget.
|
||||
|
||||
Work during a call
|
||||
------------------
|
||||
==================
|
||||
|
||||
Once the call with the customer begins, the salesperson can still move about the Odoo database.
|
||||
Also, there are shortcut icons in the |VOIP| widget that the salesperson can use to access common
|
||||
Also, there are shortcut icons in the *Phone* widget that the salesperson can use to access common
|
||||
actions, like sending an email to the customer, or pulling up their profile. Learn more about
|
||||
:doc:`the documents a salesperson can access <voip_widget>` during a call.
|
||||
|
||||
@@ -48,15 +48,16 @@ The salesperson can also take some actions during the call:
|
||||
- :icon:`fa-pause` :guilabel:`(pause)`: Place the caller on hold.
|
||||
|
||||
.. image:: sales_calls/voip-widget-call.png
|
||||
:alt: The VoIP widget opened to a call, showing the shortcut icons a salesperson has access to.
|
||||
:alt: The *Phone* widget opened to a call, showing the shortcut icons a salesperson has access
|
||||
to.
|
||||
|
||||
Handle call follow-ups
|
||||
----------------------
|
||||
======================
|
||||
|
||||
The |VOIP| widget can handle some common follow-up tasks, but salespeople can still navigate Odoo
|
||||
The *Phone* widget can handle some common follow-up tasks, but salespeople can still navigate Odoo
|
||||
for tasks not available in the widget.
|
||||
|
||||
Here are some of the common follow-up tasks that can be managed from the |VOIP| widget:
|
||||
Here are some of the common follow-up tasks that can be managed from the *Phone* widget:
|
||||
|
||||
- Send a follow-up email sharing new product offerings to the customer using the :icon:`fa-envelope`
|
||||
:guilabel:`(envelope)` icon.
|
||||
@@ -67,7 +68,7 @@ Here are some of the common follow-up tasks that can be managed from the |VOIP|
|
||||
rest of the form.
|
||||
|
||||
Send a quotation while on a call
|
||||
--------------------------------
|
||||
================================
|
||||
|
||||
If the customer is ready to see a sales quotation while on the call, the salesperson can send that
|
||||
quotation without leaving the call.
|
||||
@@ -80,13 +81,13 @@ An added benefit of being on the call with the customer while the salesperson is
|
||||
quotation is that any specific questions are answered in real-time.
|
||||
|
||||
End the sales call
|
||||
------------------
|
||||
==================
|
||||
|
||||
When it is time to end the call, the salesperson clicks the red :icon:`fa-phone` :guilabel:`(phone)`
|
||||
icon in the lower-right corner of the |VOIP| widget. When they do, the call is logged in the
|
||||
icon in the lower-right corner of the *Phone* widget. When they do, the call is logged in the
|
||||
opportunity's chatter.
|
||||
|
||||
If they have not done so already, the salesperson then marks the phone call activity as done. To do
|
||||
so, navigate to the opportunity's chatter and find the :guilabel:`Planned Activities` section, then
|
||||
click :icon:`fa-check` :guilabel:`Mark Done` on the planned call to remove it from the
|
||||
:guilabel:`Next Activities` tab in the |VOIP| widget.
|
||||
:guilabel:`Next Activities` tab in the *Phone* widget.
|
||||
|
||||
@@ -1,15 +1,15 @@
|
||||
=======================
|
||||
Support calls with VoIP
|
||||
=======================
|
||||
|
||||
.. |VOIP| replace:: :abbr:`VoIP (Voice over Internet Protocol)`
|
||||
|
||||
A useful tool for support teams, Odoo |VOIP| is used as a way to get in contact with customers that
|
||||
need some help. Using |VOIP| can help improve customer satisfaction, reduce support costs, and
|
||||
allows support agents to navigate an Odoo database while on a call.
|
||||
=============================
|
||||
Support calls with Odoo Phone
|
||||
=============================
|
||||
|
||||
A useful tool for support teams, Odoo **Phone** is used as a way to get in contact with customers who
|
||||
need some help. Using the **Phone** app can help improve customer satisfaction, reduce support costs,
|
||||
and allows support agents to navigate an Odoo database while on a call.
|
||||
|
||||
Instead of being tied to their desks, support agents can take calls from anywhere they have access
|
||||
to Odoo :doc:`VoIP <../voip>`.
|
||||
to the Odoo :doc:`Phone <../voip>` app.
|
||||
|
||||
.. important::
|
||||
This feature requires at least one :doc:`call queue <axivox/call_queues>` to be configured.
|
||||
@@ -24,15 +24,15 @@ Log into a support queue
|
||||
If :doc:`call queues <axivox/call_queues>` are set up, begin a support shift by logging into a call
|
||||
queue.
|
||||
|
||||
Begin by clicking :icon:`oi-voip` :guilabel:`(VoIP)` in the top-right corner of the Odoo database.
|
||||
From there, click :icon:`fa-keyboard-o` :guilabel:`(keyboard)`, then dial the *agent connection*
|
||||
number and click :icon:`fa-phone` :guilabel:`(phone)`.
|
||||
Begin by clicking :icon:`oi-voip` :guilabel:`(Show Softphone)` in the top-right corner of the Odoo
|
||||
database. From there, click :icon:`fa-keyboard-o` :guilabel:`(keyboard)`, then dial the *agent
|
||||
connection* number and click :icon:`fa-phone` :guilabel:`(phone)`.
|
||||
|
||||
Once the support agent calls their *agent connection code*, they'll hear a short message letting
|
||||
them know they are logged into the queue. From here, the agent receives support calls according to
|
||||
the administrator's :doc:`call queue strategy <axivox/call_queues>`. When a support agent receives a
|
||||
call, the Odoo |VOIP| widget appears in the bottom-right corner of their screen with the caller's
|
||||
phone number, as well as their name if the number is tied to a customer profile.
|
||||
call, the *Phone* widget appears in the bottom-right corner of their screen with the caller's phone
|
||||
number, as well as their name if the number is tied to a customer profile.
|
||||
|
||||
.. note::
|
||||
When support staff are added as :doc:`static agents <axivox/call_queues>` to a call queue, they
|
||||
@@ -42,7 +42,7 @@ Call a customer from a support ticket
|
||||
=====================================
|
||||
|
||||
As part of a support agent's daily tasks, they might be asked to call customers with open support
|
||||
tickets. With Odoo |VOIP|, the support agent can stay in the Odoo database throughout the entire
|
||||
tickets. With Odoo **Phone**, the support agent can stay in the Odoo database throughout the entire
|
||||
workflow.
|
||||
|
||||
From the database's home page, click the **Helpdesk** app, click into a helpdesk, and then open a
|
||||
@@ -58,15 +58,15 @@ From here, the agent has three ways to make a call:
|
||||
- Hover over the :guilabel:`Phone` field in the ticket, then click :icon:`fa-phone`
|
||||
:guilabel:`Call`.
|
||||
- In the ticket's chatter, click the customer's phone number.
|
||||
- In the upper-right corner, click the :icon:`oi-voip` :guilabel:`(VoIP)` icon to open the |VOIP|
|
||||
widget. From the :guilabel:`Next Activities` tab, select the call, and finally click the
|
||||
- In the upper-right corner, click the :icon:`oi-voip` :guilabel:`(Show Softphone)` icon to open the
|
||||
*Phone* widget. From the :guilabel:`Activities` tab, select the call, and finally click the
|
||||
:icon:`fa-phone` :guilabel:`(phone)` icon near the bottom of the widget.
|
||||
|
||||
Work during a call
|
||||
------------------
|
||||
==================
|
||||
|
||||
Once the call with the customer begins, the support agent can still move about the Odoo database.
|
||||
Also, there are shortcut icons in the |VOIP| widget that the support agent can use to access common
|
||||
Also, there are shortcut icons in the *Phone* widget that the support agent can use to access common
|
||||
actions, like sending an email to the customer, or pulling up their profile. Learn more about
|
||||
:doc:`the documents a support agent can access <voip_widget>` during a call.
|
||||
|
||||
@@ -78,12 +78,12 @@ The support agent can also take some actions during the call:
|
||||
- :icon:`fa-pause` :guilabel:`(pause)`: Place the caller on hold.
|
||||
|
||||
Handle call follow-ups
|
||||
----------------------
|
||||
======================
|
||||
|
||||
The |VOIP| widget can handle some common follow-up tasks, but support agents can still navigate Odoo
|
||||
for tasks not available in the widget.
|
||||
The *Phone* widget can handle some common follow-up tasks, but support agents can still navigate
|
||||
Odoo for tasks not available in the widget.
|
||||
|
||||
Here are some of the common follow-up tasks that can be managed from the |VOIP| widget:
|
||||
Here are some of the common follow-up tasks that can be managed from the *Phone* widget:
|
||||
|
||||
- Send a follow-up email sharing troubleshooting steps with the customer using the
|
||||
:icon:`fa-envelope` :guilabel:`(envelope)` icon.
|
||||
@@ -94,16 +94,16 @@ Here are some of the common follow-up tasks that can be managed from the |VOIP|
|
||||
rest of the form.
|
||||
|
||||
End the support call
|
||||
--------------------
|
||||
====================
|
||||
|
||||
When it is time to end the call, the support agent clicks the red :icon:`fa-phone`
|
||||
:guilabel:`(phone)` icon in the lower-right corner of the |VOIP| widget. When they do, the call is
|
||||
:guilabel:`(phone)` icon in the lower-right corner of the *Phone* widget. When they do, the call is
|
||||
logged in the ticket's chatter.
|
||||
|
||||
If they have not done so already, the support agent then marks the phone call activity as done. To
|
||||
do so, navigate to the ticket's chatter and find the :guilabel:`Planned Activities` section, then
|
||||
click :icon:`fa-check` :guilabel:`Mark Done` on the planned call to remove it from the
|
||||
:guilabel:`Next Activities` tab in the |VOIP| widget.
|
||||
:guilabel:`Next Activities` tab in the *Phone* widget.
|
||||
|
||||
Log out of a support queue
|
||||
==========================
|
||||
@@ -111,9 +111,9 @@ Log out of a support queue
|
||||
Once the agent's shift ends, or if they are taking a break, they can log out of the support call
|
||||
queue.
|
||||
|
||||
Begin by clicking :icon:`oi-voip` :guilabel:`(VoIP)` in the top-right corner of the Odoo database.
|
||||
From there, click :icon:`fa-keyboard-o` :guilabel:`(keyboard)`, then dial the *agent disconnection*
|
||||
number and click :icon:`fa-phone` :guilabel:`phone`.
|
||||
Begin by clicking :icon:`oi-voip` :guilabel:`(Show Softphone)` in the top-right corner of the Odoo
|
||||
database. From there, click :icon:`fa-keyboard-o` :guilabel:`(keyboard)`, then dial the *agent
|
||||
disconnection* number and click :icon:`fa-phone` :guilabel:`phone`.
|
||||
|
||||
Once the support agent calls their *agent disconnection code*, they'll hear a short message letting
|
||||
them know they are logged out of the queue. From here, the agent will no longer receive support
|
||||
|
||||
@@ -1,93 +1,98 @@
|
||||
============
|
||||
VoIP actions
|
||||
============
|
||||
|
||||
.. |VOIP| replace:: :abbr:`VoIP (Voice over Internet Protocol)`
|
||||
|
||||
The |VOIP| widget is an add-on made available to Odoo users by installing the |VOIP| module. Instead
|
||||
of managing mobile devices for every salesperson, fumbling through call transfers for upset
|
||||
customers, or needing a meeting room to handle a conference call, utilize the |VOIP| widget to
|
||||
============
|
||||
Phone widget
|
||||
============
|
||||
|
||||
The **Phone** widget is an add-on made available to Odoo users by installing the **Phone** app.
|
||||
Instead of managing mobile devices for every salesperson, fumbling through call transfers for upset
|
||||
customers, or needing a meeting room to handle a conference call, utilize the **Phone** widget to
|
||||
tackle any of these business needs.
|
||||
|
||||
Navigate the VoIP widget
|
||||
========================
|
||||
Navigate the Phone widget
|
||||
=========================
|
||||
|
||||
The |VOIP| widget contains three tabs: :guilabel:`Recent`, :guilabel:`Next Activities`, and
|
||||
:guilabel:`Contacts`, which are used for managing calls and day-to-day activities in Odoo. Use the
|
||||
search bar to find contacts faster.
|
||||
The **Phone** widget contains four tabs: :guilabel:`Keypad`, :guilabel:`Recent`,
|
||||
:guilabel:`Contacts`, and :guilabel:`Activities`, which are used for managing calls and day-to-day
|
||||
activities in Odoo. Use the search bar to find contacts faster.
|
||||
|
||||
.. image:: voip_widget/voip-tabs.png
|
||||
:alt: VoIP tabs that can be clicked on.
|
||||
.. image:: voip_widget/phone-widget.png
|
||||
:alt: The **Phone** widget has four tabs: **Keypad**, **Recent**, **Contacts**, and **Activities**.
|
||||
|
||||
Keypad tab
|
||||
----------
|
||||
|
||||
Under the :guilabel:`Keypad` tab of the **Phone** widget, the user can type a name or number to make
|
||||
a call. There is also a numeric keypad for the user to enter the phone number.
|
||||
|
||||
Recent tab
|
||||
----------
|
||||
|
||||
Under the :guilabel:`Recent` tab of the |VOIP| widget, the call history for the user is available.
|
||||
This includes incoming and outgoing calls. Any number can be clicked to begin a call.
|
||||
Under the :guilabel:`Recent` tab of the **Phone** widget, the call history for the user is
|
||||
available. This includes incoming and outgoing calls. Any number can be clicked to begin a call.
|
||||
|
||||
Next activities tab
|
||||
-------------------
|
||||
Contacts tab
|
||||
------------
|
||||
|
||||
Under the :guilabel:`Next Activities` tab of the |VOIP| widget, a user can see any calls assigned to
|
||||
Under the :guilabel:`Contacts` tab of the **Phone** widget, the user can access a contact in the
|
||||
**Contacts** app.
|
||||
|
||||
Any contact that has a saved phone number can be called by clicking into the contact from the
|
||||
*Phone* widget's :guilabel:`Contacts` tab.
|
||||
|
||||
A search feature is also available at the top of the widget, represented by a :icon:`fa-search`
|
||||
:guilabel:`(search)` icon. Use this tool to find a specific contact. Scheduled activities will not
|
||||
appear as search results.
|
||||
|
||||
Activities tab
|
||||
--------------
|
||||
|
||||
Under the :guilabel:`Activities` tab of the **Phone** widget, a user can see any calls assigned to
|
||||
them, and which ones are due to be completed for the day.
|
||||
|
||||
Click an activity from this tab to perform any of these actions to prepare for and complete (found
|
||||
under the **Documents** heading):
|
||||
|
||||
- :icon:`fa-envelope` :guilabel:`(envelope)`: send an email to a contact (e.g., coworkers or
|
||||
clients)
|
||||
- :icon:`fa-user` :guilabel:`(user)`: shows the contact information for this contact
|
||||
- :icon:`fa-file-text-o` :guilabel:`(documents)`: shows the attached record in Odoo (like sales
|
||||
orders)
|
||||
- :icon:`fa-clock-o` :guilabel:`(Activities)`: schedule an activity
|
||||
- :icon:`fa-user` :guilabel:`Contact`: opens the contact information for this contact.
|
||||
- :icon:`fa-star` :guilabel:`Leads/Create Lead`: opens the lead information for this contact.
|
||||
- :icon:`oi-arrow-right` :guilabel:`(Open related record)`: opens the attached record in Odoo (like
|
||||
Sales Orders, Invoices, Projects, Events).
|
||||
|
||||
When viewing the activity, the user can also manage the activity's details and status:
|
||||
|
||||
- :icon:`fa-check` :guilabel:`(check)`: marks the activity as complete
|
||||
- :icon:`fa-pencil` :guilabel:`(edit)`: edits the activity (like its due date)
|
||||
- :icon:`oi-close` :guilabel:`(close)`: cancels the activity
|
||||
- :icon:`fa-check` :guilabel:`(Done)`: marks the activity as complete.
|
||||
- :icon:`fa-pencil` :guilabel:`(Edit)`: edits the activity (like its due date).
|
||||
- :icon:`fa-close` :guilabel:`(Cancel)`: cancels the activity.
|
||||
|
||||
To call the customer related to a scheduled activity, click the :icon:`fa-phone` :guilabel:`(phone)`
|
||||
icon. Click the :icon:`fa-keyboard-o` :guilabel:`(keyboard)` icon to dial another number.
|
||||
To call the customer related to a scheduled activity, click the :icon:`fa-phone` :guilabel:`(Call)`
|
||||
icon. Click the :icon:`fa-comment` :guilabel:`(SMS)` icon to send a text message.
|
||||
|
||||
Add a call
|
||||
~~~~~~~~~~
|
||||
|
||||
From the database home page, click :menuselection:`CRM app`. On the :guilabel:`Pipeline`, make sure
|
||||
it is open to the Kanban view. Next, near the top of the screen, click the :icon:`oi-voip`
|
||||
:guilabel:`VoIP` icon and make sure the |VOIP| widget is opened to the :guilabel:`Next Activites`
|
||||
tab. After that, hover over the opportunity that should have a call and click the :icon:`fa-phone`
|
||||
:guilabel:`(phone)` with the small green :icon:`fa-plus` :guilabel:`plus` icon.
|
||||
:guilabel:`(Show Softphone)` icon and make sure the **Phone** widget is opened to the
|
||||
:guilabel:`Activities` tab. After that, hover over the opportunity that should have a call and click
|
||||
the :icon:`fa-phone` :guilabel:`(phone)` with the small green :icon:`fa-plus` :guilabel:`(plus)`
|
||||
icon.
|
||||
|
||||
.. image:: voip_widget/add-call.png
|
||||
:alt: A sales opportunity with the option to add a call to the VoIP widget.
|
||||
:alt: A sales opportunity with the option to add a call to the Phone widget.
|
||||
|
||||
To remove a call from the :guilabel:`Next activities` tab, hover over the opportunity that has a
|
||||
call scheduled, and click the red :icon:`fa-phone` :guilabel:`(phone)` icon that appears with the
|
||||
To remove a call from the :guilabel:`Activities` tab, hover over the opportunity that has a call
|
||||
scheduled, and click the red :icon:`fa-phone` :guilabel:`(phone)` icon that appears with the
|
||||
:icon:`fa-minus` :guilabel:`(minus)` icon.
|
||||
|
||||
.. image:: voip_widget/remove-call.png
|
||||
:alt: A sales opportunity with the option to remove a call from the VoIP widget.
|
||||
:alt: A sales opportunity with the option to remove a call from the Phone widget.
|
||||
|
||||
Contacts tab
|
||||
------------
|
||||
Make a VoIP call with the Phone widget
|
||||
======================================
|
||||
|
||||
Under the :guilabel:`Contacts` tab of the |VOIP| widget, a user can access a contact in the
|
||||
**Contacts** app.
|
||||
|
||||
Any contact that has a saved phone number can be called by clicking into the contact from the |VOIP|
|
||||
widget's :guilabel:`Contacts` tab.
|
||||
|
||||
A search feature is also available at the top of the widget, represented by a :icon:`fa-search`
|
||||
:guilabel:`(search)` icon. Use this tool to find a specific contact. Scheduled activities will not
|
||||
appear as search results.
|
||||
|
||||
Make a phone call with VoIP
|
||||
===========================
|
||||
|
||||
One of the primary purposes of |VOIP| is to make phone calls without needing a phone. Here are the
|
||||
three ways to make a phone call in the Odoo database. First, click the :icon:`oi-voip`
|
||||
:guilabel:`(VoIP)` icon, located in the top-right of the navigation bar. From here:
|
||||
One of the primary purposes of the Odoo **Phone** app is to make calls without needing a phone. Here
|
||||
are the three ways to make a phone call in the Odoo database. First, click the :icon:`oi-voip`
|
||||
:guilabel:`(Show Softphone)` icon, located in the top-right of the navigation bar. From here:
|
||||
|
||||
- Enter the phone number to be called by clicking the :icon:`fa-keyboard-o` :guilabel:`(keyboard)`
|
||||
icon, and then entering the phone number.
|
||||
@@ -95,7 +100,7 @@ three ways to make a phone call in the Odoo database. First, click the :icon:`oi
|
||||
- Search for a specific contact's name or go to the :guilabel:`Contacts` tab. Then, select the
|
||||
contact and click the :icon:`fa-phone` :guilabel:`(phone)` icon.
|
||||
|
||||
When receiving calls in Odoo, the |VOIP| widget rings, and displays a notification. To close the
|
||||
When receiving calls in Odoo, the **Phone** widget rings, and displays a notification. To close the
|
||||
widget, click the :icon:`oi-close` :guilabel:`(close)` icon in the upper-right of the widget's
|
||||
screen.
|
||||
|
||||
@@ -107,7 +112,7 @@ screen.
|
||||
Transfer a phone call
|
||||
---------------------
|
||||
|
||||
Manually transferring a call only happens when on a call. To transfer a call within the |VOIP|
|
||||
Manually transferring a call only happens when on a call. To transfer a call within the *Phone*
|
||||
widget, first, answer the call using the green :icon:`fa-phone` :guilabel:`(phone)` icon.
|
||||
|
||||
Once the incoming call is answered, click the :icon:`fa-arrows-h` :guilabel:`(left-right arrows)`
|
||||
@@ -115,7 +120,7 @@ icon. Then, enter the extension of the user the call should be forwarded to. Fin
|
||||
:guilabel:`Transfer` to route the call to that phone number.
|
||||
|
||||
.. tip::
|
||||
To find the extension for a user, consult the |VOIP| administrator. If the user has
|
||||
To find the extension for a user, consult the **Phone** administrator. If the user has
|
||||
:guilabel:`Administration` access rights set to :guilabel:`Settings`, find extensions by going to
|
||||
:menuselection:`Settings app` and click the :icon:`fa-arrow-right` :guilabel:`Manage Users`
|
||||
button. Select the user, and go to the :guilabel:`VoIP` tab. That user's extension is their
|
||||
@@ -134,17 +139,17 @@ Then, click the :icon:`fa-arrows-h` :guilabel:`(left-right arrows)` icon. Enter
|
||||
number of the user the call should be forwarded to. Finally, click :guilabel:`Transfer` to route the
|
||||
call to that phone number.
|
||||
|
||||
Send an email through the VoIP widget
|
||||
=====================================
|
||||
Send an email through the Phone widget
|
||||
======================================
|
||||
|
||||
Emails can also be sent through the |VOIP| widget. This is helpful for sending follow-up emails to
|
||||
the call participants, emailing a question to a coworker, or reminding a vendor to send over some
|
||||
Emails can also be sent through the **Phone** widget. This is helpful for sending follow-up emails
|
||||
to the call participants, emailing a question to a coworker, or reminding a vendor to send over some
|
||||
components during a check-in call.
|
||||
|
||||
To send an email through the |VOIP| widget, click the :icon:`oi-voip` :guilabel:`(VoIP)` icon,
|
||||
located in the top navigation bar. When this is clicked, the |VOIP| widget will appear in the
|
||||
bottom-left corner of the page. Then, search for a contact to email or find them in the
|
||||
:guilabel:`Contacts` tab of the |VOIP| widget.
|
||||
To send an email through the **Phone** widget, click the :icon:`oi-voip` :guilabel:`(Show
|
||||
Softphone)` icon, located in the top navigation bar. When this is clicked, the **Phone** widget will
|
||||
appear in the bottom-left corner of the page. Then, search for a contact to email or find them in
|
||||
the :guilabel:`Contacts` tab of the **Phone** widget.
|
||||
|
||||
Next, click the :icon:`fa-envelope-o` :guilabel:`(envelope)` icon, and then select the email
|
||||
recipients, enter the email's subject line, and write the email. When it is ready to be sent, click
|
||||
@@ -154,21 +159,21 @@ scheduled time, and click :guilabel:`Schedule`.
|
||||
|
||||
.. _voip/voip_widget/troubleshooting_voip:
|
||||
|
||||
Troubleshooting the VoIP widget
|
||||
===============================
|
||||
Troubleshooting
|
||||
===============
|
||||
|
||||
Each section below goes through common issues with the |VOIP| widget and how to resolve them.
|
||||
Each section below goes through common issues with the **Phone** widget and how to resolve them.
|
||||
|
||||
Missing parameter
|
||||
-----------------
|
||||
|
||||
If a *Missing Parameter* error message appears in the |VOIP| widget, refresh the window, and try
|
||||
If a *Missing Parameter* error message appears in the **Phone** widget, refresh the window, and try
|
||||
again.
|
||||
|
||||
Incorrect number
|
||||
----------------
|
||||
|
||||
If an *Incorrect Number* error message appears in the |VOIP| widget, make sure to use the
|
||||
If an *Incorrect Number* error message appears in the **Phone** widget, make sure to use the
|
||||
international format, leading with the :icon:`fa-plus` :guilabel:`(plus)`, followed by the
|
||||
international country code (e.g., +16506913277, where `+1` is the international prefix for the
|
||||
United States.)
|
||||
@@ -178,7 +183,7 @@ The websocket connection with the server has been lost
|
||||
------------------------------------------------------
|
||||
|
||||
If a *The websocket connection with the server has been lost. Please try to refresh the page.* error
|
||||
message appears in the |VOIP| widget, then refresh the page close other browser tabs.
|
||||
message appears in the **Phone** widget, then refresh the page close other browser tabs.
|
||||
|
||||
This error is caused by returning to the database after a period of inactivity, like lunch, or if
|
||||
there are too many browser tabs open.
|
||||
@@ -188,21 +193,21 @@ Failed to start the user agent
|
||||
|
||||
If a *Failed to start the user agent. The URL of the websocket may be wrong. Please have an
|
||||
administrator verify the websocket server URL in the General Settings.* error message appears in the
|
||||
|VOIP| widget, then update the browser and computer.
|
||||
*Phone* widget, then update the browser and computer.
|
||||
|
||||
This error is caused by the browser or computer not being up-to-date (and can also cause issues with
|
||||
the microphone).
|
||||
|
||||
Grayed-out VoIP widget
|
||||
----------------------
|
||||
Grayed-out Phone widget
|
||||
-----------------------
|
||||
|
||||
If the |VOIP| widget is completely grayed out and cannot be interacted with, then update the browser
|
||||
and computer, and delete the Google Chrome extension causing the problem.
|
||||
If the **Phone** widget is completely grayed out and cannot be interacted with, then update the
|
||||
browser and computer, and delete the Google Chrome extension causing the problem.
|
||||
|
||||
Cannot connect to the VoIP phone number
|
||||
---------------------------------------
|
||||
|
||||
If the user cannot connect to their |VOIP| phone number, then their Odoo profile is missing their
|
||||
:guilabel:`Voip Secret`. To add this, click the user avatar, and then click :guilabel:`My Profile`.
|
||||
From here, click the :guilabel:`VoIP` tab, and then enter the user's :guilabel:`Voip Secret`. This
|
||||
is the user's password to their account for their |VOIP| service provider.
|
||||
|VoIP| :guilabel:`Secret`. To add it, :menuselection:`Settings app --> Users & Companies --> Users`
|
||||
select the user, and click the *VoIP* tab. Under the *Credentials* section, enter the user's
|
||||
:guilabel:`Secret`. This is the user's password to their account for their |VOIP| service provider.
|
||||
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 8.8 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 4.8 KiB |
Reference in New Issue
Block a user