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

# Entegrasyonlara genel bakış

> Hangi entegrasyonun panelden, hangisinin yalnızca API ile kurulabildiğini ve henüz kullanılamayan entegrasyonları özetler.

Flextell, mesajlaşma kanallarını, takvimi, e-Fatura hesaplarını, içe aktarma kaynaklarını ve lead akışını dış sistemlere bağlar. Her entegrasyon aynı yerden kurulamaz. Bazıları panelden, bazıları yalnızca API ile, bazıları ise henüz hiçbir yerden kurulamaz.

Bu sayfa, bir entegrasyona başlamadan önce nereden kurulacağını gösterir. Katalogdaki kartları panelde **Bağlantılar → Entegrasyonlar** altında görürsünüz. Panel kullanımı için [Entegrasyonlar](/panel/baglantilar/entegrasyonlar) sayfasına bakın.

## Destek tablosu

| Entegrasyon | Panel | API | Durum |
| - | - | - | - |
| WhatsApp | Kanal oluşturma, QR eşleştirme, bağlantı kontrolü, geçmiş eşitleme, webhook ayarları, düzenleme | `/api/v1/channels` ve `/api/v1/channels/{id}/whatsapp/*` | Kullanılabilir |
| Telegram | Yalnızca kanal kaydı oluşturur, botu bağlamaz | `POST` ve `PUT /api/v1/channels` içinde `bot_token` | Bot bağlantısı yalnızca API ile |
| Website (sohbet widget'ı) | Kanal, **Widget Ayarları**, gömme kodu, token yenileme | `/api/v1/channels` ve `/api/v1/channels/{id}/widget*` | Kullanılabilir |
| Zapier (gelen lead webhook'u) | **Yeni Bağlantı** sihirbazı | `/api/v1/integration-connections*` | Kullanılabilir |
| Google Calendar | Yalnızca kayıtlı bağlantı bilgisini gösterir | Yalnızca okuma: `GET /api/v1/integrations/{id}` | Panelden ve API'den kurulamaz |
| Nilvera ve NES e-Fatura | Hesapları, serileri ve kontörü gösterir | `/api/v1/invoices/accounts` ile tam CRUD | Hesap ekleme yalnızca API ile |
| Estesoft Stella, Dr.DENTES | **Bağlantılar → İçe Aktar** | `/api/v1/import/*` | Kullanılabilir |
| Instagram | Yalnızca kanal kaydı | Yalnızca kanal kaydı | Kullanılamıyor |
| Outlook Calendar | Kart devre dışı, **Yakında** | Yok | Kullanılamıyor |
| Gmail | Kart **Yakında** uyarısı verir | Yok | Kullanılamıyor |

<Info>
  Entegrasyon kataloğunu `GET /api/v1/integrations` ile listelersiniz. Bu uç için `View:Integrations` izni ve `integrations:read` scope gerekir. Ayrıntılar için [Entegrasyonlar kaynak rehberi](/api/kaynaklar/entegrasyonlar) sayfasına bakın.
</Info>

Gelen lead webhook'u (Zapier) için [Gelen lead webhook'u](/api/webhooklar/gelen-lead-webhooku) sayfasına geçin.

## Mesajlaşma kanalları

Kanallar `/api/v1/channels` kaynağı üzerinden yönetilir. Kaynağın tamamı için [Kanallar](/api/kaynaklar/kanallar) sayfasına bakın.

<CardGroup cols={2}>
  <Card title="WhatsApp" icon="message-circle" href="/api/entegrasyonlar/whatsapp">
    Panelden ve API'den kurulur. QR eşleştirme, bağlantı durumu ve geçmiş eşitleme.
  </Card>

  <Card title="Telegram" icon="send" href="/api/entegrasyonlar/telegram">
    Bot bağlantısı yalnızca API ile kurulur. Panel yalnızca kanal kaydı oluşturur.
  </Card>
</CardGroup>

### Telegram

Panelde **Telegram Kanalı Oluştur** diyaloğu yalnızca kanal kaydını oluşturur. Diyalog şu uyarıyı gösterir: "Bu işlem yalnızca kanal kaydını oluşturur. Bot bağlantısının ayrıca kurulması gerekir; bu ekranda henüz bot bağlantısı kurulamıyor." Botu bağlamak için BotFather'dan aldığınız token ile API'yi kullanın:

```bash theme={null}
curl -X POST https://app.flextell.ai/api/v1/channels \
  -H "Authorization: Bearer <access_token>" \
  -H "X-Tenant: <tenant_id>" \
  -H "Content-Type: application/json" \
  -d '{"type": "telegram", "name": "Telegram Destek", "bot_token": "<bot_token>"}'
```

Token oluşturma ve hata kodları için [Telegram](/api/entegrasyonlar/telegram) sayfasına bakın.

### Website widget'ı

Website kanalı panelden tam olarak yönetilir: kanal oluşturma, **Widget Ayarları**, gömme kodu ve token yenileme. API tarafı için [Web sitesi widget'ı](/api/webhooklar/web-sitesi-widgeti) sayfasına bakın.

### WhatsApp

WhatsApp numarasını panelden QR ile eşleştirebilir ya da aynı adımları API ile yürütebilirsiniz. Panel adımları için [WhatsApp](/panel/baglantilar/whatsapp), API adımları için [WhatsApp entegrasyonu](/api/entegrasyonlar/whatsapp) sayfasına bakın.

<Note>
  Kanal silme panelde de API'de de hesap parolanızı ister. Panel silme penceresinde **Parolanız** alanını gösterir ve değeri `current_password` olarak gönderir; API'de aynı alanı `DELETE /api/v1/channels/{id}` gövdesinde siz gönderirsiniz. Parola yanlışsa panel alanın altında "Parola hatalı." yazar, API `422` döner. Silme penceresi, kanalla birlikte silinecek ve kalacak kayıtları da listeler. Panel adımları için [Kanallar](/panel/baglantilar/kanallar) sayfasına bakın.
</Note>

## Takvim entegrasyonları

### Google Calendar

Google Calendar bağlantısı kullanıcıya özeldir: her doktor kendi Google hesabını bağlar. Flextell randevuları doktorun varsayılan takvimine tek yönlü gönderir.

Yeni panelde Google Calendar kartı yalnızca **Detaylar** ekranını açar. Bu ekran kayıtlı bağlantıyı (**Bağlantı Kaydı Var** / **Bağlantı Kaydı Yok**), entegrasyon durumunu ve bağlantı kapsamını (**Kullanıcıya Özel** / **Kliniğe Özel**) gösterir. Ekran şunu belirtir: "Hesap bağlama, bağlantıyı kaldırma ve takvim seçimi henüz bu ekrandan yapılamıyor."

API de yalnızca okuma sunar (`GET /api/v1/integrations/{id}`). Google hesabını bağlayan, takvim seçen ya da bağlantıyı kaldıran bir API ucu yoktur.

### Outlook Calendar

Outlook Calendar kataloğta bulunur ama devre dışıdır. Kart **Yakında** olarak görünür. Bkz. [Henüz kullanılamayanlar](#henüz-kullanılamayanlar).

## e-Fatura

Nilvera ve NES e-Fatura hesapları kliniğe özeldir ve bir API anahtarıyla çalışır.

* **Panel:** **Fatura Hesapları** kartı hesapları, mevcut serileri ve kontör bilgisini (**Toplam**, **Kullanılan**, **Kalan**) gösterir. Ekran şunu belirtir: "Hesap ekleme, düzenleme, silme ve varsayılan seri değiştirme henüz bu ekrandan yapılamıyor."
* **API:** `/api/v1/invoices/accounts` altında hesap ekleme, düzenleme ve silme tam olarak desteklenir.

<Note>
  Flextell hesabı kaydederken API anahtarını sağlayıcıda denemez. Yanlış anahtar sonradan `INVOICE_SERIES_LOOKUP_FAILED`, `INVOICE_CREDIT_LOOKUP_FAILED` veya `INVOICE_SEND_FAILED` gibi bir hatayla ortaya çıkar.
</Note>

Hesap alanları ve örnekler için [e-Fatura entegrasyonu](/api/entegrasyonlar/e-fatura), fatura kaynağı için [Faturalar](/api/kaynaklar/faturalar) sayfasına bakın.

## İçe aktarma kaynakları

**Bağlantılar → İçe Aktar** sayfası ve `/api/v1/import/*` uçları iki kaynağı destekler. Panel kullanımı için [İçe aktarma](/panel/baglantilar/ice-aktarma), API için [İçe aktarma kaynak rehberi](/api/kaynaklar/ice-aktarma) sayfasına bakın.

| Kaynak | Kimlik bilgileri | Aktarılan veri |
| - | - | - |
| Estesoft Stella | `Base URL`, `Kullanıcı Adı`, `Şifre`, `API Key` | Kullanıcılar, tedaviler, odalar, ürünler, hastalar, banka hesapları, satışlar, muhasebe hareketleri, notlar, dosyalar, randevular |
| Dr.DENTES | `Base URL`, `API Key` | Hekimler, tedaviler, hastalar, randevular. Diş ünitelerinin her biri `Ünite :number` adlı bir odaya dönüşür. |

<Warning>
  Dr.DENTES için API erişimi ve adresini Dr.DENTES'ten almanız gerekir. Ayrıca Flextell'in sunucu IP adresinin Dr.DENTES API izin listesine eklenmesini onlardan istemeniz gerekir.
</Warning>

Dr.DENTES her çalıştırmada tam ve tekrarlanabilir bir eşitleme yapar; artımlı (`delta`) mod yoktur. Kaynak kimlik bilgilerini kaydederken Flextell bunları denemez.

## Henüz kullanılamayanlar

Aşağıdaki entegrasyonlar katalogda ya da panelde görünebilir ama çalışmaz. Bunlar için entegrasyon geliştirmeyin.

| Entegrasyon | Ne görürsünüz | Durum |
| - | - | - |
| Instagram | Panel yalnızca bir kanal kaydı oluşturur: "Instagram hesabını bağlama ve mesajlaşma henüz desteklenmiyor." | Hesap bağlama ve mesajlaşma yok. Kayıt oluşturmak mesaj gönderip almayı sağlamaz. |
| Outlook Calendar | Kart **Yakında** olarak devre dışıdır. | Kullanılamıyor. |
| Gmail | Karta tıkladığınızda "Bu entegrasyon yakında kullanıma açılacak." uyarısı çıkar. | Kullanılamıyor. |
| Excel / CSV ile içe aktarma | Yeni panelde ve API'de yok. | Kullanılamıyor. Ürün, tedavi ve fatura için de içe aktarma yoktur. |

<Note>
  `GET /api/v1/channels/capabilities` yanıtı Instagram için medya gönderimini listeleyebilir. Bu yalnızca bildirimdir, Instagram üzerinden mesaj gönderilemez.
</Note>

## İlgili sayfalar

<CardGroup cols={2}>
  <Card title="Kanallar" icon="messages-square" href="/api/kaynaklar/kanallar">
    Kanal kaynağı, uç noktalar ve hata kodları.
  </Card>

  <Card title="Gelen lead webhook'u" icon="webhook" href="/api/webhooklar/gelen-lead-webhooku">
    Zapier ve diğer sistemlerden lead alma.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.