diff --git a/content/applications/productivity/voip.rst b/content/applications/productivity/voip.rst index ccc58fbe02..e844b4ac18 100644 --- a/content/applications/productivity/voip.rst +++ b/content/applications/productivity/voip.rst @@ -123,6 +123,7 @@ VoIP workflows voip/onsip voip/axivox + voip/didww voip/voip_widget voip/devices_integrations voip/sales_calls diff --git a/content/applications/productivity/voip/didww.rst b/content/applications/productivity/voip/didww.rst new file mode 100644 index 0000000000..d69b1d9a4d --- /dev/null +++ b/content/applications/productivity/voip/didww.rst @@ -0,0 +1,84 @@ +================================ +VoIP services in Odoo with DIDWW +================================ + +*DIDWW* is a global *VoIP* and SIP trunking provider. An active account with DIDWW is required to +use this service. + +Before creating an account with DIDWW, make sure that the company's location and the applicable +regions are supported by DIDWW's services. + +DIDWW setup +=========== + +After verifying country coverage and avaiabilty, create an account with `DIDWW +`_. Then navigate to the `DIDWW Dashboard +`_. + +To transfer existing numbers from an existing telephone network servicer provider, follow the steps +outlined on the `DIDWW website `_. + +Purchase new numbers +-------------------- + +To puchase new phone numbers, click :guilabel:`Buy Numbers` in the dashboard, then follow the +instructions to complete the purchase. + +When buying a new number, it **must** support both inbound calls and Local CLI. + +.. image:: didww/didww-purchase-numbers.png + :alt: The purchase dashboard in DIDWW. + +Enable phone.systems +-------------------- + +Next, click :guilabel:`Cloud Phone System` in the dashboard sidebar. Then, click :guilabel:`Launch +admin UI`. + +.. important:: + The *phone.systems PBX* feature is an extra paid service in DIDWW, and may require additional + fees. + +To create a new user, click :guilabel:`Users`, click the plus sign, then enter the necessary +information. + +.. image:: didww/add-user.png + :alt: The add a new user screen in DIDWW. + +Click :guilabel:`Contact Methods`, then click the plus sign to add a new *SIP Device Route*. + +Configure or add the following parameters: + +- :guilabel:`Allowed Codecs`: `OPUS`, `PCMU`, `PCMA`, `telephone-event`, `g722`, `g729`. +- :guilabel:`Allowed media types`: `SRTP-DTLS` +- :guilabel:`Default media type`: `STRP-DTLS` +- :guilabel:`Transport protocol`: `UDP`, `TCP`, `WSS`, `TLS` + +.. image:: didww/sip-device-route.png + :alt: The settings for a new contact method in DIDWW. + +.. tip:: + If no phone number available from drop-down selection in *Inbound and Outbound DID/Caller ID* + selection, the :guilabel:`Inbounch voice trunk` needs to be modified. Navigate to the dashboard, + then click :guilabel:`My Numbers`. Scroll to :guilabel:`Configuration`.In the :guilabel:`Inbound + voice trunk` field, select :guilabel:`phone.systems`. + +Odoo setup +========== + +In *Odoo*, navigate to :menuselection:`Settings app --> Integrations --> VoIP --> Manage Providers`. +Click :guilabel:`New`. + +Enter the name, `DIDWW`, then update the :guilabel:`WebSocket` field with `wss://sip.phone.systems`. +Under :guilabel:`PBX Server IP`, enter `sip.phone.systems`. + +.. image:: didww/new-provider.png + :alt: The VoIP providers page in Odoo. + +To configure a user's VoIP provider, click the user avatar in the top-right of the database, then +click :guilabel:`My Profile`. Click into the :guilabel:`VoIP` tab, then under the :guilabel:`Voip +Provider` field, select :guilabel:`DIDWW`. Finally, enter the :guilabel:`Voip Username` and +:guilabel:`Voip Secret`, then save. + +.. image:: didww/odoo-credentials.png + :alt: DIDWW provider, username, and secret credentials entered. diff --git a/content/applications/productivity/voip/didww/add-user.png b/content/applications/productivity/voip/didww/add-user.png new file mode 100644 index 0000000000..a6407b110f Binary files /dev/null and b/content/applications/productivity/voip/didww/add-user.png differ diff --git a/content/applications/productivity/voip/didww/didww-purchase-numbers.png b/content/applications/productivity/voip/didww/didww-purchase-numbers.png new file mode 100644 index 0000000000..29d20a0b95 Binary files /dev/null and b/content/applications/productivity/voip/didww/didww-purchase-numbers.png differ diff --git a/content/applications/productivity/voip/didww/new-provider.png b/content/applications/productivity/voip/didww/new-provider.png new file mode 100644 index 0000000000..e5b3d13e10 Binary files /dev/null and b/content/applications/productivity/voip/didww/new-provider.png differ diff --git a/content/applications/productivity/voip/didww/odoo-credentials.png b/content/applications/productivity/voip/didww/odoo-credentials.png new file mode 100644 index 0000000000..cc8a5c10e2 Binary files /dev/null and b/content/applications/productivity/voip/didww/odoo-credentials.png differ diff --git a/content/applications/productivity/voip/didww/sip-device-route.png b/content/applications/productivity/voip/didww/sip-device-route.png new file mode 100644 index 0000000000..d5affd7c6a Binary files /dev/null and b/content/applications/productivity/voip/didww/sip-device-route.png differ