> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# DIDWW Integration

> Connect a DIDWW phone number to Famulor via SIP trunks

<Warning>
  **Done for you — any region, any country (our EU partner carrier)**

  If you prefer not to configure a SIP trunk or import numbers yourself, our **EU partner carrier** can supply **local numbers in any region and any country**, set up the **SIP trunk**, and **import the connection into Famulor** for you. Provisioning runs **end-to-end through the partner** (carrier-side), so you skip DIY trunk and number import in Famulor.

  * **Custom number region / full-service onboarding:** [Famulor Custom Number Region form](https://tally.so/r/w4bN2Y)
  * **More detail or bespoke options:** [support@famulor.de](mailto:support@famulor.de)
</Warning>

# Connect a DIDWW Number to Famulor

This guide connects a **DIDWW** phone number to Famulor via SIP trunks.

<Note>
  **DIDWW** (with POPs in Frankfurt, Amsterdam, London, Madrid and more) is **not** the same as **DIDLogic** – it is a separate provider. For DIDLogic, see [DIDLogic Integration](/en/provisioning/sip-ai/didlogic-integration).
</Note>

<Note>
  Famulor has **no** dedicated DIDWW import feature. In DIDWW you create **two trunks**:

  * **Inbound trunk** (incoming calls): routes your number to **Famulor's SIP address**.
  * **Outbound trunk** (outgoing calls): provides the credentials Famulor uses to call through `out.didww.com`.
</Note>

## How it works

```mermaid theme={null} theme={null}
sequenceDiagram
    participant C as Caller
    participant D as DIDWW
    participant FA as Famulor
    participant A as AI assistant

    Note over D,FA: Inbound – inbound trunk to „Our SIP address"
    C->>D: Call to your DIDWW number
    D->>FA: SIP call to „Our SIP address"
    FA->>A: Call routed to assigned assistant
    A->>FA: Voice response (real time)
    FA->>C: Conversation with AI assistant
    Note over FA,D: Outbound – auth to out.didww.com
```

## Prerequisites

* An active **DIDWW** account with at least one phone number (DID)
* A Famulor account

***

## Step 1: Create an inbound trunk in DIDWW (incoming calls)

1. First, in a second tab, open Famulor at [app.famulor.de/phone-numbers?lang=en](https://app.famulor.de/phone-numbers?lang=en) → **Your phone numbers → + Integrate SIP trunk** and, under **Incoming call settings**, copy the value **Our SIP address** (e.g. `xxxxxx.eu.sip.livekit.cloud`).
2. In the DIDWW portal, go to **Voice → Inbound Trunks** and click **Create New → SIP Trunk**.

<img src="https://mintcdn.com/famulor/ks-9ch89DcSGh88k/images/didww/didww-inbound-create.png?fit=max&auto=format&n=ks-9ch89DcSGh88k&q=85&s=cc247e1ac7b5789b7baa9946401bc98f" alt="DIDWW: Voice → Inbound Trunks → Create New → SIP Trunk" width="3840" height="1856" data-path="images/didww/didww-inbound-create.png" />

3. Enter:
   * **Friendly Name:** e.g. `Famulor`
   * **SIP Endpoint Hostname:** your **Our SIP address** from Famulor
   * **Transport Protocol Type:** TCP/UDP (port 5060) or TLS (port 5061)
4. Click **Create**.

<img src="https://mintcdn.com/famulor/pclCvrYLxYFxyAhU/images/didww/didww-inbound-settings.png?fit=max&auto=format&n=pclCvrYLxYFxyAhU&q=85&s=773e51397654b8ec632f9d40bdeccfbe" alt="DIDWW: inbound SIP trunk – Friendly Name, SIP Endpoint Hostname (your „Our SIP address“) and Transport" width="2035" height="1044" data-path="images/didww/didww-inbound-settings.png" />

***

## Step 2: Assign the phone number to the inbound trunk

1. Go to **Phone Numbers → My Numbers**.
2. Select the DID number(s).
3. Click **Batch Actions → Update Trunks**.
4. Choose the **Famulor** inbound trunk you just created and confirm with **Confirm**.

<img src="https://mintcdn.com/famulor/ks-9ch89DcSGh88k/images/didww/didww-numbers-batch.png?fit=max&auto=format&n=ks-9ch89DcSGh88k&q=85&s=2d299aed85f1f754936b365601e48bfe" alt="DIDWW: Phone Numbers → My Numbers, number selected, Batch Actions → Update Trunks" width="3840" height="1858" data-path="images/didww/didww-numbers-batch.png" />

<img src="https://mintcdn.com/famulor/pclCvrYLxYFxyAhU/images/didww/didww-assign-trunk.png?fit=max&auto=format&n=pclCvrYLxYFxyAhU&q=85&s=6be1ce4a5e0db4ea599dea32eabfdd1d" alt="DIDWW: „Update Voice IN Trunk“ dialog – select the inbound trunk for the number" width="2035" height="1044" data-path="images/didww/didww-assign-trunk.png" />

***

## Step 3: Create an outbound trunk in DIDWW (outgoing calls)

1. Go to **Voice → Outbound Trunks** and click **Create New**.

<img src="https://mintcdn.com/famulor/ks-9ch89DcSGh88k/images/didww/didww-outbound-create.png?fit=max&auto=format&n=ks-9ch89DcSGh88k&q=85&s=afe58d3fc2476e8d24fe9c44cd81a167" alt="DIDWW: Voice → Outbound Trunks → Create New" width="3840" height="1856" data-path="images/didww/didww-outbound-create.png" />

2. Enter a **Friendly Name** (e.g. `Famulor`).
3. Keep authentication on **Credentials & IP-based**.
4. Under **Allowed SIP IP addresses**, enter Famulor's **fixed outbound IP** (currently `34.195.177.252/32`).
5. Click **Create**.
6. Then open the **key icon** in the **Credentials** column and note the **Username** and **Password** (reveal the password with the eye icon).

<img src="https://mintcdn.com/famulor/pclCvrYLxYFxyAhU/images/didww/didww-outbound-ip.png?fit=max&auto=format&n=pclCvrYLxYFxyAhU&q=85&s=c8a398162364b67245baef6154e05361" alt="DIDWW: outbound trunk – „Credentials & IP-Based“ authentication and Allowed SIP IP addresses" width="2035" height="1044" data-path="images/didww/didww-outbound-ip.png" />

<img src="https://mintcdn.com/famulor/pclCvrYLxYFxyAhU/images/didww/didww-outbound-credentials.png?fit=max&auto=format&n=pclCvrYLxYFxyAhU&q=85&s=7070ebeee2bfea6aa6af66c9a82bd51c" alt="DIDWW: outbound trunk list – open credentials via the key icon" width="1079" height="583" data-path="images/didww/didww-outbound-credentials.png" />

<Note>
  Confirm the **fixed outbound IP** currently shown in the Famulor dialog in case it differs from `34.195.177.252`.
</Note>

***

## Step 4: Set up the SIP trunk in Famulor

1. In Famulor, go to **Your phone numbers** and click **+ Integrate SIP trunk**.
2. Enter the data as follows:

| Field                            | Value                                                                                                          |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| **SIP trunk type**               | **Phone number (DID)**                                                                                         |
| **Phone number**                 | Your DIDWW number in E.164 format (e.g. `+12025550123`)                                                        |
| **Username**                     | The **Username** of the DIDWW outbound trunk (Step 3)                                                          |
| **Password**                     | The **Password** of the DIDWW outbound trunk (Step 3)                                                          |
| **SIP address** (outbound)       | `out.didww.com` (without port)                                                                                 |
| **Outgoing phone number format** | **International (without leading +)** – DIDWW expects E.164 **without** `+`                                    |
| **Fixed outbound IP**            | **Enable** („Outbound call will come from a fixed IP address") so calls originate from the IP allowed in DIDWW |
| **Country**                      | The country of your DIDWW trunk                                                                                |

3. Under **Incoming call settings**, you'll see **Our SIP address** – the same address you entered as the DIDWW **SIP Endpoint Hostname** in **Step 1**.
4. Click **Add SIP number**.

<img src="https://mintcdn.com/famulor/bEgpS1VdTsHHB0ze/images/famulor_sip_number_integrate.png?fit=max&auto=format&n=bEgpS1VdTsHHB0ze&q=85&s=90ad8f7abe045612e62039f36bee931c" alt="Famulor: „Integrate SIP trunk“ dialog with authentication, outbound SIP address and the „Our SIP address“ field for incoming calls" width="634" height="745" data-path="images/famulor_sip_number_integrate.png" />

***

## Step 5: Assign an assistant and test

1. Open **Assistants** in Famulor and edit the assistant you want to use.
2. Select the correct **inbound type** (incoming calls).
3. Choose your connected DIDWW phone number from the list.
4. Click **Save assistant**.
5. Place a **test call** to your DIDWW number and check that the AI assistant answers.

***

## Common issues

<AccordionGroup>
  <Accordion title="Inbound calls do not arrive" icon="phone-slash">
    Check the **inbound trunk** (Step 1): the **SIP Endpoint Hostname** must be the **exact** „Our SIP address" from Famulor. Make sure the **DID is assigned to the inbound trunk** (Step 2).
  </Accordion>

  <Accordion title="Outbound calls fail" icon="arrow-up-right-from-square">
    Check the **SIP address** in Famulor (`out.didww.com`), the outbound trunk **Username** and **Password**. Make sure the **fixed outbound IP** is enabled in Famulor and exactly that IP (`34.195.177.252/32`) is allowed in the DIDWW outbound trunk under **Allowed SIP IP addresses**.
  </Accordion>

  <Accordion title="Outbound calls rejected (number format)" icon="hashtag">
    DIDWW expects outbound numbers in **E.164 without `+`** (e.g. `18489005419`). Set the format in Famulor to **International (without leading +)**.
  </Accordion>

  <Accordion title="Wrong or unknown SIP address" icon="server">
    Always use the **exact** „Our SIP address" from Famulor (Phone numbers → Integrate SIP trunk → Incoming call settings).
  </Accordion>
</AccordionGroup>

***

## Help

<Tip>
  If you need help, contact our support team at [support@famulor.io](mailto:support@famulor.io). For general guidance, see [SIP Integration](/en/provisioning/sip-ai/sip-integration) and [SIP integration issues](/en/troubleshooting/sip-integration-issues).
</Tip>