# Entegrasyonlar (https://docs.akollo.com/tr/modules/integrations)



Entegrasyonlar modülü Akollo’yu kurumunuzun hâlihazırda kullandığı dış sistemlere bağlar: Jira, Microsoft Teams, Slack, e-posta ve takvim, dizin hizmetleri, CRM araçları ve BI araçları gibi. Yöneticiler API anahtarlarını, web kancalarını ve veri aktarımlarını da burada yönetir. Entegrasyonlar ayrı bir alandır: kenar çubuğunda **Entegrasyonlar**’ı açın. Bağlantıyı, bağlantıları görme yetkisi olan kişiler görür.

Entegrasyon ayarlarına ait eski yer imleri çalışmaya devam eder: Entegrasyonlar alanını açar. CRM bölümüne ait bir yer imi ise **Katalog**’u CRM kategorisi seçili olarak açar.

## Kimler kullanır [#kimler-kullanır]

| Rol                              | Burada ne yapar                                                                                                                      |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| Yönetici                         | Bağlayıcılara izin verir, bağlantı kurar; API anahtarlarını, web kancalarını ve veri aktarımlarını yönetir.                          |
| Bağlantı sahibi ve yedek sahip   | Bir bağlantıdan sorumludur: kimlik bilgileri, eşitlemeleri ve sorunları. Her bağlantının ikisi de vardır ve ikisi farklı kişilerdir. |
| Entegrasyon operatörü            | Bağlantıları görüp test edebilen, eşitleme çalıştırıp sorunlarını çözebilen ama bağlantıları yönetmeyen özel bir rol.                |
| Raporlama yöneticisi             | Raporlama veri kümeleri için BI erişimini kurar.                                                                                     |
| Başka bir sistemin geliştiricisi | Herkese açık API’yi bir anahtarla çağırır ve **Geliştirici** başvurusunu okur.                                                       |
| Destek oturumu                   | Her sayfaya bakabilir; bağlantıyı, anahtarı, politikayı ya da bir bağlayıcının izin listesini değiştiremez.                          |

## Ana ekranlar [#ana-ekranlar]

| Sekme                    | Ne gösterir                                                                                                                                                                          |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Genel bakış**          | Durumlarına göre bağlantı sayıları, açık sorunlar, süresi yaklaşan anahtarlar, son 14 günün eşitleme sağlığı ve son eşitlemeler.                                                     |
| **Katalog**              | Tüm bağlayıcılar; kategori, durum, destek ve politikaya göre süzülür. Bağlayıcı sayfası sürümleri test kayıtlarıyla, izin listesini, erişebileceği sunucuları ve lisansını gösterir. |
| **Bağlantılar**          | Kurumun bağlantıları, durum ve son testle. Bağlantı sayfasında **Genel bakış**, **Testler** ve **Eşitlemeler** sekmeleri vardır.                                                     |
| **Sorunlar**             | Bir eşitlemenin işleyemediği kayıtlar; nedene göre gruplanır, yeniden deneme, atlama ve çakışma çözme imkânıyla.                                                                     |
| **API anahtarları**      | Başka programlar için anahtarlar; kapsam, son kullanma, son kullanım ve durumla.                                                                                                     |
| **Geliştirici**          | Herkese açık API başvurusu: seçilen sürümdeki her uç nokta, kapsamı ve örnek bir istek.                                                                                              |
| **Gelen bildirimler**    | Başka bir sistemin Akollo’ya webhook gönderebileceği uç noktalar.                                                                                                                    |
| **Web kancaları**        | Akollo’nun kurumun olaylarını gönderdiği uç noktalar.                                                                                                                                |
| **Veri aktarımı**        | Azure Blob, Power BI ve Analitik SQL gibi dışa aktarma hedefleri.                                                                                                                    |
| **Analitik SQL erişimi** | BI araçları için onaylanmış her SQL erişimine bir kart.                                                                                                                              |

<Screenshot src="/screens/tr/integrations.webp" alt="Etkin bağlantılar, ilgi bekleyen bağlantılar, açık sorunlar ve süresi yaklaşan anahtarlar sayaçlarıyla Entegrasyonlar genel bakışı" caption="Genel bakış: bağlantı sayıları, açık sorunlar ve süresi yaklaşan anahtarlar." />

