# Odoo

Use [Odoo](https://www.odoo.com/) with **DIDWW** and **phone.systems(TM)** to place and receive business calls directly
from the Odoo Phone app.
This integration routes DIDWW phone numbers through phone.systems(TM) and connects them to Odoo using secure WebSocket
signaling for browser-based WebRTC calling.

- Route DIDWW phone numbers to the Odoo Phone app.
- Place and receive calls directly in Odoo.
- Use existing DIDWW numbers for browser-based calling.

- Link Odoo users to dedicated phone.systems(TM) SIP Accounts.
- Deliver calls to individual users through phone.systems(TM).
- Keep business calling inside the Odoo workspace.

---

## 1. Route DIDWW Numbers to phone.systems(TM)

Prepare your DIDWW account and route your DID numbers to **phone.systems(TM)**.
This step is required because phone.systems(TM) acts as the calling layer between DIDWW and the Odoo Phone app.
After your DID numbers are assigned to the phone.systems(TM) trunk, phone.systems(TM) can forward incoming calls to the
SIP Accounts that are later connected to Odoo users.

### Before You Begin

- An active **DIDWW account** is required. [Sign in to DIDWW](https://my.didww.com/users/sign_in) or [Create DIDWW account](https://my.didww.com/users/sign_up#/users/sign_up).
- At least one active **DID number** with **inbound calls** and **local CLI** features with sufficient [Capacity](../../phone-numbers/capacity/index.html#flexible-capacity) to receive incoming calls is required. See [Buy Numbers](https://my.didww.com/users/sign_up#/coverage) and [Number Porting](../../phone-numbers/number-porting/index.html#user-panel-porting).

### Step 1: Purchase phone.systems(TM) Seats

Before you configure the DID number routing, you will need at least one phone.systems(TM) seat to gain access to
phone.systems(TM) trunks. If you do not have any seats yet:

1. In the DIDWW User Panel, open the [Cloud Phone System](https://my.didww.com/#/phone_systems) menu.
2. Purchase the required amount of **phone.systems(TM)** seats.

Note

Purchase one **phone.systems(TM)** seat for each Odoo user who will make or receive calls.

[![Purchasing phone.systems(TM) seats in the DIDWW User Panel](../../_images/purchase_seats.png)](../../_images/purchase_seats.png)


Fig. 1. Purchasing phone.systems(TM) seats in DIDWW

### Step 2: Assign phone.systems(TM) Trunk to Your DID Numbers

After purchasing the required phone.systems(TM) service, assign the phone.systems(TM) trunk to the DID number(s) that
will be used with Odoo.

1. In the DIDWW User Panel, go to **Phone Numbers > My Numbers**.
2. Select the DID number(s) you want to assign to the phone.systems(TM) trunk.
3. At the bottom of the page, click **Batch Actions > Update Trunks**.

[![Assigning the phone.systems(TM) trunk to DID numbers](../../_images/didww2.png)](../../_images/didww2.png)


Fig. 2. Selecting **Update Trunks** from the Batch Actions menu

4. From the dropdown menu, choose the **phone.systems(TM)** trunk.
5. Click **Confirm** to assign the trunk.

[![Assigning the phone.systems(TM) trunk to DID numbers](../../_images/didww3.png)](../../_images/didww3.png)


Fig. 3. Assigning the phone.systems(TM) trunk to the selected DID(s)

### Step 3: Launch phone.systems(TM)

1. In the DIDWW User Panel, go to [Cloud Phone System](https://my.didww.com/#/phone_systems) menu.
2. Click **Launch admin UI**.

[![Launching the phone.systems(TM) admin UI from DIDWW](../../_images/didww4.png)](../../_images/didww4.png)


Fig. 4. Launching the phone.systems(TM) admin UI



---

## 2. Set Up phone.systems(TM) SIP Accounts for Odoo Users

After assigning your DID number to phone.systems(TM), create the user and SIP Account that will be connected to an Odoo
user.
This step is required because phone.systems(TM) provides the SIP credentials, inbound routing, outbound caller ID,
WebSocket signaling, and secure media settings used by the Odoo Phone app.
Each Odoo user who makes or receives calls should have a dedicated phone.systems(TM) SIP Account.

### Step 1: Create User

1. In the **phone.systems(TM)** admin UI, go to **Users**.
2. Click the **plus** sign and select **Create New** to create a new user.

[![Creating a new user in phone.systems(TM)](../../_images/phonesystems1.png)](../../_images/phonesystems1.png)


Fig. 5. Creating a new user in phone.systems(TM)

3. Enter the required user details, such as **First name**, and **Last name**.
4. Uncheck the **Configure application line in the next step** slider.
5. **Save** the user.

Note

Create one **phone.systems(TM)** user for each Odoo user who will use the Odoo Phone app.

[![Entering user details and saving a new user in phone.systems(TM)](../../_images/phonesystems2.png)](../../_images/phonesystems2.png)


Fig. 6. Entering user details and saving the new user

### Step 2: Create and Configure a SIP Account

1. Go to **Contact Methods > SIP Accounts**.
2. Click the **plus** sign to create a new **SIP Account**.

Note

Create one **SIP Account** for each Odoo user. Each Odoo user should use their own dedicated phone.systems(TM) SIP
credentials.

[![Creating a SIP Account in phone.systems(TM)](../../_images/phonesystems3.png)](../../_images/phonesystems3.png)


Fig. 7. Creating a SIP Account

#### Configure User and Inbound Calls

1. In the **General** section, select the user that you created in the previous step.
2. In the **Inbound calls** section, select the DID number you assigned to **phone.systems(TM)** in DIDWW.

Note

For additional inbound configuration options, such as internal numbers, voicemail, and unavailable behavior, see [SIP
Account inbound calls](../../phone-systems/Contact-methods/sip-accounts.html#ps3-sip-accounts-inbound-calls).

[![Configuring inbound calls in a SIP Account](../../_images/phonesystems4.png)](../../_images/phonesystems4.png)


Fig. 8. Configuring inbound calls in the SIP Account

#### Configure Outbound Calls

1. In the **Outbound calls** section, enable **Enable external outbound calls**.
2. In **Caller ID**, select the same DID number assigned for inbound calling.

Note

For additional outbound configuration options, such as internal caller ID, announcements, and call recording, see [SIP
Account outbound calls](../../phone-systems/Contact-methods/sip-accounts.html#ps3-sip-accounts-outbound-calls).

[![Configuring outbound calls in a SIP Account](../../_images/phonesystems5.png)](../../_images/phonesystems5.png)


Fig. 9. Configuring outbound calls in the SIP Account

#### Configure Advanced Settings and Save

In the **Advanced** section, configure the settings required for Odoo Phone.

1. Keep the default **Allowed Codecs** unless your deployment requires custom codec restrictions.
2. In **Allowed media types**, select `SRTP-DTLS`.
3. In **Default media type**, select `SRTP-DTLS`.
4. In **Transport protocol**, select `WSS`.
5. **Save** the SIP Account.

[![Configuring advanced SIP Account settings in phone.systems(TM)](../../_images/phonesystems6.png)](../../_images/phonesystems6.png)


Fig. 10. Configuring advanced settings in the SIP Account

### Step 3: Copy SIP Account Credentials for Odoo

1. Locate your SIP Account and click **Actions > Edit**.

[![Opening the SIP Account edit view from the Actions menu in phone.systems(TM)](../../_images/phonesystems7.png)](../../_images/phonesystems7.png)


Fig. 11. Opening the SIP Account edit view

2. **Copy and save** the SIP Account credentials for later use in Odoo.

[![Viewing SIP Account credentials in phone.systems(TM)](../../_images/phonesystems8.png)](../../_images/phonesystems8.png)


Fig. 12. Viewing SIP Account credentials



---

## 3. Connect Odoo to DIDWW

After DIDWW and phone.systems(TM) are configured, connect the phone.systems(TM) SIP Account to the Odoo Phone app.
This step allows Odoo to use DIDWW as the calling provider and use the SIP Account credentials for browser-based inbound
and outbound calls.
Each Odoo user is linked to their own phone.systems(TM) SIP Account so calls are delivered to the correct user.

### Step 1: Install Phone App

Before configuring the DIDWW provider, install the **Phone** app in Odoo.

1. In Odoo, open the **Apps** menu.
2. Search for the `phone` app and click **Install**.

[![Installing the Phone app in Odoo](../../_images/odoo1.png)](../../_images/odoo1.png)


Fig. 13. Installing the Phone app in Odoo

### Step 2: Configure DIDWW Provider in Odoo

1. In Odoo, open the **Phone** app.
2. Go to **Configuration > Providers**.

[![Opening the Providers page from the Odoo Phone app](../../_images/odoo2.png)](../../_images/odoo2.png)


Fig. 14. Opening the Providers page in Odoo Phone

3. In the **DIDWW** provider row, set **VoIP Environment** to **Production** to enable real SIP connectivity.
4. Click **Save**.

[![Setting the DIDWW VoIP Environment to Production in Odoo](../../_images/odoo3.png)](../../_images/odoo3.png)


Fig. 15. Setting the DIDWW VoIP Environment to Production

### Step 3: Configure User VoIP Credentials in Odoo

1. Open **Settings**.
2. In the **General Settings > Users** section, click **Manage Users**.

Note

Repeat these credential steps for each Odoo user who will use the Phone app.

[![Opening the Users page from Odoo Settings](../../_images/odoo4.png)](../../_images/odoo4.png)


Fig. 16. Opening the Users page from Odoo Settings

3. Open the user who will use the Odoo **Phone** app.
4. Open the **VoIP** tab.
5. Configure **Credentials** settings:

   - Select **DIDWW** as the **Provider**.
   - Enter the user's phone.systems(TM) SIP Account **Username**.
   - Enter the SIP Account's **Password** in the **Secret** field.

[![Configuring DIDWW VoIP credentials for an Odoo user](../../_images/odoo5.png)](../../_images/odoo5.png)


Fig. 17. Configuring VoIP credentials for an Odoo user

### Step 4: Test Inbound and Outbound Calls

When the DIDWW provider and user credentials are configured, test the connection in Odoo.

1. Click the **Phone** icon in the top-right corner of Odoo to open the **softphone**.
2. Place a test **inbound call** to the DID number assigned to phone.systems(TM).
3. Place a test **outbound call** to any PSTN number in E.164 format (country code + area code + subscriber number, e.g., 15550100001).

Verify that calls connect successfully and that the user can both place and receive calls in Odoo.

Note

You can review call activity and verify call status or error codes in the [phone.systems(TM) Call
Analytics](../../phone-systems/Call-analytics/index.html#ps3-call-analytics).

[![Testing a call in the Odoo Phone softphone](../../_images/odoo6.png)](../../_images/odoo6.png)


Fig. 18. Testing a call in the Odoo Phone softphone

---

## Additional Resources

**Odoo Phone Documentation**

Official Odoo documentation for the Phone app and its features.

<https://www.odoo.com/documentation/19.0/applications/productivity/phone.html>

**Odoo DIDWW Documentation**

Official Odoo guide for using the Phone app with DIDWW.

<https://www.odoo.com/documentation/19.0/applications/productivity/phone/didww.html>

On this page
