> ## 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.

# Zadarma Integration

> Connect your Zadarma account to Famulor via SIP Trunking

<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>

# Zadarma Integration

<Note>
  A step-by-step guide to connecting your Zadarma account to Famulor via SIP Trunking
</Note>

<Note>
  **Phone number import (BYOC):** Open **Your Phone Numbers → Integrate SIP trunk** in the Famulor dashboard. The wizard lists **Twilio**, **Telnyx**, **Zadarma**, and **DIDLogic**. **Import number** creates what you need on Famulor’s side and imports your numbers from the carrier once your account is linked—you do not need to fill every SIP field by hand. Use **Import number**, or **follow this guide below** for full manual setup. Overview: [SIP Integration](/en/provisioning/sip-ai/sip-integration). The steps below document **manual Zadarma** SIP trunking.
</Note>

<Frame>
  <img src="https://mintcdn.com/famulor/aI-S6C6l9kbXRKqz/images/import-numbers.png?fit=max&auto=format&n=aI-S6C6l9kbXRKqz&q=85&s=46d827f248c10f86168797a3768b5e4b" alt="Famulor BYOC wizard: choose Twilio, Telnyx, Zadarma, or DIDLogic, then import numbers from your carrier" width="3682" height="2606" data-path="images/import-numbers.png" />
</Frame>