<Screenshot src="/screens/tr/integrations-catalogue.webp" alt="Kategori, durum, destek ve politika süzgeçleri ile durum rozetli bağlayıcı kartlarının yer aldığı bağlayıcı kataloğu" caption="Katalog: bağlayıcıları süzün, her birinin durumunu ve destek düzeyini görün." />

<Screenshot src="/screens/tr/integrations-connections.webp" alt="Her bağlantının adı, Taslak, Etkin ya da Devre dışı gibi bir durum rozeti ve son testinin yer aldığı Bağlantılar listesi" caption="Bağlantılar: her bağlantının durumu ve son testi." />

## Verinin izlediği yollar [#verinin-izlediği-yollar]

<Mermaid
  title="Akollo diğer sistemlerle nasıl veri alışverişi yapar"
  chart="`flowchart LR
A[Diğer sistem] -->|Bağlantı ve eşitleme| B[Akollo]
A -->|Gelen webhook| B
C[API anahtarlı program] -->|Herkese açık API| B
B -->|Giden webhook| D[Alıcı sistem]
B -->|Veri aktarımı ve SQL erişimi| E[BI aracı]`"
/>

## Temel işler [#temel-işler]

### Bağlantı kurmak [#bağlantı-kurmak]

<Steps>
  <Step>
    ### Bağlayıcıyı seçin [#bağlayıcıyı-seçin]

    **Bağlantılar** sekmesinde **Yeni bağlantı**’yı seçip bir bağlayıcı belirleyin. Yalnızca kurulu ve kurumunuz için izin verilmiş bağlayıcılar sunulur.
  </Step>

  <Step>
    ### Kimlik bilgilerini ve sahipleri girin [#kimlik-bilgilerini-ve-sahipleri-girin]

    Bağlantıya bir ad verin, bir sahip ve ondan farklı bir yedek sahip seçin, bağlayıcının istediği kimlik bilgilerini girin. Bilgiler şifreli saklanır ve bir daha gösterilmez.
  </Step>

  <Step>
    ### Yönü seçin [#yönü-seçin]

    **Okuma**, **Yazma** ya da **Okuma ve yazma**’yı seçin. Bağlayıcı politikasının izin verdiği veri sınıfları ve sunucular bilgi amacıyla gösterilir.
  </Step>

  <Step>
    ### Test edin, ardından etkinleştirin [#test-edin-ardından-etkinleştirin]

    Önce **Test**, ardından **Etkinleştirme** adımını tamamlayın. Bağlantı, bir test başarılı olana kadar taslak olarak kalır.
  </Step>
</Steps>

<Callout type="info" title="Not">
  Bu sürümde bağlayıcı çalıştırma kapalıdır; bu yüzden test adımı sunulmaz ve yeni bağlantılar taslak olarak kalır. Ayrıntılar için [Bağlı sistemler](/tr/connections) sayfasına bakın.
</Callout>

### Başka bir programa API erişimi vermek [#başka-bir-programa-api-erişimi-vermek]

<Steps>
  <Step>
    ### Anahtarı oluşturun [#anahtarı-oluşturun]

    **API anahtarları** sekmesinde bir anahtar oluşturun, onu kullanan sistemin adını verin ve adına çalışacağı **Servis hesabı**’nı seçin.
  </Step>

  <Step>
    ### Sınırlayın [#sınırlayın]

    Yalnızca gereken kapsamları, bir son kullanma tarihi (en çok bir yıl) ve mümkünse **İzinli IP aralıkları**’nı belirleyin.
  </Step>

  <Step>
    ### Saklayın [#saklayın]

    **Anahtar oluştur**’u seçin ve anahtarı kopyalayın. Anahtar yalnızca bir kez gösterilir. Kayıt değiştirebilen bir anahtar, başka bir yönetici onaylayana kadar bekler.
  </Step>
</Steps>

### Eşitlemenin ayırdığı kayıtları ele almak [#eşitlemenin-ayırdığı-kayıtları-ele-almak]

<Steps>
  <Step>
    ### Sorunlar’ı açın [#sorunları-açın]

    **Sorunlar** sekmesini açın. Kayıtlar nedenlerine göre gruplanır; sayıları ve sorunun ilk ve son görüldüğü zaman yer alır.
  </Step>

  <Step>
    ### Nedeni giderin [#nedeni-giderin]

    Örneğin eşitleme akışının alan eşlemesini düzeltin.
  </Step>

  <Step>
    ### Yeniden deneyin, atlayın ya da çözün [#yeniden-deneyin-atlayın-ya-da-çözün]

    Kayıtları yeniden deneyin (yeniden deneme kaydı kaynaktan tekrar okur), bir gerekçeyle atlayın ya da çakışmayı Akollo’daki değeri, dış sistemdeki değeri veya yeni bir değeri seçerek çözün.
  </Step>
</Steps>

### Olayları başka bir sisteme göndermek [#olayları-başka-bir-sisteme-göndermek]

<Steps>
  <Step>
    ### Uç noktayı oluşturun [#uç-noktayı-oluşturun]

    **Web kancaları** sekmesinde bir https adresi, olay türlerini ve kaydın tamamının mı yoksa yalnızca bir referansın mı gönderileceğini girin.
  </Step>

  <Step>
    ### İmzalama anahtarını saklayın [#i̇mzalama-anahtarını-saklayın]

    Gizli anahtar yalnızca bir kez, oluşturmanın hemen ardından gösterilir.
  </Step>

  <Step>
    ### Teslimatları izleyin [#teslimatları-izleyin]

    Liste her uç noktanın durumunu ve son 24 saatteki teslim başarısını gösterir. Uç nokta sayfasında ileti günlüğü ve her teslim denemesi yer alır.
  </Step>
</Steps>

<Callout type="info" title="Not">
  Bu sürümde giden teslimat henüz açık değildir; sayfa uç nokta oluşturmayı sunmaz. Ayrıntılar için [Webhook’lar](/tr/connections/webhooks) sayfasına bakın.
</Callout>

### Bir BI aracını beslemek [#bir-bi-aracını-beslemek]

<Steps>
  <Step>
    ### Yolu seçin [#yolu-seçin]

    Raporlama veri kümelerini salt okunur bir anahtarla API üzerinden okuyun ya da canlı sorgular için SQL erişimi kurun.
  </Step>

  <Step>
    ### Rehberi izleyin [#rehberi-izleyin]

    Power BI, Tableau ve Looker Studio için [BI veri kümeleri](/tr/connections/bi-datasets), SQL için [BI aracını SQL ile bağlama](/tr/connections/bi-sql-access) sayfasına bakın.
  </Step>
</Steps>

<Screenshot src="/screens/tr/data-out.webp" alt="Azure Blob, Power BI ve Analitik SQL dışa aktarma hedefleri ile kapalı durumdaki Azure Blob dışa aktarımı anahtarını gösteren Veri aktarımı sekmesi" caption="Veri aktarımı: veri kümesi akışının yanındaki dışa aktarma hedefleri." />

## Belirli sistemler [#belirli-sistemler]

| Sistem                            | Ne yapar                                                                                                                                        | Sayfa                                                       |
| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- |
| Jira Cloud ve Jira Data Center    | Jira ile yan yana çalışma ya da seçili işleri incelenmiş bir devirle Jira’dan Akollo’ya taşıma.                                                 | [Jira ile birlikte çalışma ve geçiş](/tr/connections/jira)  |
| Zoom                              | Sona ermiş toplantıları okur: başlangıç, bitiş, süre, katılımcı sayısı ve toplantı sahibi. Toplantıları değiştirmez, ad okumaz.                 | [Zoom toplantıları](/tr/connections/zoom)                   |
| LDAP, Entra ID, Outlook e-postası | Bağlantının Genel bakış sekmesinde **Sağlayıcı ayarları** bulunan dizin ve e-posta bağlantıları. Dizin bağlayıcıları yalnızca okur ve listeler. | [Bağlı sistemler](/tr/connections)                          |
| Power BI, Tableau, Looker Studio  | Raporlama veri kümelerini API üzerinden okur.                                                                                                   | [BI veri kümeleri](/tr/connections/bi-datasets)             |
| SQL ile Power BI, Tableau, Excel  | Onaylanmış veri kümelerini salt okunur bir oturumla canlı okur.                                                                                 | [BI aracını SQL ile bağlama](/tr/connections/bi-sql-access) |

Başka bir sistemden veri taşımak sistem bazında planlanır: her bağlantı için amacı, paylaşılacak kayıtları, güncellemelerin yönünü ve sorumlu kişiyi kararlaştırın. Bir bağlantı, diğer ürünün tüm özelliklerini ya da geçmiş kayıtlarını kendiliğinden getirmez. Bir devri kabul etmeden önce kararlaştırılan kayıtların kapsamını gözden geçirin ve açık istisnaları çözün.

## Yetkiler [#yetkiler]

* **Kurum sahipleri ve yöneticiler** varsayılan olarak bu alandaki her şeyi görüp değiştirebilir. Özel bir entegrasyon operatörü rolü bağlantıları görüp test edebilir, eşitleme çalıştırabilir ve sorunları çözebilir.
* **Kimlik bilgileri** kaydedildikten sonra kimseye bir daha gösterilmez. Kimlik bilgilerini yenilemek ayrı bir yetkidir; önceki bilgiler 24 saat daha çalışır.
* **Hassas değişiklikler için iki kişi** gerekir: yazabilen bir API anahtarını, oluşturan kişiden başkası onaylar; korunan bir alanı dış sisteme açan bir alan eşlemesi ikinci bir yönetici ister.
* **API anahtarları**, adına çalıştıkları servis hesabının rolünden fazlasını asla yapamaz.
* **Sahipler**: bir bağlantının sahibi aynı zamanda yedek sahibi olamaz.
* **Destek oturumları** her sayfada yalnızca okuyabilir; bir bağlayıcının izin listesini değiştiremez.

## Yapay zekâ burada ne yapabilir [#yapay-zekâ-burada-ne-yapabilir]

Entegrasyonların kendine ait yapay zekâ özellikleri yoktur. Kendi yapay zekâ sağlayıcınızı ya da model sunucunuzu bağlamak ayrı bir ayardır; [Yapay zekâ bağlantıları](/tr/ai/connections) sayfasına bakın. [Yapay zekâ asistanı](/tr/ai/assistant) bağlantıları, anahtarları ya da web kancalarını değiştirmez.

## Sık sorulan sorular [#sık-sorulan-sorular]

<Accordions type="single">
  <Accordion title="Bir bağlayıcı katalogda neden soluk görünüyor?">
    Bu kurulumda yüklü değildir. Bağlayıcılar bir sürümle kurulur. Engellenen bağlayıcılar nedeniyle birlikte işaretlenir.
  </Accordion>

  <Accordion title="Yeni bağlantım neden taslak olarak kalıyor?">
    Bağlantı, bir test başarılı olana kadar taslak kalır. Bu sürümde bağlayıcı çalıştırma kapalı olduğu için test adımı sunulmaz.
  </Accordion>

  <Accordion title="Bir anahtarı ya da gizli bilgiyi oluşturduktan sonra yeniden görebilir miyim?">
    Hayır. API anahtarları, imzalama anahtarları ve kimlik bilgileri yalnızca bir kez gösterilir. Kaybolursa anahtarı döndürün ya da gizli bilgiyi veya kimlik bilgilerini yenileyin.
  </Accordion>

  <Accordion title="Entegrasyon ayarları nereye gitti?">
    Entegrasyonlar artık kenar çubuğunda ayrı bir alandır. Eski ayar bağlantıları bu alanı açar; CRM yer imi kataloğu CRM kategorisi seçili açar.
  </Accordion>

  <Accordion title="Eşitleme başarısız olunca kayıt değerleri gösterilir mi?">
    Hayır. Sorunlar sekmesi yalnızca alan adlarını, türlerini ve korunmayan alanlar için uzunluklarını gösterir. Başarısız kayıtların saklanan kopyaları şifrelidir ve 30 gün sonra silinir.
  </Accordion>

  <Accordion title="Destek oturumu neden hiçbir şeyi değiştiremiyor?">
    Destek oturumları Entegrasyonlar alanının her yerinde salt okunurdur. Bakabilir, ancak bir bağlantıyı, anahtarı, politikayı ya da bağlayıcının izin listesini değiştiremez.
  </Accordion>
</Accordions>

## İlgili sayfalar [#i̇lgili-sayfalar]

* [Bağlı sistemler](/tr/connections)
* [Eşitleme ayrıntıları](/tr/connections/sync-details)
* [API ve anahtarlar](/tr/connections/api)
* [Webhook’lar](/tr/connections/webhooks)
* [BI veri kümeleri](/tr/connections/bi-datasets)
* [BI aracını SQL ile bağlama](/tr/connections/bi-sql-access)
* [Jira ile birlikte çalışma ve geçiş](/tr/connections/jira)
* [Zoom toplantıları](/tr/connections/zoom)