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

# Entegrasyonlar

> Integration modeli — firmaya bağlı dış servisler.

Entegrasyon (`Integration`), firmanın dış servislerle (Google Calendar, e-Fatura entegratörü, LLM sağlayıcı vb.) kurduğu OAuth/API bağlantısıdır.

## Yapı

| Alan           | Açıklama                                   |
| -------------- | ------------------------------------------ |
| `type`         | `IntegrationType` enum                     |
| OAuth alanları | access\_token, refresh\_token, expires\_at |
| API alanları   | base\_url, api\_key (entegrasyona göre)    |
| `metadata`     | Sağlayıcıya özgü ek veri                   |

## Türler (`IntegrationType` enum)

| Değer      | Kullanım                                |
| ---------- | --------------------------------------- |
| `Chat`     | Sohbet sağlayıcısı                      |
| `Llm`      | LLM sağlayıcısı (OpenAI, Anthropic vb.) |
| `Calendar` | Google Calendar                         |
| `Invoice`  | e-Fatura entegratörü (Nilvera, NES)     |
| `Email`    | E-posta sağlayıcısı                     |
| `Crm`      | Harici CRM bağlantısı                   |

## Kullanıcı bazında bağlama

Bazı entegrasyonlar firma seviyesinde, bazıları kullanıcı seviyesinde bağlanır. Örnek: Google Calendar her doktor için ayrı bağlanır (kişisel takvim); e-Fatura entegratörü firma genelinde tektir.

## OAuth akışı

```mermaid theme={null}
sequenceDiagram
    participant U as Kullanıcı
    participant P as Flextell Paneli
    participant S as Dış servis

    U->>P: Entegrasyonlar → Bağla
    P->>S: OAuth onay isteği
    S->>U: İzin ekranı
    U->>S: İzin ver
    S-->>P: Code + token değişimi
    P->>P: Integration kaydı yarat
    P-->>U: Bağlandı
```

## Yetki kaybedildiğinde

Refresh token süresi dolduğunda veya kullanıcı dış serviste yetkiyi geri aldığında ilgili işlem hata verir; entegrasyon yeniden bağlanmalı.

## Sonraki adımlar

<CardGroup cols={2}>
  <Card title="İçe Aktar" icon="upload" href="/documentation/connections/import">
    CSV/Excel toplu veri içe aktarımı.
  </Card>

  <Card title="Uygulamalar" icon="grid" href="/documentation/connections/applications">
    Dış OAuth uygulamaları.
  </Card>
</CardGroup>