<Info>
  **Pricing snapshot:** Zadarma publishes public virtual-number pricing by country. Outbound calling depends on your selected price plan and the live tariff table.

  * **Inbound / number rental examples:** Germany `EUR 4/month` + `EUR 2` connection, Switzerland `EUR 4/month`, United Kingdom `EUR 4/month`, United States `EUR 3.2/month`
  * **Outbound / calling:** Live pay-as-you-go rates vary by plan and destination; incoming calls to purchased numbers are generally free except toll-free numbers
  * **Official pricing:** [Zadarma number rates](https://zadarma.com/en/tariffs/numbers/) and [Zadarma call rates](https://zadarma.com/en/tariffs/calls/)
</Info>

<CardGroup cols={2}>
  <Card title="What is Zadarma Integration?" icon="phone-volume" color="blue">
    Connect your Zadarma phone system to Famulor via SIP Trunking for flexible and scalable telephony integration.
  </Card>

  <Card title="Benefits" icon="star" color="green">
    Leverage Zadarma’s robust infrastructure, global reach, and competitive rates alongside our AI assistants.
  </Card>
</CardGroup>

## What is Zadarma Integration?

Zadarma integration allows you to connect your Zadarma phone system with Famulor. Zadarma offers flexible SIP Trunking solutions for telephony integration.

<Steps>
  <Step title="Use Existing Numbers">
    Use your existing Zadarma phone numbers with our AI assistants
  </Step>

  <Step title="Maintain Infrastructure">
    Keep Zadarma’s robust infrastructure and global reach
  </Step>

  <Step title="Manage Calls">
    Make and receive calls through your Zadarma setup
  </Step>

  <Step title="Retain Control">
    Maintain full control over your numbers
  </Step>

  <Step title="Save Costs">
    Benefit from Zadarma’s competitive rates and regional endpoints
  </Step>
</Steps>

## How It Works

When you integrate your Zadarma system with Famulor:

<CardGroup cols={2}>
  <Card title="Incoming Calls" icon="phone" color="green">
    Calls to your Zadarma numbers are forwarded via SIP Trunking to our AI assistants
  </Card>

  <Card title="Outgoing Calls" icon="phone" color="blue">
    Our AI assistants can make calls that appear to come from your Zadarma numbers
  </Card>

  <Card title="Management" icon="gear" color="purple">
    You continue managing your numbers via the Zadarma dashboard
  </Card>

  <Card title="Cost Efficiency" icon="dollar-sign" color="orange">
    Take advantage of Zadarma’s competitive rates and regional endpoints
  </Card>
</CardGroup>

## Setting Up Your Zadarma Integration

<Steps>
  <Step title="Gather Information">
    <CardGroup cols={2}>
      <Card title="PBX Extension" icon="phone" color="blue">
        **Navigate to "My PBX" → "Extensions" on the main page.**

        <img src="https://mintcdn.com/famulor/BJIaHBogIb3VOn7S/images/provisioning/sip-ai/zadarma-mypbx-extensions.png?fit=max&auto=format&n=BJIaHBogIb3VOn7S&q=85&s=844ce666c6c4000607265667ef8e8fe8" alt="Zadarma My PBX Extensions" width="940" height="325" data-path="images/provisioning/sip-ai/zadarma-mypbx-extensions.png" />

        Locate the following information:

        <CodeGroup>
          <CodeGroupItem title="Example">
            ```bash theme={null}
            Extension Number: e.g. 1000
            Server Address: e.g. pbx.zadarma.com
            Username: Your extension username
            Password: Your extension password
            ```
          </CodeGroupItem>
        </CodeGroup>

        <img src="https://mintcdn.com/famulor/BJIaHBogIb3VOn7S/images/provisioning/sip-ai/zadarma-switch-extension-settings.PNG?fit=max&auto=format&n=BJIaHBogIb3VOn7S&q=85&s=900c2ad72a494662de575246b720976c" alt="Zadarma Extension Settings" width="586" height="782" data-path="images/provisioning/sip-ai/zadarma-switch-extension-settings.PNG" />
      </Card>

      <Card title="SIP Connection" icon="server" color="green">
        **Go to "Configuration" → "SIP Settings" on the main page.**

        <img src="https://mintcdn.com/famulor/BJIaHBogIb3VOn7S/images/provisioning/sip-ai/zadarma-sip-settings.png?fit=max&auto=format&n=BJIaHBogIb3VOn7S&q=85&s=f960a40fcbf190bfe15c91503e42771d" alt="Zadarma SIP Settings" width="936" height="313" data-path="images/provisioning/sip-ai/zadarma-sip-settings.png" />

        Find the following information:

        <CodeGroup>
          <CodeGroupItem title="Example">
            ```bash theme={null}
            Phone Number: e.g. +1 555 0123
            SIP Server: e.g. sip.zadarma.com
            Username: Provided by your phone provider
            Password: Provided by your phone provider
            ```
          </CodeGroupItem>
        </CodeGroup>

        <img src="https://mintcdn.com/famulor/BJIaHBogIb3VOn7S/images/provisioning/sip-ai/zadarma-sip-connection-settings.png?fit=max&auto=format&n=BJIaHBogIb3VOn7S&q=85&s=4b30cbccdba96ace10365fbbd0c19c5d" alt="Zadarma SIP Connection Settings" width="624" height="687" data-path="images/provisioning/sip-ai/zadarma-sip-connection-settings.png" />
      </Card>
    </CardGroup>

    <Card title="IP Authorization Type" icon="shield" color="orange">
      **For IP Authorization Type:**

      1. Go to "Services" → "Connect Number" on the main page

               <img src="https://mintcdn.com/famulor/BJIaHBogIb3VOn7S/images/provisioning/sip-ai/zadarma-services.png?fit=max&auto=format&n=BJIaHBogIb3VOn7S&q=85&s=ad9ff904f037ed610db844c0ee932ebc" alt="Zadarma Services" width="627" height="329" data-path="images/provisioning/sip-ai/zadarma-services.png" />

      2. Open "Active Numbers"

      <img src="https://mintcdn.com/famulor/okk2swZ06pjxl-p5/images/provisioning/sip-ai/zadarma-active-numbers.png?fit=max&auto=format&n=okk2swZ06pjxl-p5&q=85&s=e66fbcf0a3328b1a1358740f64f702cd" alt="Zadarma Active Numbers" width="675" height="534" data-path="images/provisioning/sip-ai/zadarma-active-numbers.png" />

      3\. Click the number you want to connect and press the settings button

      <img src="https://mintcdn.com/famulor/BJIaHBogIb3VOn7S/images/provisioning/sip-ai/zadarma-settings-button.png?fit=max&auto=format&n=BJIaHBogIb3VOn7S&q=85&s=0d6c8873be1af16be0409c1a9215bf27" alt="Zadarma Settings Button" width="1034" height="533" data-path="images/provisioning/sip-ai/zadarma-settings-button.png" />

      4. Click on "External Services" then enable the SIP URI option

      <img src="https://mintcdn.com/famulor/okk2swZ06pjxl-p5/images/provisioning/sip-ai/zadarma-external-services.png?fit=max&auto=format&n=okk2swZ06pjxl-p5&q=85&s=9b2c2e66d4fe56982a6203ac1fff27e1" alt="Zadarma External Services" width="584" height="664" data-path="images/provisioning/sip-ai/zadarma-external-services.png" />

      5\. Add `sip:extension@your-unique-id.sip.livekit.cloud` (this is the Famulor SIP server address)

      <Note>
        You will need these IPs, which you enter in Step 2 for the incoming authorization type.
      </Note>
    </Card>

    <Note>
      **Important:** The specific Famulor SIP address is available in your Famulor dashboard under "Phone Numbers" → "Integrate SIP Trunk" → "Our SIP Address."
    </Note>
  </Step>

  <Step title="Import Numbers to Famulor">
    <Card title="Import Process" icon="download" color="blue">
      You need to import them into Famulor.

      1. Go to your Famulor dashboard
      2. Navigate to "Your Phone Numbers"
      3. Click on "Integrate SIP Trunk"
    </Card>

    <CardGroup cols={2}>
      <Card title="PBX Extension Details" icon="gear" color="purple">
        Fill in your details based on your integration type.
      </Card>

      <Card title="SIP Connection Details" icon="link" color="green">
        Fill in your details based on your integration type.
      </Card>
    </CardGroup>

    <Card title="Server Address" icon="server" color="blue">
      Enter the termination SIP URI that you configured in Step 1 here.

      <CodeGroup>
        <CodeGroupItem title="Example">
          ```bash theme={null}
          Server Address: e.g. pbx.zadarma.com / sip.zadarma.com depending on your integration type
          ```
        </CodeGroupItem>
      </CodeGroup>
    </Card>

    <Card title="Authorization Type" icon="shield" color="orange">
      Select the authorization type here.

      Add the IPs from Zadarma (Step 1).
    </Card>

    <Card title="Select Country" icon="globe" color="green">
      Choose the country where your SIP trunk is located.
    </Card>
  </Step>

  <Step title="Verify Setup">
    <Card title="Verification Steps" icon="check-circle" color="green">
      After configuration:

      1. Make a test call to your number/extension
      2. Verify that the AI assistant answers
      3. Use the test call feature to verify outgoing calls
    </Card>
  </Step>
</Steps>

## Security Requirements

<Card title="SIP Credentials Security" icon="shield" color="red">
  Your SIP credentials must be secure:

  * **Username:** Your extension number or the username provided by Zadarma
  * **Password requirements:**
    * 12 or more characters
    * Numbers
    * Upper and lowercase letters
    * Special characters recommended
</Card>

## Common Issues

<CardGroup cols={2}>
  <Card title="Outgoing Calls Not Working" icon="phone-slash" color="red">
    **Incoming calls work after connection, but outgoing calls don’t?**

    <Tabs>
      <TabItem title="Termination SIP URI">
        * Remove any spaces if present
        * Use a localized termination URI close to your region
        * Refer to this documentation to choose one
      </TabItem>

      <TabItem title="Username & Credentials">
        * Make sure you entered the correct username and credentials
        * Note that the username is not the friendly name shown in the credentials list
        * The friendly name differs from the username - double-check this
      </TabItem>
    </Tabs>
  </Card>

  <Card title="Setting up International Countries" icon="globe" color="blue">
    **How do I set up dialing to international countries?**

    1. Search for "geo" to find the "Voice Geographic Permissions" setting
    2. Select "Elastic SIP Trunking" in the selector
    3. Choose the countries you want to dial
  </Card>
</CardGroup>

## Need Help?

<Tip>
  Our support team specializes in helping customers integrate their phone systems. We guide you through the entire process and ensure a smooth setup with your specific Zadarma configuration.
</Tip>

<Card title="Contact Support" icon="headphones" color="blue" href="mailto:support@famulor.io">
  Need further assistance? Contact our support team for personalized help with your Zadarma integration.
</Card>

<Tip>
  Related pages: [Index](/en/index) and [Support](/en/support), and [FAQ](/en/faq).
</Tip>
