From b90e50be84ac1a151979d1bbe3411e92850698d2 Mon Sep 17 00:00:00 2001 From: Semyon Zherebilov <237176124+simon-didlogic@users.noreply.github.com> Date: Tue, 4 Aug 2026 11:55:27 +0500 Subject: [PATCH 1/5] Create sip-didlogic.mdx --- fern/advanced/sip/sip-didlogic.mdx | 87 ++++++++++++++++++++++++++++++ 1 file changed, 87 insertions(+) create mode 100644 fern/advanced/sip/sip-didlogic.mdx diff --git a/fern/advanced/sip/sip-didlogic.mdx b/fern/advanced/sip/sip-didlogic.mdx new file mode 100644 index 000000000..cb3082b0d --- /dev/null +++ b/fern/advanced/sip/sip-didlogic.mdx @@ -0,0 +1,87 @@ +--- +title: "didlogic SIP Integration" +description: "How to integrate your didlogic SIP trunks and phone numbers with Vapi AI Voice Agents" +slug: advanced/sip/didlogic +--- + +## Overview + +For a general introduction to SIP trunking with Vapi (concepts and architecture), see our [SIP Trunking Guide](../sip-trunk.mdx). + +To connect didlogic with Vapi, you will set up a two-way SIP connection: +1. **Outbound Calls (Vapi → didlogic):** Vapi sends call requests to didlogic via SIP Trunking. +2. **Inbound Calls (didlogic → Vapi):** didlogic routes incoming calls on your purchased numbers to Vapi's SIP URI. + +--- + +## Prerequisites + +Before getting started, make sure you have: +* An active [didlogic account](https://didlogic.com/get-started?utm_source=vapi_docs) with a positive balance. +* At least one purchased phone number in your didlogic dashboard. +* An active SIP account in your didlogic dashboard. +* A **Vapi** account with access to the Dashboard. + +--- + +## Get Started + +### Step 1: Configure Outbound Trunking in Vapi + +To allow your Vapi agents to place outbound calls through didlogic: + +1. Log in to your **Vapi Dashboard** and navigate to **Phone Numbers** (or **SIP Trunking**). +2. Click **Create Provider** and select **Custom SIP**. +3. Fill in your didlogic SIP Trunk credentials: + * **Outbound SIP Gateway:** `sip.didlogic.com` (or your assigned regional gateway) + * **Username:** Your didlogic SIP Username + * **Password:** Your didlogic SIP Password + * **Auth Realm / Domain:** `didlogic.com` +4. Save the provider configuration. + + + **IP Authentication:** If your didlogic account uses IP-based authentication instead of Digest (User/Pass), add Vapi's outbound IP addresses to your ACL inside the didlogic Portal. + + +--- + +### Step 2: Configure Inbound Call Routing in didlogic + +To route incoming calls on your didlogic numbers to a Vapi agent: + +1. Log in to the **didlogic Customer Portal**. +2. Navigate to **Purchased Numbers** (or **Numbers** section). +3. Find the phone number you want to assign to Vapi and click **Edit / Actions**. +4. Set the **Destination Type** to `SIP URI`. +5. Enter your Vapi Inbound SIP URI target: + ```text + sip:YOUR_VAPI_PHONE_NUMBER_OR_AGENT_ID@sip.vapi.ai +6. Click Save Changes. + +### Step 3: Test the Integration + +**Outbound Test** + 1. In Vapi, select an agent assigned to your newly created didlogic SIP Trunk. + 2. Trigger a test call to your personal phone number. + 3. Verify that the call connects and caller ID displays correctly. + +**Inbound Test** + 1. Dial your didlogic phone number from an external phone. + 2. Ensure Vapi receives the call and your configured AI agent answers immediately. + +## Troubleshooting + +**No audio / One-way audio** +* Ensure WebRTC and SIP ports are open if you are using custom firewalls. +* Verify that standard audio codecs (G.711u / G.711a) are enabled on both ends. + +**Inbound calls fail (404 Not Found / 403 Forbidden)** +* Double-check the SIP URI format in the didlogic destination field. +* Verify that the Vapi Phone Number / Agent ID is correctly provisioned in your Vapi workspace. + + +**Need Support?** +If you encounter issues during setup: +• Reach out to didlogic Support via the ticket portal. +• Check Vapi Documentation for platform-specific agent configurations. + From 63d44ac3a33718ba13eb259d188dd7d09245918a Mon Sep 17 00:00:00 2001 From: Semyon Zherebilov <237176124+simon-didlogic@users.noreply.github.com> Date: Tue, 4 Aug 2026 11:56:17 +0500 Subject: [PATCH 2/5] Update sip-didlogic.mdx --- fern/advanced/sip/sip-didlogic.mdx | 6 ------ 1 file changed, 6 deletions(-) diff --git a/fern/advanced/sip/sip-didlogic.mdx b/fern/advanced/sip/sip-didlogic.mdx index cb3082b0d..cf8724d7e 100644 --- a/fern/advanced/sip/sip-didlogic.mdx +++ b/fern/advanced/sip/sip-didlogic.mdx @@ -12,8 +12,6 @@ To connect didlogic with Vapi, you will set up a two-way SIP connection: 1. **Outbound Calls (Vapi → didlogic):** Vapi sends call requests to didlogic via SIP Trunking. 2. **Inbound Calls (didlogic → Vapi):** didlogic routes incoming calls on your purchased numbers to Vapi's SIP URI. ---- - ## Prerequisites Before getting started, make sure you have: @@ -22,8 +20,6 @@ Before getting started, make sure you have: * An active SIP account in your didlogic dashboard. * A **Vapi** account with access to the Dashboard. ---- - ## Get Started ### Step 1: Configure Outbound Trunking in Vapi @@ -43,8 +39,6 @@ To allow your Vapi agents to place outbound calls through didlogic: **IP Authentication:** If your didlogic account uses IP-based authentication instead of Digest (User/Pass), add Vapi's outbound IP addresses to your ACL inside the didlogic Portal. ---- - ### Step 2: Configure Inbound Call Routing in didlogic To route incoming calls on your didlogic numbers to a Vapi agent: From acdcb8e1d24e93e6fce4c0e2bffd90682ac2cd7e Mon Sep 17 00:00:00 2001 From: Semyon Zherebilov <237176124+simon-didlogic@users.noreply.github.com> Date: Tue, 4 Aug 2026 12:28:34 +0500 Subject: [PATCH 3/5] Update sip-didlogic.mdx --- fern/advanced/sip/sip-didlogic.mdx | 53 ++++++++++++++++-------------- 1 file changed, 28 insertions(+), 25 deletions(-) diff --git a/fern/advanced/sip/sip-didlogic.mdx b/fern/advanced/sip/sip-didlogic.mdx index cf8724d7e..6599b2fea 100644 --- a/fern/advanced/sip/sip-didlogic.mdx +++ b/fern/advanced/sip/sip-didlogic.mdx @@ -22,35 +22,34 @@ Before getting started, make sure you have: ## Get Started -### Step 1: Configure Outbound Trunking in Vapi +### Step 1: Configure Outbound Trunking & Import didlogic Numbers to Vapi To allow your Vapi agents to place outbound calls through didlogic: -1. Log in to your **Vapi Dashboard** and navigate to **Phone Numbers** (or **SIP Trunking**). -2. Click **Create Provider** and select **Custom SIP**. +1. Log in to your **Vapi Dashboard** and navigate to **Integrations**. +2. Find the **Phone Number Providers** section and select **SIP Trunk → Configure New SIP Trunk**. 3. Fill in your didlogic SIP Trunk credentials: - * **Outbound SIP Gateway:** `sip.didlogic.com` (or your assigned regional gateway) - * **Username:** Your didlogic SIP Username + * **Outbound SIP Gateway:** `sip.nl.didlogic.net` ([full list of regional gateways](https://docs.didlogic.com/docs/guides/getting-started/outbound-calling#our-sip-gateways)) + * **Username:** Your 5-digit didlogic SIP Username * **Password:** Your didlogic SIP Password - * **Auth Realm / Domain:** `didlogic.com` -4. Save the provider configuration. - - - **IP Authentication:** If your didlogic account uses IP-based authentication instead of Digest (User/Pass), add Vapi's outbound IP addresses to your ACL inside the didlogic Portal. - +4. Save the configuration. +5. Go to [Phone Numbers](https://dashboard.vapi.ai/phone-numbers) → Create Phone Number → BYO SIP Trunk Number. +6. Enter your didlogic number and select your didlogic SIP trunk in the **SIP Trunk Credential** dropdown. Then, save changes. ### Step 2: Configure Inbound Call Routing in didlogic To route incoming calls on your didlogic numbers to a Vapi agent: -1. Log in to the **didlogic Customer Portal**. -2. Navigate to **Purchased Numbers** (or **Numbers** section). -3. Find the phone number you want to assign to Vapi and click **Edit / Actions**. +1. Go to [Vapi API keys](https://dashboard.vapi.ai/org/api-keys) and copy your **Private Key**. +2. Log in to the [didlogic Customer Portal](https://app.didlogic.com). +3. Navigate to **Purchased**. +4. Find the phone number you want to assign to Vapi and click **Edit** in the Destination block. 4. Set the **Destination Type** to `SIP URI`. 5. Enter your Vapi Inbound SIP URI target: ```text - sip:YOUR_VAPI_PHONE_NUMBER_OR_AGENT_ID@sip.vapi.ai -6. Click Save Changes. + YOUR_PHONE_NUMBER@VAPI_PRIVATE_KEY.sip.vapi.ai + e.g. 31203691111@123a-456b-789c.sip.vapi.ai +6. Click Add. ### Step 3: Test the Integration @@ -63,19 +62,23 @@ To route incoming calls on your didlogic numbers to a Vapi agent: 1. Dial your didlogic phone number from an external phone. 2. Ensure Vapi receives the call and your configured AI agent answers immediately. -## Troubleshooting +### Step 4: Configure SIP REFER -**No audio / One-way audio** -* Ensure WebRTC and SIP ports are open if you are using custom firewalls. -* Verify that standard audio codecs (G.711u / G.711a) are enabled on both ends. +To enable the "Transfer to Human" feature, SIP REFER should be set up in Vapi. -**Inbound calls fail (404 Not Found / 403 Forbidden)** -* Double-check the SIP URI format in the didlogic destination field. -* Verify that the Vapi Phone Number / Agent ID is correctly provisioned in your Vapi workspace. + +* SIP REFER must be activated for your didlogic account. Contact your account manager to enable SIP REFER before proceeding with the configuration. +* Transferring is technically possible to your other didlogic numbers only. Set up the correct routing for the number that you use for referring. + - +1. Create the **Transfer Call** tool. +2. Navigate to Destinations → Add destination → Phone Number. +3. Enter the target phone number and an optional message for the customer. +4. Save changes. + + **Need Support?** If you encounter issues during setup: • Reach out to didlogic Support via the ticket portal. • Check Vapi Documentation for platform-specific agent configurations. - + From c0c1e704c2702ca3d951631459cbcae5fcadea3c Mon Sep 17 00:00:00 2001 From: Semyon Zherebilov <237176124+simon-didlogic@users.noreply.github.com> Date: Tue, 4 Aug 2026 12:30:47 +0500 Subject: [PATCH 4/5] Update sip-didlogic.mdx --- fern/advanced/sip/sip-didlogic.mdx | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/fern/advanced/sip/sip-didlogic.mdx b/fern/advanced/sip/sip-didlogic.mdx index 6599b2fea..f78489c58 100644 --- a/fern/advanced/sip/sip-didlogic.mdx +++ b/fern/advanced/sip/sip-didlogic.mdx @@ -46,9 +46,8 @@ To route incoming calls on your didlogic numbers to a Vapi agent: 4. Find the phone number you want to assign to Vapi and click **Edit** in the Destination block. 4. Set the **Destination Type** to `SIP URI`. 5. Enter your Vapi Inbound SIP URI target: - ```text - YOUR_PHONE_NUMBER@VAPI_PRIVATE_KEY.sip.vapi.ai - e.g. 31203691111@123a-456b-789c.sip.vapi.ai + ```code + YOUR_PHONE_NUMBER@VAPI_PRIVATE_KEY.sip.vapi.ai // e.g. 31203691111@123a-456b-789c.sip.vapi.ai 6. Click Add. ### Step 3: Test the Integration From 4439b95793ae8f4418c032e6bcee36223aafa027 Mon Sep 17 00:00:00 2001 From: Semyon Zherebilov <237176124+simon-didlogic@users.noreply.github.com> Date: Tue, 4 Aug 2026 12:33:47 +0500 Subject: [PATCH 5/5] Update sip-didlogic.mdx --- fern/advanced/sip/sip-didlogic.mdx | 19 ++++++------------- 1 file changed, 6 insertions(+), 13 deletions(-) diff --git a/fern/advanced/sip/sip-didlogic.mdx b/fern/advanced/sip/sip-didlogic.mdx index f78489c58..6e27cd126 100644 --- a/fern/advanced/sip/sip-didlogic.mdx +++ b/fern/advanced/sip/sip-didlogic.mdx @@ -53,15 +53,15 @@ To route incoming calls on your didlogic numbers to a Vapi agent: ### Step 3: Test the Integration **Outbound Test** - 1. In Vapi, select an agent assigned to your newly created didlogic SIP Trunk. - 2. Trigger a test call to your personal phone number. - 3. Verify that the call connects and caller ID displays correctly. +1. In Vapi, select an agent assigned to your newly created didlogic SIP Trunk. +2. Trigger a test call to your personal phone number. +3. Verify that the call connects and the caller ID displays correctly. **Inbound Test** - 1. Dial your didlogic phone number from an external phone. - 2. Ensure Vapi receives the call and your configured AI agent answers immediately. +1. Dial your didlogic phone number from an external phone. +2. Ensure Vapi receives the call and your configured AI agent answers immediately. -### Step 4: Configure SIP REFER +### Step 4: Configure SIP REFER (Optional) To enable the "Transfer to Human" feature, SIP REFER should be set up in Vapi. @@ -74,10 +74,3 @@ To enable the "Transfer to Human" feature, SIP REFER should be set up in Vapi. 2. Navigate to Destinations → Add destination → Phone Number. 3. Enter the target phone number and an optional message for the customer. 4. Save changes. - - -**Need Support?** -If you encounter issues during setup: -• Reach out to didlogic Support via the ticket portal. -• Check Vapi Documentation for platform-specific agent configurations. -