Skip to content

[IMP] VoIP: Devices + Integrations Revamp #13002

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: 18.0
Choose a base branch
from

Conversation

justinmallette
Copy link
Contributor

@justinmallette justinmallette commented Apr 22, 2025

Overhauled devices and integrations doc to match styling, flow, and platform accuracy.

Task: https://www.odoo.com/odoo/project/3835/tasks/4744593

@robodoo
Copy link
Collaborator

robodoo commented Apr 22, 2025

Pull request status dashboard

@C3POdoo C3POdoo requested a review from a team April 22, 2025 17:51
@justinmallette justinmallette force-pushed the 18.0-voip-devices-updates-juma branch from f665b68 to 058ba28 Compare April 22, 2025 18:23
Copy link
Contributor

@slinkous slinkous left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

VOIP is such a beast! A couple of instances of sentence disagreement here, but the rest is just food for thought. Also do Zoiper and Linphone have account setup articles to link out? Could be nice.


Odoo *VoIP* is SIP (Session Initiation Protocol) compatible, which means it can be used with *any*
:abbr:`SIP (Session Initiation Protocol)` compatible application.
While |VOIP| is available on Odoo's desktop experience, it can also be used through the Odoo mobile
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

link doc for more info on mobile apps

support tickets.
Odoo |VOIP| is fully integrated with the **Contacts**, **CRM**, **Sales**, and **Helpdesk** apps.
While the benefits are most clearly felt when using |VOIP| from the Odoo database, it can also be
used from apps like the ones covered below.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Highly optional, but I would list the apps rather than use a spatial reference, since doc things move around with time

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.
Using |VOIP| through the Odoo mobile app or through a third-party tool still requires a |VOIP|
service provider. Learn more about signing a :doc:`VoIP service provider <../voip>`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Move to a "see more" admonition or finish the sentence with a prepositional phrase so it's not just a command to learn

Comment on lines +28 to +29
Odoo mobile apps are no longer supported by Odoo. Learn more about :doc:`Odoo's mobile apps
<../../../administration/mobile>`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does this contradict the first sentence encouraging you to use mobile apps? I assume this is distinguishing the PWA app from some deprecated one but for the average user this looks like it would be confusing.

Comment on lines +47 to +48
This step is **necessary**, regardless of whether the mobile Odoo application or web browser is
used.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

admonition and specify what it blocks

:align: center
:alt: Zoiper account setup, shown in the view from a mobile device.
Once *Zoiper Lite* is installed on the mobile device, open the app and tap on :guilabel:`Settings`.
Navigate to :menuselection:`Accounts`, and tap on the :guilabel:`+ (plus)` icon to add an account.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Navigate to :menuselection:`Accounts`, and tap on the :guilabel:`+ (plus)` icon to add an account.
Navigate to :menuselection:`Accounts`, and tap the :guilabel:`+ (plus)` icon to add an account.

.. example::
If the provider being configured is *Axivox*, then select :guilabel:`Belgium`. Then, choose
:guilabel:`Axivox` as the provider.
If :guilabel:`Manual configuration` was tapped, then tap :guilabel:`SIP account`. From here, under
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
If :guilabel:`Manual configuration` was tapped, then tap :guilabel:`SIP account`. From here, under
If :guilabel:`Manual configuration` was tapped, tap :guilabel:`SIP account`. From here, under

if...then == causality, not procedure


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>`_.
*Linphone* third-party alternative to Odoo |VOIP|. It is a free |VOIP| |SIP| dialer with voice,
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
*Linphone* third-party alternative to Odoo |VOIP|. It is a free |VOIP| |SIP| dialer with voice,
*Linphone* is a third-party alternative to Odoo |VOIP|. It is a free |VOIP| |SIP| dialer with voice,

*Linphone* IOS application. Screenshots and steps may differ depending on the circumstances.
Download the *Linphone* app from either the `Google Play Store
<https://play.google.com/store/apps/details?id=org.linphone>`_ or the `Apple App Store
<https://apps.apple.com/us/app/linphone/id360065638>`_ (depending on the device's operating system)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You probably don't need to explain that it depends on OS in this day and age

Download the *Linphone* app from either the `Google Play Store
<https://play.google.com/store/apps/details?id=org.linphone>`_ or the `Apple App Store
<https://apps.apple.com/us/app/linphone/id360065638>`_ (depending on the device's operating system)
to begin using *Linphone*. This article will cover setting up *Linphone* for an iOS device while
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The article thing again. Like maybe these should just actually be fully separate docs?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants