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

# Zadarma Integration

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

## Step 1: Gather Your Information

* PBX Extension:

Go to My Switchboard, Extensions on the main page.

<Frame>
  <img src="https://mintcdn.com/d10/6SIUMuH2FfUyo1bA/resources/zadarma-mypbx-extensions.png?fit=max&auto=format&n=6SIUMuH2FfUyo1bA&q=85&s=29beb1f62ce5ec07203b0de231d7be7f" alt="Zadarma My Switchboard Extensions" width="940" height="325" data-path="resources/zadarma-mypbx-extensions.png" />
</Frame>

Find the following information:

```
Extension number: e.g., 1000
Server address: e.g., pbx.zadarma.com
Username: Your extension username
Password: Your extension password
```

<Frame>
  <img src="https://mintcdn.com/d10/6SIUMuH2FfUyo1bA/resources/zadarma-switch-extension-settings.PNG?fit=max&auto=format&n=6SIUMuH2FfUyo1bA&q=85&s=f9c2e270e5513a92fc22f6d20149dff5" alt="Zadarma My Switchboard Extensions Settings" width="586" height="782" data-path="resources/zadarma-switch-extension-settings.PNG" />
</Frame>

* SIP Connection:

```
Phone number: e.g., +1 555 0123
SIP server: e.g., sip.zadarma.com
Username: Provided by your phone company
Password: Provided by your phone company
```

Go to Configuration, SIP Settings on the main page.

<Frame>
  <img src="https://mintcdn.com/d10/6SIUMuH2FfUyo1bA/resources/zadarma-sip-settings.png?fit=max&auto=format&n=6SIUMuH2FfUyo1bA&q=85&s=65371ed825d946a5d70ea71e45c0ebcb" alt="Zadarma SIP Settings" width="936" height="313" data-path="resources/zadarma-sip-settings.png" />
</Frame>

Find the following information:

<Frame>
  <img src="https://mintcdn.com/d10/6SIUMuH2FfUyo1bA/resources/zadarma-sip-connection-settings.png?fit=max&auto=format&n=6SIUMuH2FfUyo1bA&q=85&s=bf8bd72ce0504017b54ea060b0d8d293" alt="Zadarma SIP Connection Settings" width="624" height="687" data-path="resources/zadarma-sip-connection-settings.png" />
</Frame>

* For **IP Authorization type**:

1. Go to Services, Connect number on the main page.
   <Frame>
     <img src="https://mintcdn.com/d10/6SIUMuH2FfUyo1bA/resources/zadarma-services.png?fit=max&auto=format&n=6SIUMuH2FfUyo1bA&q=85&s=38f99ee6d2c163d015152b099022cca6" alt="Zadarma Services" width="627" height="329" data-path="resources/zadarma-services.png" />
   </Frame>

2. Go to Active numbers.
   <Frame>
     <img src="https://mintcdn.com/d10/AYRWrK42kgiNO6cg/resources/zadarma-active-numbers.png?fit=max&auto=format&n=AYRWrK42kgiNO6cg&q=85&s=9ea675ba5cee778d857f37195a3a707c" alt="Zadarma Active Numbers" width="675" height="534" data-path="resources/zadarma-active-numbers.png" />
   </Frame>

3. Click on the number you want to connect and press settings button.
   <Frame>
     <img src="https://mintcdn.com/d10/6SIUMuH2FfUyo1bA/resources/zadarma-settings-button.png?fit=max&auto=format&n=6SIUMuH2FfUyo1bA&q=85&s=4cce3cedcb11a9ecf3fad9d546c6493e" alt="Zadarma Settings Button" width="1034" height="533" data-path="resources/zadarma-settings-button.png" />
   </Frame>

4. Click on external services and then check the option for SIP URI.

Add `sip:extension@5wed79aeavr.sip.livekit.cloud ` (this is sondos-ai SIP server address) .

<Frame>
  <img src="https://mintcdn.com/d10/AYRWrK42kgiNO6cg/resources/zadarma-external-services.png?fit=max&auto=format&n=AYRWrK42kgiNO6cg&q=85&s=e968beb0aa6582f6899a39857e6101de" alt="Zadarma External Services" width="584" height="664" data-path="resources/zadarma-external-services.png" />
</Frame>

<Note>
  You will need these IPs which you will put in step 2 for inbound authorization type.
</Note>

## Step 2: Import numbers to sondos-ai

You need to import to sondos-ai.

1. Go to your sondos-ai.com dashboard
2. Navigate to **Your Phone Numbers**
3. Click “Integrate SIP trunk”

   <Frame>
     <img src="https://mintlify.s3.us-west-1.amazonaws.com/d10/resources/twillio-import-sondos-ai-sip1.png" alt="Import numbers to sondos-ai" />
   </Frame>
4. Fill in your details based on your integration type

For PBX Extension:

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/d10/resources/zadarma-sondos-ai-type.png" alt="Fill in your details based on your integration type" />
</Frame>

For SIP Connection:

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/d10/resources/twillio-sondos-ai-auth-integration.png" alt="Fill in your details based on your integration type" />
</Frame>

5. Here you will supply the termination SIP URI you set up in Step 1.

```
Server address: e.g., pbx.zadarma.com / sip.zadarma.com based on your integration type
```

<Frame>
  <img src="https://mintcdn.com/d10/6SIUMuH2FfUyo1bA/resources/zadarma-outbound-settings.png?fit=max&auto=format&n=6SIUMuH2FfUyo1bA&q=85&s=481cce1fac03862d4583922815a7502d" alt="Zadarma Outbound Settings" width="1114" height="349" data-path="resources/zadarma-outbound-settings.png" />
</Frame>

6. Here select Authorization type.

* Add the **IPs** from **Zadarma** (Step 1).

  <Frame>
    <img src="https://mintcdn.com/d10/6SIUMuH2FfUyo1bA/resources/zadarma-ip-inbound.png?fit=max&auto=format&n=6SIUMuH2FfUyo1bA&q=85&s=6bb9a29968b2c4dc849811da2bf275c6" alt="Twillio sondos-ai Credentials IP Type" width="1117" height="467" data-path="resources/zadarma-ip-inbound.png" />
  </Frame>

7. Select the country of where your SIP trunk is located.

   <Frame>
     <img src="https://mintlify.s3.us-west-1.amazonaws.com/d10/resources/twillio-sondos-ai-sip-country.png" alt="Twillio sondos-ai SIP Country" />
   </Frame>

### Step 3: Verify Setup

After configuration:

1. Make a test call to your number/extension
2. Check that the AI assistant answers
3. Use the test call feature to verify outbound calling

## Security Requirements

Your SIP credentials need to be secure:

* **Username**: Your extension number or provider-supplied username
* **Password must have**:
  * 12 or more characters
  * Numbers
  * Upper and lowercase letters
  * Special characters recommended

## Common Issues

<AccordionGroup>
  <Accordion title="After connecting, inbound works but outbound does not work?">
    * Check your Termination SIP URI If there’s a space in it, please remove. Also you should use a localized termination uri that’s near your region. Check out this [doc](https://www.twilio.com/docs/global-infrastructure/localized-uris/termination) to select one.
    * Check your user name and credentials Please make sure you entered the right user name and credentials which shows in this dialog. Please note the user name is not the friendly name that shows in the credential list. The friendly is different to user name, you need to double check if you happen to give a different name.

    <Frame>
      <img src="https://mintcdn.com/d10/AYRWrK42kgiNO6cg/resources/twillio-outbound-not-work.png?fit=max&auto=format&n=AYRWrK42kgiNO6cg&q=85&s=c42e078c77095e229c9058ba538c707d" alt="Twillio outbound not work" width="2692" height="1166" data-path="resources/twillio-outbound-not-work.png" />
    </Frame>
  </Accordion>

  {" "}

  <Accordion title="How do I set up dialing to international countries?">
    * Search “geo” to find the “Voice Geographic Permissions” setting.
          <Frame>
            <img src="https://mintcdn.com/d10/AYRWrK42kgiNO6cg/resources/twillio-setup-dialing-international.png?fit=max&auto=format&n=AYRWrK42kgiNO6cg&q=85&s=8cdbb50d541cd9ef564b0aa352d4ceff" alt="Twillio setup dialing international" width="2136" height="1428" data-path="resources/twillio-setup-dialing-international.png" />
          </Frame>
    * Choose “Elastic Sip Trunking” in selector, and select the countries you would like to dial.
          <Frame>
            <img src="https://mintcdn.com/d10/AYRWrK42kgiNO6cg/resources/twillio-choose-elastic-sip-trunking.png?fit=max&auto=format&n=AYRWrK42kgiNO6cg&q=85&s=f685ad71f6ac42a5f09861fb87e01b17" alt="Twillio setup dialing international" width="3440" height="1614" data-path="resources/twillio-choose-elastic-sip-trunking.png" />
          </Frame>
  </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>
