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

# Zadarma Entegrasyonu

> Zadarma telefon numaralarınızı SIP trunking ile bağlamak için adım adım kılavuz

Bu kılavuz, SIP trunking kullanarak Zadarma telefon numaralarınızı bağlama sürecinde size yol gösterir. Zadarma iki bağlantı türü sunar — **PBX** ve **SIP Direct** — ve kurulum her biri için biraz farklıdır.

<Tip>
  **Hangi türe sahipsiniz?** Zadarma'nın dahili hatlı (örn. 100, 101) sanal PBX'ini kullanıyorsanız, **PBX**'iniz var. PBX olmadan bağımsız bir SIP hesabı kullanıyorsanız, **SIP Direct**'iniz var.
</Tip>

Aşağıdan bağlantı türünüzü seçin ve adımları izleyin:

<Tabs>
  <Tab title="PBX">
    ## Adım 1: SIP Kimlik Bilgilerinizi Toplayın

    1. [Zadarma Kontrol Panelinize](https://my.zadarma.com) giriş yapın
    2. **PBX'im** → **Dahili Hatlar**'a gidin

    <Frame>
      <img src="https://mintcdn.com/whattalkai/gDDouZ6qRAq-Ygi2/resources/zadarma-mypbx-extensions.png?fit=max&auto=format&n=gDDouZ6qRAq-Ygi2&q=85&s=626d36b2ed0f914b58f237d1e59737b8" alt="Zadarma PBX'im Dahili Hatlar" width="1209" height="779" data-path="resources/zadarma-mypbx-extensions.png" />
    </Frame>

    3. Dahili hattınızı bulun ve şu bilgileri not edin:

    ```
    Dahili hat: örn. 510000-100
    Sunucu adresi: pbx.zadarma.com
    Kullanıcı adı: Dahili hat kullanıcı adınız (örn. 510000-100)
    Şifre: Dahili hat şifreniz
    Telefon numarası: Telefon numaranız (örn. +521151900966)
    ```

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/whattalkai/resources/zadarma-switch-extension-settings.png" alt="Zadarma PBX Dahili Hat Ayarları" />
    </Frame>

    ## Adım 2: Harici Sunucu Kurulumu (gelen aramalar için)

    Gelen aramaları almak için, Zadarma'da gelen aramaları platformun SIP sunucusuna ileten bir **Harici Sunucu** yapılandırmanız gerekir.

    1. [Zadarma Kontrol Panelinizde](https://my.zadarma.com), **Ayarlar** → [**Sanal telefon numaraları**](https://my.zadarma.com/dirnum/active/) bölümüne gidin

    <Frame>
      <img src="https://mintcdn.com/whattalkai/gDDouZ6qRAq-Ygi2/resources/zadarma-settings-virtual-numbers.png?fit=max&auto=format&n=gDDouZ6qRAq-Ygi2&q=85&s=d09c85a8d045a534155b4d78878cab5b" alt="Zadarma Ayarlar Sanal telefon numaraları" width="1215" height="784" data-path="resources/zadarma-settings-virtual-numbers.png" />
    </Frame>

    2. Bağlamak istediğiniz numarayı bulun ve ayarlarını açmak için **dişli simgesine** tıklayın

    <Frame>
      <img src="https://mintcdn.com/whattalkai/gDDouZ6qRAq-Ygi2/resources/zadarma-settings-virtual-numbers-gear-icon.png?fit=max&auto=format&n=gDDouZ6qRAq-Ygi2&q=85&s=dd019a701cb8561a1fc17d9c6a302725" alt="Zadarma Ayarlar Sanal telefon numaraları Dişli Simgesi" width="1207" height="660" data-path="resources/zadarma-settings-virtual-numbers-gear-icon.png" />
    </Frame>

    3. **Harici Sunucu**'ya tıklayın ve **SIP URI** onay kutusunu etkinleştirin

    <Frame>
      <img src="https://mintcdn.com/whattalkai/gDDouZ6qRAq-Ygi2/resources/zadarma-pbx-external-server.png?fit=max&auto=format&n=gDDouZ6qRAq-Ygi2&q=85&s=a2c6fe3aaf531b9514f2e7af6aae8db6" alt="Zadarma PBX Harici Sunucu SIP URI yapılandırması" width="1219" height="877" data-path="resources/zadarma-pbx-external-server.png" />
    </Frame>

    4. **`+` öneki ile telefon numaranızı** kullanarak SIP sunucu adresini girin:

    ```
    +TELEFON_NUMARANIZ@5wed79aeavr.sip.livekit.cloud
    ```

    Örneğin, numaranız `+551151900966` ise:

    ```
    +521151900966@5wed79aeavr.sip.livekit.cloud
    ```

    <Frame>
      <img src="https://mintcdn.com/whattalkai/gDDouZ6qRAq-Ygi2/resources/zadarma-pbx-server-address.png?fit=max&auto=format&n=gDDouZ6qRAq-Ygi2&q=85&s=6119a8e266e1d50daa85931050bfa498" alt="Zadarma PBX Sunucu Adresi yapılandırması" width="621" height="713" data-path="resources/zadarma-pbx-server-address.png" />
    </Frame>

    5. Zadarma'nın IP adreslerini görmek için sunucu adresinin altındaki **IP Göster**'e tıklayın (örn. `185.45.152.216`, `185.45.155.33`)

    <Frame>
      <img src="https://mintcdn.com/whattalkai/gDDouZ6qRAq-Ygi2/resources/zadarma-pbx-show-ip-button.png?fit=max&auto=format&n=gDDouZ6qRAq-Ygi2&q=85&s=89e111dbe4463e5dc2513843ae9173d8" alt="Zadarma PBX IP Göster düğmesi" width="674" height="762" data-path="resources/zadarma-pbx-show-ip-button.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/whattalkai/gDDouZ6qRAq-Ygi2/resources/zadarma-pbx-show-ip-addresses.png?fit=max&auto=format&n=gDDouZ6qRAq-Ygi2&q=85&s=eb42388dc11540cc420ced42249c2fc3" alt="Zadarma PBX IP adresleri gösterildi" width="681" height="763" data-path="resources/zadarma-pbx-show-ip-addresses.png" />
    </Frame>

    <Note>
      **Bu IP'leri kaydedin** — Adım 3'te platformda gelen yetkilendirmeyi yapılandırırken bunlara ihtiyacınız olacak.
    </Note>

    <Warning>
      **PBX kullanıcıları Harici Sunucu adresinde `+` ile telefon numarasını kullanmalıdır**. PBX dahili hat numarasını (örn. `533177-100`) kullanmak gelen aramalar için **çalışmaz**.
    </Warning>

    ## Adım 3: Numaraları Platforma İçe Aktarma

    Şimdi platformun aramaları nasıl yönlendireceğini bilmesi için numarayı içe aktarın.

    1. Kontrol panelinizdeki Telefon Numaraları sayfasına doğrudan gidin:

       **[https://app.whattalk.ai/phone-numbers](https://app.whattalk.ai/phone-numbers)**

       Sizi giriş sayfasına yönlendirirse, önce giriş yapın — otomatik olarak Telefon Numaraları sayfasına yönlendirileceksiniz.

    2. \*\*"SIP trunk entegre et"\*\*e tıklayın (sayfanın sağ üst köşesi)

    <Frame>
      <img src="https://mintcdn.com/whattalkai/gDDouZ6qRAq-Ygi2/resources/zadarma-import-sip.png?fit=max&auto=format&n=gDDouZ6qRAq-Ygi2&q=85&s=026cb25d724cb541a5100db7008da87b" alt="SIP trunk ile numaraları içe aktarma" width="1054" height="508" data-path="resources/zadarma-import-sip.png" />
    </Frame>

    3. Telefon numaranızı ve SIP kimlik bilgilerinizi doldurun:

    ```
    Telefon numarası: örn. +551151900966
    Kullanıcı adı: PBX dahili hattınız (örn. 533100-100)
    SIP Dahili Hattınız: Telefon numaranız (örn. +551151900966)
    Şifre: PBX dahili hat şifreniz
    ```

    <Warning>
      **PBX kullanıcıları:** **Kullanıcı adı** PBX dahili hattınızdır (örn. `533100-100`). **"SIP Dahili Hattınız"** alanı **telefon numaranız** olmalıdır — bu, Adım 2'de Harici Sunucu adresinde kullandığınız numarayla eşleşmelidir.
    </Warning>

    <Frame>
      <img src="https://mintcdn.com/whattalkai/gDDouZ6qRAq-Ygi2/resources/zadarma-pbx-auth.png?fit=max&auto=format&n=gDDouZ6qRAq-Ygi2&q=85&s=37e4a98c88bd8dc98ab7c2810255f2c2" alt="PBX Dahili Hat kimlik bilgileri" width="1049" height="498" data-path="resources/zadarma-pbx-auth.png" />
    </Frame>

    4. Giden aramalar için **Sunucu adresini** girin:

    ```
    pbx.zadarma.com
    ```

    <Frame>
      <img src="https://mintcdn.com/whattalkai/gDDouZ6qRAq-Ygi2/resources/zadarma-pbx-outbound-settings.png?fit=max&auto=format&n=gDDouZ6qRAq-Ygi2&q=85&s=792fc2966ed39e1edd84519ed2c04bb4" alt="Zadarma giden sunucu adresi" width="1019" height="343" data-path="resources/zadarma-pbx-outbound-settings.png" />
    </Frame>

    5. **Yetkilendirme türünü** seçin. **IP**'yi seçin ve Adım 2'deki **IP Göster**'den not ettiğiniz Zadarma IP adreslerini ekleyin.

    <Frame>
      <img src="https://mintcdn.com/whattalkai/gDDouZ6qRAq-Ygi2/resources/zadarma-ip-inbound.png?fit=max&auto=format&n=gDDouZ6qRAq-Ygi2&q=85&s=7b75f10fd72701b4ef3d1e067d9bf180" alt="Zadarma IP Yetkilendirme" width="1015" height="491" data-path="resources/zadarma-ip-inbound.png" />
    </Frame>

    6. SIP trunk'ınızın bulunduğu **ülkeyi** seçin.

    <Frame>
      <img src="https://mintcdn.com/whattalkai/gDDouZ6qRAq-Ygi2/resources/zadarma-sip-country.png?fit=max&auto=format&n=gDDouZ6qRAq-Ygi2&q=85&s=d113c9a9a49084a158dfa1b1520c6b41" alt="SIP Ülke seçimi" width="1036" height="139" data-path="resources/zadarma-sip-country.png" />
    </Frame>

    ## Adım 4: Kurulumu Doğrulama

    1. Numaranıza bir test araması yapın
    2. AI asistanın cevap verdiğini kontrol edin
    3. Giden aramayı doğrulamak için test arama özelliğini kullanın
  </Tab>

  <Tab title="SIP Direct">
    ## Adım 1: SIP Kimlik Bilgilerinizi Toplayın

    1. [Zadarma Kontrol Panelinize](https://my.zadarma.com) giriş yapın
    2. **Ayarlar** → **SIP Bağlantısı**'na gidin

    <Frame>
      <img src="https://mintcdn.com/whattalkai/gDDouZ6qRAq-Ygi2/resources/zadarma-sip-settings.png?fit=max&auto=format&n=gDDouZ6qRAq-Ygi2&q=85&s=9007197dfda3f0e1e561e3283d55bb90" alt="Zadarma SIP Ayarları" width="1206" height="774" data-path="resources/zadarma-sip-settings.png" />
    </Frame>

    3. Şu bilgileri not edin:

    ```
    Sunucu adresi: sip.zadarma.com
    Dahili hat: SIP dahili hat numaranız (örn. 247000)
    Kullanıcı adı: SIP kullanıcı adınız (dahili hattınızla aynı, örn. 247000)
    Şifre: SIP şifreniz
    ```

    <Frame>
      <img src="https://mintcdn.com/whattalkai/gDDouZ6qRAq-Ygi2/resources/zadarma-sip-connection-settings.png?fit=max&auto=format&n=gDDouZ6qRAq-Ygi2&q=85&s=7e2a89cb02f759b5424d06202be113bb" alt="Zadarma SIP Bağlantı Ayarları" width="829" height="715" data-path="resources/zadarma-sip-connection-settings.png" />
    </Frame>

    ## Adım 2: Harici Sunucu Kurulumu (gelen aramalar için)

    Gelen aramaları almak için, Zadarma'da gelen aramaları platformun SIP sunucusuna ileten bir **Harici Sunucu** yapılandırmanız gerekir.

    1. [Zadarma Kontrol Panelinizde](https://my.zadarma.com), **Ayarlar** → [**Sanal telefon numaraları**](https://my.zadarma.com/dirnum/active/) bölümüne gidin

    <Frame>
      <img src="https://mintcdn.com/whattalkai/gDDouZ6qRAq-Ygi2/resources/zadarma-sip-settings-virtual-numbers.png?fit=max&auto=format&n=gDDouZ6qRAq-Ygi2&q=85&s=58dda621f254a99752ecf33d4e8e38ad" alt="Zadarma SIP Ayarları Sanal telefon numaraları" width="1229" height="794" data-path="resources/zadarma-sip-settings-virtual-numbers.png" />
    </Frame>

    2. Bağlamak istediğiniz numarayı bulun ve ayarlarını açmak için **dişli simgesine** tıklayın

    <Frame>
      <img src="https://mintcdn.com/whattalkai/gDDouZ6qRAq-Ygi2/resources/zadarma-sip-settings-virtual-numbers-gear-icon.png?fit=max&auto=format&n=gDDouZ6qRAq-Ygi2&q=85&s=b56665e302b66d0d24016e10fad7f136" alt="Zadarma SIP Ayarları Sanal telefon numaraları Dişli Simgesi" width="1214" height="654" data-path="resources/zadarma-sip-settings-virtual-numbers-gear-icon.png" />
    </Frame>

    3. **Harici Sunucu**'ya tıklayın ve **SIP URI** onay kutusunu etkinleştirin

    <Frame>
      <img src="https://mintcdn.com/whattalkai/gDDouZ6qRAq-Ygi2/resources/zadarma-sip-external-server.png?fit=max&auto=format&n=gDDouZ6qRAq-Ygi2&q=85&s=d7b7cf0df9965c1f5a762fb6bac3979e" alt="Zadarma SIP Harici Sunucu SIP URI yapılandırması" width="1221" height="871" data-path="resources/zadarma-sip-external-server.png" />
    </Frame>

    4. **SIP dahili hat numaranızı** kullanarak SIP sunucu adresini girin:

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

    Örneğin, dahili hattınız `247000` ise:

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

    <Frame>
      <img src="https://mintcdn.com/whattalkai/gDDouZ6qRAq-Ygi2/resources/zadarma-sip-uri.png?fit=max&auto=format&n=gDDouZ6qRAq-Ygi2&q=85&s=833fc9a030998ef4628e8c2294e901b7" alt="Zadarma SIP URI" width="616" height="683" data-path="resources/zadarma-sip-uri.png" />
    </Frame>

    5. Zadarma'nın IP adreslerini görmek için sunucu adresinin altındaki **IP Göster**'e tıklayın (örn. `185.45.152.216`, `185.45.155.33`)

    <Frame>
      <img src="https://mintcdn.com/whattalkai/gDDouZ6qRAq-Ygi2/resources/zadarma-sip-show-ip-button.png?fit=max&auto=format&n=gDDouZ6qRAq-Ygi2&q=85&s=aee76f0907cbb648aae351016c9b1396" alt="Zadarma SIP IP Göster düğmesi" width="669" height="735" data-path="resources/zadarma-sip-show-ip-button.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/whattalkai/gDDouZ6qRAq-Ygi2/resources/zadarma-sip-show-ip-addresses.png?fit=max&auto=format&n=gDDouZ6qRAq-Ygi2&q=85&s=c1a6474e689d98f2fcdfc6ffb15e27f2" alt="Zadarma SIP IP adresleri gösterildi" width="615" height="685" data-path="resources/zadarma-sip-show-ip-addresses.png" />
    </Frame>

    <Note>
      **Bu IP'leri kaydedin** — Adım 3'te platformda gelen yetkilendirmeyi yapılandırırken bunlara ihtiyacınız olacak.
    </Note>

    ## Adım 3: Numaraları Platforma İçe Aktarma

    Şimdi platformun aramaları nasıl yönlendireceğini bilmesi için numarayı içe aktarın.

    1. Kontrol panelinizdeki Telefon Numaraları sayfasına doğrudan gidin:

       **[https://app.whattalk.ai/phone-numbers](https://app.whattalk.ai/phone-numbers)**

       Sizi giriş sayfasına yönlendirirse, önce giriş yapın — otomatik olarak Telefon Numaraları sayfasına yönlendirileceksiniz.

    2. \*\*"SIP trunk entegre et"\*\*e tıklayın (sayfanın sağ üst köşesi)

    <Frame>
      <img src="https://mintcdn.com/whattalkai/gDDouZ6qRAq-Ygi2/resources/zadarma-import-sip.png?fit=max&auto=format&n=gDDouZ6qRAq-Ygi2&q=85&s=026cb25d724cb541a5100db7008da87b" alt="SIP trunk ile numaraları içe aktarma" width="1054" height="508" data-path="resources/zadarma-import-sip.png" />
    </Frame>

    3. Telefon numaranızı ve SIP kimlik bilgilerinizi doldurun:

    ```
    Telefon numarası: örn. +1 555 0123
    SIP Dahili Hattınız: SIP dahili hat numaranız (örn. 247000)
    Kullanıcı adı: SIP kullanıcı adınız (dahili hattınızla aynı, örn. 247000)
    Şifre: SIP şifreniz
    ```

    <Frame>
      <img src="https://mintcdn.com/whattalkai/gDDouZ6qRAq-Ygi2/resources/zadarma-sip-auth-integration.png?fit=max&auto=format&n=gDDouZ6qRAq-Ygi2&q=85&s=a1093babfe2d2db2004106bb8e3c10af" alt="SIP Direct kimlik bilgileri" width="1051" height="497" data-path="resources/zadarma-sip-auth-integration.png" />
    </Frame>

    4. Giden aramalar için **Sunucu adresini** girin:

    ```
    sip.zadarma.com
    ```

    <Frame>
      <img src="https://mintcdn.com/whattalkai/gDDouZ6qRAq-Ygi2/resources/zadarma-sip-outbound-settings.png?fit=max&auto=format&n=gDDouZ6qRAq-Ygi2&q=85&s=479a65cb2508530b6b264e67596115ae" alt="Zadarma SIP giden sunucu adresi" width="1011" height="342" data-path="resources/zadarma-sip-outbound-settings.png" />
    </Frame>

    5. **Yetkilendirme türünü** seçin. **IP**'yi seçin ve Adım 2'deki **IP Göster**'den not ettiğiniz Zadarma IP adreslerini ekleyin.

    <Frame>
      <img src="https://mintcdn.com/whattalkai/gDDouZ6qRAq-Ygi2/resources/zadarma-ip-inbound.png?fit=max&auto=format&n=gDDouZ6qRAq-Ygi2&q=85&s=7b75f10fd72701b4ef3d1e067d9bf180" alt="Zadarma IP Yetkilendirme" width="1015" height="491" data-path="resources/zadarma-ip-inbound.png" />
    </Frame>

    6. SIP trunk'ınızın bulunduğu **ülkeyi** seçin.

    <Frame>
      <img src="https://mintcdn.com/whattalkai/gDDouZ6qRAq-Ygi2/resources/zadarma-sip1-country.png?fit=max&auto=format&n=gDDouZ6qRAq-Ygi2&q=85&s=c1749de2542cbd9412c6467e5159d819" alt="SIP Ülke seçimi" width="1037" height="132" data-path="resources/zadarma-sip1-country.png" />
    </Frame>

    ## Adım 4: Kurulumu Doğrulama

    1. Numaranıza bir test araması yapın
    2. AI asistanın cevap verdiğini kontrol edin
    3. Giden aramayı doğrulamak için test arama özelliğini kullanın
  </Tab>
</Tabs>

## Güvenlik Gereksinimleri

SIP kimlik bilgilerinizin güvenli olması gerekir:

* **Kullanıcı adı**: Dahili hat numaranız veya sağlayıcı tarafından verilen kullanıcı adı
* **Şifre şunlara sahip olmalı**:
  * 12 veya daha fazla karakter
  * Sayılar
  * Büyük ve küçük harfler
  * Özel karakterler önerilir

## Arama Aktarma Sınırlamaları

<Warning>
  **Zadarma SIP REFER'i desteklemez**, bu da standart soğuk aktarmanın kutudan çıktığı gibi çalışmayacağı anlamına gelir. Sıcak aktarma otomatik olarak çalışır — platform bunu SIP INVITE aracılığıyla yönetir.

  **Soğuk aktarma** için asistanınızın aktarma ayarlarındaki **Özel SIP Aktarma** seçeneğini kullanabilirsiniz. Özel SIP URI'yi şu şekilde ayarlayın:

  ```
  sip:+HEDEF_NUMARA@sip.zadarma.com
  ```

  Örneğin: `sip:+15557654321@sip.zadarma.com`

  Numaranın `+` öneki ile uluslararası E.164 formatında olduğundan emin olun. `tel:` URI formatını **kullanmayın**.
</Warning>

## Yaygın Sorunlar

<AccordionGroup>
  <Accordion title="Gelen aramalar çalışmıyor">
    * **Harici Sunucu adresinizi kontrol edin** — formatın bağlantı türünüze uyduğundan emin olun:
      * **PBX**: `+TELEFON_NUMARANIZ@5wed79aeavr.sip.livekit.cloud` (`+` ile telefon numarası)
      * **SIP Direct**: `DAHILI_HATTINIZ@5wed79aeavr.sip.livekit.cloud` (dahili hat numarası)
    * **Harici Sunucunun etkinleştirildiğini doğrulayın** Zadarma ayarlarında
    * **Platformdaki "SIP Dahili Hattınız" alanının** eşleştiğini kontrol edin: PBX için telefon numarası, SIP Direct için dahili hat
  </Accordion>

  <Accordion title="Giden aramalar çalışmıyor">
    * **Sunucu adresini kontrol edin** — PBX için `pbx.zadarma.com` veya SIP Direct için `sip.zadarma.com` olmalıdır
    * **Kimlik bilgilerinizi doğrulayın** — kullanıcı adı ve şifrenin Zadarma SIP ayarlarınızda gösterilenle eşleştiğinden emin olun
    * **Zadarma bakiyenizi kontrol edin** — giden aramalar yeterli kredi gerektirir
  </Accordion>

  <Accordion title="Soğuk aktarma çalışmıyor">
    Zadarma SIP REFER'i desteklemez. Soğuk aktarmayı etkinleştirmek için:

    1. Asistanınızın **Telefon Araması Aktarma** araç ayarlarına gidin
    2. \*\*"Özel SIP aktarma"\*\*yı etkinleştirin (Gelişmiş altında)
    3. SIP URI'yi `sip:+HEDEF_NUMARA@sip.zadarma.com` olarak ayarlayın

    Soğuk aktarma hâlâ başarısız oluyorsa, hedef numaranın `+` ile uluslararası formatta olduğunu doğrulayın.
  </Accordion>

  <Accordion title="Hangi bağlantı türünü kullanmalıyım — PBX mi SIP Direct mi?">
    * **PBX**, birden fazla dahili hat, arama yönlendirme kuralları, IVR menüleri veya Zadarma'daki diğer PBX özelliklerine ihtiyacınız varsa önerilir
    * **SIP Direct**, PBX özellikleri olmadan sadece tek bir numara bağlamak istiyorsanız daha basittir

    Her ikisi de gelen ve giden AI aramaları için eşit derecede iyi çalışır.
  </Accordion>
</AccordionGroup>

***

<Note>
  Kurulum konusunda yardıma mı ihtiyacınız var? Destek ekibimiz müşterilerin telefon
  sistemlerini entegre etmelerine yardımcı olma konusunda uzmanlaşmıştır. Belirli telefon
  sistemi yapılandırmanızla sorunsuz bir kurulum sağlayarak tüm süreç boyunca size rehberlik edeceğiz.
</Note>