> ## 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. # Gelen lead webhook'u (Zapier) > Zapier ya da başka bir araçtan gelen kayıtları otomatik lead'e dönüştüren bağlantıyı kurmayı, alan eşlemeyi ve gelen kayıtları izlemeyi anlatır. Zapier Tables, bir form aracı ya da reklam platformu dışa aktarımı gibi bir kaynaktaki kayıtları Flextell'e otomatik olarak **Lead** olarak almak için bir bağlantı kurarsınız. Flextell size bir adres ve gizli anahtar verir. Kaynak aracınız her yeni kaydı bu adrese gönderir. Siz de kaynaktaki sütunları Lead alanlarıyla eşleştirirsiniz. Bu özellik **Bağlantılar → Entegrasyonlar** sayfasındaki **Zapier** kartından yönetilir. Zapier'a özel bir Flextell uygulaması yoktur. Bağlantı, Zapier'ın hazır **Webhooks by Zapier** eylemiyle kurulur. Aynı yöntemle `POST` isteği gönderebilen başka sistemleri de bağlayabilirsiniz. Bağlantıları görmek için **Entegrasyon Bağlantıları** için **Görüntüleme** iznine, oluşturmak için **Oluşturma** iznine, eşleme, etkinleştirme, duraklatma, hatalı kayıtları yeniden deneme ve anahtar yenileme için **Güncelleme** iznine, silmek için **Silme** iznine ihtiyacınız vardır. İzinler için klinik yöneticinize başvurun. ## Bağlantı oluşturma Önce Zapier'da kaynak tablonuzu ya da formunuzu hazırlayın. Eşleme aşamasında Lead'lerin düşeceği aşamayı seçmek isterseniz kliniğinizde aktif bir pipeline olmalıdır. **Bağlantılar → Entegrasyonlar** sayfasında **Otomasyon** sekmesindeki **Zapier** kartında **Şimdi Kur**'a basın. Açılan **Zapier Bağlantıları** penceresinde **Yeni Bağlantı**'ya basın. **Bağlantı Adı** alanına tabloyu tanıyacağınız bir ad yazın. Varsayılan ad `Zapier – Lead'ler`'dir. Aynı klinikte birden fazla bağlantı kurabilirsiniz, örneğin her Zapier tablosu için bir bağlantı. **Veri Türü** olarak **Lead** seçin, sonra **Bağlantı Oluştur**'a basın. Bağlantı **Taslak** durumunda açılır. **Zapier Kurulumu** adımındaki kartlara göre Zapier'da şunları yapın: | Zapier'da | Yazılacak değer | | - | - | | Tetikleyici → **App** | `Zapier Tables` | | Tetikleyici → **Event** | `New or Updated Record` | | Tetikleyici → **Table** | Lead'lerin bulunduğu tablo | | Eylem → **App** | `Webhooks by Zapier` | | Eylem → **Event** | `POST` | | Eylem → **URL** | Flextell'deki gönderim adresi (**Adresi Kopyala**) | | Eylem → **Payload Type** | `JSON` | | Eylem → **Data** | Boş bırakın. Tablodaki tüm sütunlar gönderilir. | | Eylem → **Headers** | Ad: `X-Flextell-Secret`, değer: gizli anahtar | Başlık adını ve gizli anahtarı kopyalama düğmeleriyle alın. Anahtar maskelidir. Görmek için **Anahtarı Göster**'e basın. Zapier'da eylemin **Test step** düğmesiyle bir kayıt gönderin. Flextell'de **Devam Et**'e basın. **Örnek Veri** adımı, ilk kayıt gelene kadar her 5 saniyede bir kontrol eder. Beklerken `İlk kayıt bekleniyor...` mesajını görürsünüz. İsterseniz **Şimdi Kontrol Et**'e basın. Kayıt gelince ` kayıt alındı. Bulunan sütunlar:` listesi çıkar. **Devam Et**'e basın. Eşleştirmeyi [Alan eşleme](#alan-eşleme) bölümündeki gibi yapıp **Kaydet ve Devam Et**'e basın. Son adımda özeti kontrol edin ve **Bağlantıyı Etkinleştir**'e basın. Zapier'da Zap'i yayınlayın (**Publish**). Tablodaki mevcut kayıtları da almak için Zapier'ın **Transfer** seçeneğini kullanın ya da Zapier Tables'ta satırları seçip **Send to Zap** deyin. Yalnızca bazı sütunları göndermek için Zapier kurulum ekranındaki **Yalnızca bazı sütunları göndermek istiyorum** bölümünü açın. Eylemin **Data** bölümüne her sütun için bir satır ekleyin: solda alan adı (örneğin `telefon`), sağda tablodaki sütun. Kaydın kimliğini (Record ID) `id` adıyla eklemeyi unutmayın. Zapier kullanmıyorsanız aynı adımlar **Kurulum** ve **Gönderim Ayarları** başlıklarıyla görünür. Test için tek bir kayıt ya da en fazla 500 kayıtlık bir dizi gönderebilirsiniz. Bağlantı etkinleştirilmeden önce gelen kayıtlar kaybolmaz. **Bekliyor** durumunda tutulur ve bağlantıyı etkinleştirdiğinizde işlenir. Pencereyi kapatırsanız taslak bağlantıya listeden tıklayarak kaldığınız adımdan devam edersiniz (**Kurulumu Sürdür**). ## Webhook adresi ve gizli anahtar Bağlantının bilgilerini istediğiniz zaman bağlantının **Detaylar** ekranındaki **Bağlantı Bilgileri** sekmesinde görürsünüz. | Alan | Açıklama | | - | - | | **Gönderim Adresi (URL)** | Kayıtların `POST` ile gönderileceği adres. Bağlantıya özeldir. | | **Başlık Adı (Header)** | Her istekte gönderilmesi gereken başlık: `X-Flextell-Secret`. | | **Gizli Anahtar (Header Değeri)** | Bu bağlantıya ait gizli değer. Başlığın değeri olarak girilir. | Gizli anahtarı yalnızca bağlantıyı düzenleme (**Güncelleme**) izni olanlar görür. Başkaları için alan boş görünür ve anahtar için yetkili bir kullanıcıya başvurmaları gerekir. ### Anahtarı yenileme Anahtar sızdıysa ya da kişi değiştiyse **Detaylar** ekranında **Diğer İşlemler → Anahtarı Yenile** (ya da **Bağlantı Bilgileri** sekmesindeki **Anahtarı Yenile**) seçeneğini kullanın. Onay penceresinde **Gizli Anahtarı Yenile** başlığını görürsünüz. Yenileme sonrası eski anahtar hemen geçersiz olur. Zapier'daki `X-Flextell-Secret` başlık değerini yeni anahtarla güncellemezseniz kayıtlar alınamaz. Entegratörler için istek biçimi, yanıt kodları ve sınırlar [Gelen lead webhook'u (API)](/api/webhooklar/gelen-lead-webhooku) sayfasındadır. ## Alan eşleme **Eşleştirme** adımında **Gelen Veri** sütunundaki her kaynak sütun için sağdaki **Flextell Alanı** listesinden bir hedef seçersiniz. Bir sütunu almak istemiyorsanız **Aktarma**'yı seçin. Flextell, sütun adına ve örnek değere bakarak öneri yapar (örneğin `telefon`, `gsm`, `cep` sütunlarını **Telefon**'a). Önerileri değiştirebilirsiniz. Kullanabileceğiniz Lead alanları: | Grup | Alanlar | | - | - | | **İletişim** | **Ad soyad**, **Ad**, **Soyad**, **Telefon**, **E-posta** | | **İçerik** | **Notlar**, **Mesaj**, **Kaynak sayfa URL'si**, **Beklenen değer** | | **Pazarlama** | **UTM kaynağı**, **UTM ortamı**, **UTM kampanyası**, **UTM terimi**, **UTM içeriği** | | **Meta Reklamları** | **Meta kampanya adı**, **Meta kampanya kimliği**, **Meta reklam seti adı**, **Meta reklam seti kimliği**, **Meta reklam adı**, **Meta reklam kimliği**, **Meta form adı**, **Meta form kimliği**, **Meta platformu (fb/ig)** | Eşleme kuralları: * Bir Flextell alanı yalnızca bir sütuna eşlenebilir. Başka yerde kullanılan alan listede `(eşleştirildi)` olarak görünür ve seçilemez. * Etkinleştirmek için **Ad soyad**, **Ad**, **Soyad**, **Telefon** ve **E-posta** alanlarından en az biri eşlenmiş olmalıdır. Aksi hâlde `Kimlik alanı eşleştirilmedi` uyarısını görürsünüz. * Zapier Tables `new.` ve `old.` ile başlayan çift sütun gönderir. `new.` karşılığı olan `old.` sütunlar gizlenir. Hepsini görmek için **Tüm alanları göster** anahtarını açın. * Ad ve soyad ayrı sütunlardaysa onlar kullanılır. Tek bir **Ad soyad** sütunu varsa son sözcük soyadı olur. * Telefon numarası rakamlara indirgenir. E-posta küçük harfe çevrilir. Geçersiz e-posta alınmaz. **Beklenen değer** `1.250,50` gibi yerel yazımları kabul eder. ### Kayıt kimliği sütunu **Kayıt Kimliği Sütunu** isteğe bağlıdır ama önerilir. Kaynak kaydın kendi kimliğini içeren sütunu seçerseniz aynı kayıt tekrar geldiğinde yeni Lead açılmaz, mevcut Lead güncellenir. Zapier Tables için bu genellikle `id` ya da `new.id` sütunudur. Seçmezseniz **Kullanma** kalır. Kayıt kimliği güncellemesinde eşlediğiniz her değer Lead'in üzerine yazılır. Lead'in aşaması, atananı ve kaynağı değişmez. ### Bağlantı ayarları Aşağıdaki ayarların hepsi isteğe bağlıdır. Boş bıraktığınızda alan **Otomatik** görünür. | Ayar | Boş bırakılırsa | | - | - | | **Yeni kayıtların aşaması** | Lead, aktif pipeline'ın ilk aşamasına eklenir. Yalnızca aktif pipeline'ın aşamaları listelenir. | | **Birleştirilen kayıtların aşaması** | Mevcut bir Lead'e birleştirilen kayıtlarda aşama değişmez. Seçerseniz birleştirilen Lead bu aşamaya taşınır. Hastaya dönüştürülmüş Lead taşınmaz. | | **Lead kaynağı** | Meta reklam alanları eşlenmişse **Meta Ads** kaynağı, değilse entegrasyon adıyla (örneğin `Zapier`) bir kaynak kullanılır. | | **Atanan kişi** | Kliniğinizdeki otomatik atama kuralları uygulanır. | | **Birleştirilen kayıtların kaynağını güncelle** | Kapalıyken birleştirilen Lead'in kaynağı değişmez. Açıksa yeni Lead'lere verilen kaynakla değiştirilir. | **Lead kaynağı** alanına listede olmayan bir ad yazarsanız `“” kaynağını oluştur` seçeneği çıkar. Bunun için kaynak oluşturma izni gerekir. ### Aynı kişi tekrar gelirse Kayıt kimliğiyle eşleşen Lead yoksa Flextell, kliniğinizde aynı telefon numarasına, bulunamazsa aynı e-postaya sahip bir Lead arar. Bulursa yeni Lead açmaz. Mevcut Lead'in yalnızca boş alanlarını doldurur ve kaydı **Birleştirildi** olarak işaretler. Bulamazsa yeni Lead oluşturur (**Oluşturuldu**) ve hasta kaydını da bağlar. Eşlemeyi sonradan değiştirmek için bağlantı listesinde satırın menüsünden **Eşleştirmeyi Düzenle**'yi seçin ve **Kaydet**'e basın. ## Gelen kayıtlar Bağlantı listesinde her bağlantı için **Ad**, **Veri Türü**, **Durum** (**Taslak**, **Aktif**, **Duraklatıldı**), **İşlendi**, **Bekliyor**, **Hatalı** ve **Son Kayıt** sütunlarını görürsünüz. Hatalı sayısı sıfırdan büyükse kırmızı görünür. Ayrıntılar için satırın menüsünden **Detaylar**'ı açın ve **Gelen Kayıtlar** sekmesine geçin. Ekran görünürken 10 saniyede bir kendini yeniler. Üstteki düğmelerle kayıtları duruma göre süzersiniz: **Tümü**, **İşlendi**, **Bekliyor**, **Hatalı**, **Atlandı**. | Durum | Anlamı | | - | - | | **Bekliyor** | Kayıt alındı, henüz işlenmedi. Bağlantı **Taslak** ya da **Duraklatıldı** ise etkinleştirilene kadar bekler. | | **İşlendi** | Kayıt işlendi. **Sonuç** sütununda **Oluşturuldu**, **Güncellendi** ya da **Birleştirildi** yazar. | | **Hatalı** | Kayıt işlenemedi. **Hata** sütunu nedeni gösterir. | | **Atlandı** | Yapılacak bir şey yoktur. Kayıt, daha önce yazıldığı Lead silindiği için atlanmıştır. | **Kayıt** sütunundaki bağlantı, oluşan Lead'in sayfasını açar. **Veriyi Gör** ile kaynaktan gelen ham içeriği **Okunabilir** ve **Ham JSON** sekmelerinde görürsünüz. Bağlantıdan oluşan bir Lead'in sayfasında **İçe Aktarılmış Kayıt** bildirimi çıkar. **Gelen Veriyi Gör** düğmesi için **Entegrasyon Bağlantıları** için **Görüntüleme** izni gerekir. Bildirim yalnızca bir **Kayıt Kimliği Sütunu** seçtiyseniz görünür. ## Hatalı kayıtları yeniden deneme Hata mesajları şunlardır: | Mesaj | Ne yapmalı | | - | - | | `Kayıtta eşleştirilen ad, telefon veya e-posta alanlarının hiçbirinde değer yok.` | Bir kimlik sütununu eşleyin. Sütunlar doluysa değerlerin geçerli olduğunu kontrol edin: geçersiz e-posta ya da boş veya çok uzun telefon alınmaz. | | `Bu kayıt türü artık içe aktarılamıyor.` | Kayıt türü artık desteklenmiyor. Destek ekibine başvurun. | | `Kayıt işlenemedi. Yeniden deneyin; sorun sürerse destek ekibiyle iletişime geçin.` | Yeniden deneyin. Sorun sürerse destek ekibine yazın. | Gerekiyorsa **Eşleştirmeyi Düzenle** ile eşlemeyi düzeltin. **Gelen Kayıtlar** sekmesinde tek bir kayıt için satırdaki **Yeniden Dene**'ye, tüm hatalı kayıtlar için **Hatalıları Yeniden Dene**'ye basın. Düğme yalnızca hatalı kayıt varsa görünür. Sonuçta ` kayıt yeniden işlenmek üzere sıraya alındı.` mesajını görürsünüz. Yeniden deneme yalnızca **Hatalı** kayıtlar içindir. **Atlandı** kayıtları yeniden denenemez. Bağlantı **Aktif** değilse yeniden denenen kayıt **Bekliyor** durumuna döner ve bağlantıyı etkinleştirdiğinizde işlenir. ## Bağlantıyı duraklatma Kaynak tarafta toplu bir değişiklik yapacaksanız ya da kayıt akışını geçici olarak durdurmak istiyorsanız bağlantıyı duraklatın. **Detaylar** ekranında **Duraklat**'a basın. `Bağlantı duraklatıldı. Gelen kayıtlar bekletilecek.` mesajını görürsünüz. Duraklatılmış bağlantı kayıt almaya devam eder ama Lead oluşturmaz. Kayıtlar **Bekliyor** durumunda toplanır. Devam etmek için **Etkinleştir**'e basın. Bekleyen kayıtlar işlenir (`Bağlantı etkinleştirildi. Bekleyen kayıtlar işleniyor.`). Bağlantıyı tamamen kaldırmak için **Diğer İşlemler → Sil**'i seçin. Silinen bağlantının adresine gönderilen kayıtlar artık alınmaz. Daha önce oluşan Lead'ler silinmez. ## Sorun giderme | Belirti | Olası neden | | - | - | | Kayıtlar **Bekliyor**'da kalıyor | Bağlantı **Taslak** ya da **Duraklatıldı**. **Bağlantıyı Etkinleştir**'e ya da **Etkinleştir**'e basın. | | Zapier `401` hatası veriyor | `X-Flextell-Secret` başlığı eksik ya da yanlış. Anahtar yenilendiyse Zap'teki değeri güncelleyin. | | Zapier `404` hatası veriyor | Adres yanlış ya da bağlantı silinmiş. | | **Örnek Veri** adımında sütun görünmüyor | Henüz kayıt gelmedi. Zapier'da **Test step**'i çalıştırın. | | Aynı kişi için tekrar tekrar Lead açılıyor | **Kayıt Kimliği Sütunu** seçilmemiş ve telefon ya da e-posta eşleşmiyor. | | Meta reklamından gelen kayıtlar farklı kaynakta | **Lead kaynağı** boşsa Meta alanı eşlenmiş kayıtlar **Meta Ads** kaynağına gider. Başka bir kaynak için **Lead kaynağı** seçin. | ## İlgili sayfalar Entegrasyon kartlarına genel bakış. Lead kaynaklarını yönetin. Pipeline aşamalarını tanıyın. Entegratörler için istek biçimi ve sınırlar. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.