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

# DIDLogic Integration

> A step by step guide to connect your DIDLogic account via SIP trunking

<Steps titleSize="h2">
  <Step title="Purchase a Phone Number">
    Log in to your DIDLogic dashboard at [app.didlogic.com](https://app.didlogic.com) and go to the **BUY** tab. Search by country and area code, add a number to your cart, and complete checkout. Your new number will appear under the **PURCHASED** tab.

    <Frame>
      <img src="https://mintcdn.com/soara/xaRpCIO4ZAVD2ByS/resources/did-logic/didlogic-buy-number.png?fit=max&auto=format&n=xaRpCIO4ZAVD2ByS&q=85&s=159c94772a9031513c204c225f3486ec" alt="DIDLogic BUY tab with country search" width="1201" height="815" data-path="resources/did-logic/didlogic-buy-number.png" />
    </Frame>
  </Step>

  <Step title="Configure Your SIP Account (Outbound)">
    Go to the **SIP** tab and click **Edit** on your SIP account.

    <Frame>
      <img src="https://mintcdn.com/soara/xaRpCIO4ZAVD2ByS/resources/did-logic/didlogic-sip-tab.png?fit=max&auto=format&n=xaRpCIO4ZAVD2ByS&q=85&s=3685bf9c715c79f7a0ea5ae668ab1047" alt="DIDLogic SIP tab showing accounts list" width="1071" height="632" data-path="resources/did-logic/didlogic-sip-tab.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/soara/xaRpCIO4ZAVD2ByS/resources/did-logic/didlogic-sip-edit.png?fit=max&auto=format&n=xaRpCIO4ZAVD2ByS&q=85&s=7e5786bb72a4b84f06d303cd7bef31de" alt="DIDLogic Edit SIP account" width="1080" height="630" data-path="resources/did-logic/didlogic-sip-edit.png" />
    </Frame>

    Note the **SIP account number** (e.g., `12345`) — this is your **username** that you will use in Soara. Set a password in both the **Password** and **Confirm Password** fields — you will use this same password when importing the number to Soara.

    <Frame>
      <img src="https://mintcdn.com/soara/xaRpCIO4ZAVD2ByS/resources/did-logic/didlogic-sip-password.png?fit=max&auto=format&n=xaRpCIO4ZAVD2ByS&q=85&s=470c48b8a23f13ff586fd47eb4f6f6f2" alt="DIDLogic SIP password fields" width="1052" height="949" data-path="resources/did-logic/didlogic-sip-password.png" />
    </Frame>

    Enable **"Restrict to authorized IPs"** and add the IP address `34.195.177.252`, then click **Add** and **Update**.

    <Frame>
      <img src="https://mintcdn.com/soara/xaRpCIO4ZAVD2ByS/resources/did-logic/didlogic-sip-restrict-ip.png?fit=max&auto=format&n=xaRpCIO4ZAVD2ByS&q=85&s=4dd79c249ab6786c011c78fd074be3eb" alt="DIDLogic Restrict to authorized IPs with 34.195.177.252 added" width="1022" height="811" data-path="resources/did-logic/didlogic-sip-restrict-ip.png" />
    </Frame>

    Scroll down to find your region and copy the **SIP URI** from the regional gateway list. You will need this for the outbound settings in Soara.

    <Frame>
      <img src="https://mintcdn.com/soara/xaRpCIO4ZAVD2ByS/resources/did-logic/didlogic-sip-region.png?fit=max&auto=format&n=xaRpCIO4ZAVD2ByS&q=85&s=f0347c739d457c0e0254de532bb807f9" alt="DIDLogic regional SIP URI selection" width="972" height="779" data-path="resources/did-logic/didlogic-sip-region.png" />
    </Frame>
  </Step>

  <Step title="Configure Inbound Routing (in DIDLogic)">
    Go to the **PURCHASED** tab and click **Destination** next to your phone number.

    <Frame>
      <img src="https://mintcdn.com/soara/xaRpCIO4ZAVD2ByS/resources/did-logic/didlogic-purchased-tab.png?fit=max&auto=format&n=xaRpCIO4ZAVD2ByS&q=85&s=16e8ce10d458679b773040f882d3cffc" alt="DIDLogic Purchased numbers list" width="1158" height="775" data-path="resources/did-logic/didlogic-purchased-tab.png" />
    </Frame>

    Delete any existing destination, then change the selector from "SIP device" to **"SIP URI"**.

    <Frame>
      <img src="https://mintcdn.com/soara/xaRpCIO4ZAVD2ByS/resources/did-logic/didlogic-destination-select.png?fit=max&auto=format&n=xaRpCIO4ZAVD2ByS&q=85&s=5b5e08c2196104d834af4904671198a9" alt="DIDLogic selecting SIP URI type" width="872" height="342" data-path="resources/did-logic/didlogic-destination-select.png" />
    </Frame>

    Enter the SIP URI in the following format:

    ```
    <number_without_plus>@5wed79aeavr.sip.livekit.cloud
    ```

    For example, if your number is `+15551234567`, enter:

    ```
    15551234567@5wed79aeavr.sip.livekit.cloud
    ```

    Click **Add**.
  </Step>

  <Step title="Import Number to Soara">
    Go to your Soara dashboard → **Your Phone Numbers** → **"Integrate SIP trunk"** and fill in your details:

    ```
    Phone number: Your DIDLogic number in E.164 format (e.g., +15551234567)
    Username: The SIP account number from Step 2 (e.g., 12345)
    Password: The password you set in Step 2
    ```

    <Frame>
      <img src="https://mintcdn.com/soara/xaRpCIO4ZAVD2ByS/resources/did-logic/sip-integration-sip-type.png?fit=max&auto=format&n=xaRpCIO4ZAVD2ByS&q=85&s=413bc3014c88cb6c5b851bb0cf239414" alt="Fill in SIP integration details" width="1047" height="499" data-path="resources/did-logic/sip-integration-sip-type.png" />
    </Frame>

    Under **Outbound settings**, paste the regional SIP URI you copied in Step 2. Set **Number format** to **"International with + in front"** and enable **"Outbound call will come from a fixed IP address"**.

    <Frame>
      <img src="https://mintcdn.com/soara/xaRpCIO4ZAVD2ByS/resources/did-logic/sip-integration-outbound.png?fit=max&auto=format&n=xaRpCIO4ZAVD2ByS&q=85&s=34949e4741f8cc38f9dfd9ccd99fe206" alt="Outbound SIP settings" width="1041" height="363" data-path="resources/did-logic/sip-integration-outbound.png" />
    </Frame>

    Under **Inbound settings**, select **"IP Address"** as the authorization type. Add the IP address of your chosen DIDLogic regional gateway from the table below:

    | Gateway              | IP Address      |
    | -------------------- | --------------- |
    | sip.nl.didlogic.net  | 89.149.192.7    |
    | sip.uk.didlogic.net  | 23.19.63.1      |
    | sip.se.didlogic.net  | 5.150.254.205   |
    | sip.de.didlogic.net  | 157.230.96.24   |
    | sip.fr.didlogic.net  | 159.8.84.235    |
    | sip.hk.didlogic.net  | 188.42.84.76    |
    | sip.sg.didlogic.net  | 188.42.84.76    |
    | sip.au.didlogic.net  | 119.9.12.222    |
    | sip.nz.didlogic.net  | 131.203.181.17  |
    | sip.ir.didlogic.net  | 161.202.135.82  |
    | sip.ca.didlogic.net  | 138.197.143.154 |
    | sip.lax.didlogic.net | 185.118.62.77   |
    | sip.nyc.didlogic.net | 192.241.183.87  |
    | sip.za.didlogic.net  | 102.130.116.205 |
    | sip.br.didlogic.net  | 169.57.132.146  |

    <Frame>
      <img src="https://mintcdn.com/soara/xaRpCIO4ZAVD2ByS/resources/did-logic/sip-integration-inbound.png?fit=max&auto=format&n=xaRpCIO4ZAVD2ByS&q=85&s=fc16392d76fb2af6a40eb4e70c1247bf" alt="Inbound SIP settings" width="1053" height="808" data-path="resources/did-logic/sip-integration-inbound.png" />
    </Frame>

    Select the **Country** where your SIP trunk is located.

    <Frame>
      <img src="https://mintcdn.com/soara/xaRpCIO4ZAVD2ByS/resources/did-logic/sip-integration-country.png?fit=max&auto=format&n=xaRpCIO4ZAVD2ByS&q=85&s=44036cbaa0259e8634e5620aa0c6bd7a" alt="SIP country selection" width="1050" height="158" data-path="resources/did-logic/sip-integration-country.png" />
    </Frame>
  </Step>

  <Step title="Verify Setup">
    Make a test call to your number to verify inbound calling, then use the test call feature to verify outbound calling.
  </Step>
</Steps>

## Security Requirements

<Warning>
  Your SIP credentials need to be secure. Your password must have at least 12 characters, include numbers, upper and lowercase letters, and special characters are recommended.
</Warning>

## Common Issues

<AccordionGroup>
  <Accordion title="Outbound calls not working?">
    * **Verify the SIP URI** — Make sure you copied the correct regional SIP URI from Step 2. Remove any trailing spaces.
    * **Check your username** — The username is the numeric SIP account number (e.g., `12345`), not your email address or account name.
    * **Check your password** — Ensure the password in Soara matches exactly what you set in the DIDLogic SIP account settings.
    * **Verify IP whitelist** — Make sure `34.195.177.252` is added to the authorized IPs in your DIDLogic SIP account.
  </Accordion>

  <Accordion title="Inbound calls not working?">
    * **Verify the SIP URI destination** — In DIDLogic, make sure the destination is set to SIP URI (not SIP device) and the format is correct: `<number_without_plus>@5wed79aeavr.sip.livekit.cloud`
    * **Check the IP whitelist in Soara** — Make sure the IP address you added in the Soara inbound settings matches the regional gateway you are using. Refer to the gateway IP table in Step 4.
  </Accordion>
</AccordionGroup>

***

<Note>
  Need help setting up? Our support team specializes in helping customers
  integrate their phone systems. We'll guide you through the entire process,
  ensuring a smooth setup with your specific phone system configuration.
</Note>
