diff --git a/content/applications/productivity/discuss.rst b/content/applications/productivity/discuss.rst index 17b406e03..58a590acb 100644 --- a/content/applications/productivity/discuss.rst +++ b/content/applications/productivity/discuss.rst @@ -11,3 +11,4 @@ Discuss :titlesonly: discuss/overview + discuss/advanced \ No newline at end of file diff --git a/content/applications/productivity/discuss/advanced.rst b/content/applications/productivity/discuss/advanced.rst new file mode 100644 index 000000000..ce5f53dea --- /dev/null +++ b/content/applications/productivity/discuss/advanced.rst @@ -0,0 +1,10 @@ +:nosearch: + +======== +Advanced +======== + +.. toctree:: + :titlesonly: + + advanced/ice_servers diff --git a/content/applications/productivity/discuss/advanced/ice_servers.rst b/content/applications/productivity/discuss/advanced/ice_servers.rst new file mode 100644 index 000000000..0e1b8715b --- /dev/null +++ b/content/applications/productivity/discuss/advanced/ice_servers.rst @@ -0,0 +1,72 @@ +================================= +Configure ICE servers with Twilio +================================= + +Odoo Discuss uses WebRTC API and peer-to-peer connections for voice and video calls. If one of the +call attendees is behind a symmetric NAT, you need to configure an ICE server to establish a +connection to the call attendee. To set up an ICE server, first, create a Twilio account for video +calls, and then, connect that Twilio account to Odoo. + +Create a Twilio account +======================= + +First, go to `Twilio `_ and click :guilabel:`Sign up` to create a new +Twilio account. Next, enter your name and email address, create a password, and accept Twilio's +terms of service. Then, click :guilabel:`Start your free trial`. Verify your email address with +Twilio, as per their instructions. + +Next, enter your phone number into Twilio. Then, Twilio will send you an SMS text message +containing a verification code. Enter the verification code into Twilio to verify your phone number. + +After that, Twilio redirects to a welcome page. Use the following list to answer Twilio's questions: + +- For :guilabel:`Which Twilio product are you here to use?`, select :guilabel:`Video`. +- For :guilabel:`What do you plan to build with Twilio?`, select :guilabel:`Other`. +- For :guilabel:`How do you want to build with Twilio?`, select :guilabel:`With no code at all`. +- For :guilabel:`What is your goal today?`, select :guilabel:`3rd party integrations`. + +.. image:: ice_servers/twilio-welcome.png + :align: center + :alt: The Twilio welcome page. + +If necessary, change the billing country. Finally, click :guilabel:`Get Started with Twilio`. + +Locate the Twilio Account SID and Auth Token +============================================ + +To locate the Account SID and Auth Token, go to the Twilio account dashboard. Then, click +:guilabel:`Develop` on the sidebar. In the :guilabel:`Account Info` section, locate the +:guilabel:`Account SID` and the :guilabel:`Auth Token`. Both of these are needed to connect Twilio +to Odoo. + +.. image:: ice_servers/twilio-acct-info.png + :align: center + :alt: The Twilio Account SID and Auth Token can be found uner the Account Info section. + +Connect Twilio to Odoo +====================== + +Open the Odoo database and go to :menuselection:`Settings --> General Settings --> Discuss`. Check +the box next to :guilabel:`Use Twilio ICE servers` and enter the Twilio account's :guilabel:`Account +SID` and :guilabel:`Auth Token`. Finally, click :guilabel:`Save` to apply these changes. + +.. image:: ice_servers/connect-twilio-to-odoo.png + :align: center + :alt: Enable the "Use Twilio ICE servers" option in Odoo General Settings. + +Define a list of custom ICE servers +=================================== + +In :menuselection:`Settings --> General Settings --> Discuss`, click the :guilabel:`ICE Servers` +button under :guilabel:`Custom ICE server list`. + +.. image:: ice_servers/custom-ice-servers-list.png + :align: center + :alt: The "ICE Servers" button in Odoo General Settings. + +Odoo will redirect to the :guilabel:`ICE servers` page. Here you can define your own list of ICE +servers. + +.. image:: ice_servers/ice-servers-page.png + :align: center + :alt: The "ICE servers" page in Odoo. diff --git a/content/applications/productivity/discuss/advanced/ice_servers/connect-twilio-to-odoo.png b/content/applications/productivity/discuss/advanced/ice_servers/connect-twilio-to-odoo.png new file mode 100644 index 000000000..e8e5a5e1e Binary files /dev/null and b/content/applications/productivity/discuss/advanced/ice_servers/connect-twilio-to-odoo.png differ diff --git a/content/applications/productivity/discuss/advanced/ice_servers/custom-ice-servers-list.png b/content/applications/productivity/discuss/advanced/ice_servers/custom-ice-servers-list.png new file mode 100644 index 000000000..43c760555 Binary files /dev/null and b/content/applications/productivity/discuss/advanced/ice_servers/custom-ice-servers-list.png differ diff --git a/content/applications/productivity/discuss/advanced/ice_servers/ice-servers-page.png b/content/applications/productivity/discuss/advanced/ice_servers/ice-servers-page.png new file mode 100644 index 000000000..f0bef0ca3 Binary files /dev/null and b/content/applications/productivity/discuss/advanced/ice_servers/ice-servers-page.png differ diff --git a/content/applications/productivity/discuss/advanced/ice_servers/twilio-acct-info.png b/content/applications/productivity/discuss/advanced/ice_servers/twilio-acct-info.png new file mode 100644 index 000000000..90d0cbd42 Binary files /dev/null and b/content/applications/productivity/discuss/advanced/ice_servers/twilio-acct-info.png differ diff --git a/content/applications/productivity/discuss/advanced/ice_servers/twilio-welcome.png b/content/applications/productivity/discuss/advanced/ice_servers/twilio-welcome.png new file mode 100644 index 000000000..c8f37fe59 Binary files /dev/null and b/content/applications/productivity/discuss/advanced/ice_servers/twilio-welcome.png differ diff --git a/content/applications/productivity/discuss/overview.rst b/content/applications/productivity/discuss/overview.rst index 18669bde1..0672200a8 100644 --- a/content/applications/productivity/discuss/overview.rst +++ b/content/applications/productivity/discuss/overview.rst @@ -10,4 +10,3 @@ Overview overview/get_started overview/team_communication overview/plan_activities -