Entegrasyonlara genel bakış

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

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 sayfasına bakın.

Gelen lead webhook’u (Zapier) için Gelen lead webhook’u sayfasına geçin.

Mesajlaşma kanalları

Kanallar /api/v1/channels kaynağı üzerinden yönetilir. Kaynağın tamamı için Kanallar sayfasına bakın.

Panelden ve API’den kurulur. QR eşleştirme, bağlantı durumu ve geçmiş eşitleme.

Bot bağlantısı yalnızca API ile kurulur. Panel yalnızca kanal kaydı oluşturur.

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:

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 sayfasına bakın. 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’ı sayfasına bakın.

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, API adımları için WhatsApp entegrasyonu sayfasına bakın.

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 sayfasına bakın.

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.

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.

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.

Hesap alanları ve örnekler için e-Fatura entegrasyonu, fatura kaynağı için 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, API için İçe aktarma kaynak rehberi 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.

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.

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.

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

Başlarken

Kimlik Doğrulama

Çok Kiracılılık

İstek Kuralları

Kaynak Rehberleri

Gerçek Zamanlı

Webhook'lar ve Açık Uçlar

Entegrasyonlar

Rehberler

Kaynaklar

Entegrasyonlara genel bakış

Destek tablosu

Mesajlaşma kanalları

WhatsApp

Telegram

Telegram

Website widget’ı

WhatsApp

Takvim entegrasyonları

Google Calendar

Outlook Calendar

e-Fatura

İçe aktarma kaynakları

Henüz kullanılamayanlar

İlgili sayfalar

Kanallar

Gelen lead webhook'u

​Destek tablosu

​Mesajlaşma kanalları

WhatsApp

Telegram

​Telegram

​Website widget’ı

​WhatsApp

​Takvim entegrasyonları

​Google Calendar

​Outlook Calendar

​e-Fatura

​İçe aktarma kaynakları

​Henüz kullanılamayanlar

​İlgili sayfalar

Kanallar

Gelen lead webhook'u

Destek tablosu

Mesajlaşma kanalları

Telegram

Website widget’ı

WhatsApp

Takvim entegrasyonları

Google Calendar

Outlook Calendar

e-Fatura

İçe aktarma kaynakları

Henüz kullanılamayanlar

İlgili sayfalar