--- title: "ThunderPhone'u Zapier ile kullanın" description: "Zapier'daki ThunderPhone uygulamasını kuruluşunuza bağlayın ve her arama sona erdiğinde çalışan bir Zap oluşturun." --- [Zapier](https://zapier.com), uygulamaları Zap adı verilen otomatik iş akışlarıyla bağlar. Zapier'daki ThunderPhone uygulaması şunları ekler: - **Tetikleyiciler:** **Arama Tamamlandı**, telefon, web veya test araması sona erdiğinde tetiklenir. **Arama Değerlendirildi**, tamamlanmış bir aramanın değerlendirmesi kullanılabilir olduğunda tetiklenir. - **Eylemler:** **Giden Arama Yap**, **Kişileri Kampanyaya Ekle** ve **Kampanyayı Başlat**. - **Arama:** **Arama Bul**, bir aramayı kimliğine göre bulur ve kullanılabilir olduğunda transkripti ile imzalı kayıt URL'siyle birlikte döndürür. Uygulamayı [Zapier'da ThunderPhone](https://zapier.com/apps/thunderphone/integrations) sayfasında bulabilirsiniz. Zapier'i ThunderPhone ile kullanmanın iki yoluna genel bakış için [Zapier entegrasyonu sayfasına](https://thunderphone.com/integrations/zapier) bakın. ## Kuruluşunuzu bağlayın Uygulama OAuth üzerinden bağlanır. ThunderPhone'da oturum açar ve bir kuruluş için erişimi onaylarsınız; Zapier'a hiçbir API anahtarı kopyalanmaz. Zap düzenleyicisinde **ThunderPhone** öğesini arayın (Beta etiketiyle gösterilir) ve bir tetikleyici veya eylem seçin. Zapier bir hesap istediğinde yeni bir hesap bağlayın. Zapier, ThunderPhone oturum açma penceresini açar. Oturum açın, istenen izinleri kontrol edin, kuruluşu seçin ve **Onayla** seçeneğini belirleyin. Uygulama, yapay zeka ajanlarınızı ve telefon numaralarınızı okuma, aramaları ve kampanyaları okuma ve yazma, webhook uç noktaları gibi entegrasyonları yönetme ve hesap e-posta adresinizi görme izni ister. Zapier, bağlantıyı onayladığınız kuruluşun adıyla adlandırır; böylece birden fazla kuruluşa ait olduğunuzda bağlantıları birbirinden ayırt edebilirsiniz. Bu kuruluşta yönetici veya sahip rolüne sahip bir hesapla bağlanın. Bir tetikleyici Zap'ini açmak veya kapatmak ve her eylem bu rolü gerektirir. Halihazırda açık olan bir tetikleyici Zap'i, rol değiştirildikten veya bağlantı iptal edildikten sonra da arama etkinliklerini almaya devam eder. Bunları durdurmak için kapatın. Arama Bul, tüm üyeler için çalışır. Uygulamanın kendine ait bir ThunderPhone ücreti yoktur. Yaptığı veya başlattığı aramalar normal ThunderPhone ücretleriniz üzerinden faturalandırılır ve Zapier, Zapier planınızdaki görevleri sayar. ## İlk Zap'inizi oluşturun Bu Zap, bir çağrı her sona erdiğinde Google E-Tablosu'na bir satır ekler. Oluşturucuda bir ajan açın, **Konuş** seçeneğine tıklayın ve çağrıyı sonlandırın. Oluşturucu test çağrıları Çağrı Tamamlandı etkinliğini tetikler; bu nedenle tetikleyiciye yüklemesi için yakın tarihli bir çağrı sağlar. Tetikleyici uygulaması olarak **ThunderPhone** seçin, etkinliği **Çağrı Tamamlandı** olarak ayarlayın ve ThunderPhone bağlantınızı seçin. Tetikleyiciyi test edin. Zapier, canlı bir etkinlikle aynı yapıda örnek olarak en son tamamlanan çağrılarınızı yükler. E-tablo satırı oluşturan bir Google E-Tablolar işlemi ekleyin. Başlık satırı olan bir sayfa seçin, ardından her sütunu tetikleyicideki bir alanla eşleyin (aşağıdaki tabloya bakın). Zap'i yayınlayın ve etkinleştirin. Etkinleştirmek, ThunderPhone kuruluşunuzda **Zapier: Çağrı Tamamlandı** adlı bir webhook uç noktası oluşturur. Zap'i devre dışı bırakmak bu uç noktayı siler. Oluşturucuda başka bir test çağrısı yapın. Çağrı sona erdiğinde Zap çalışır ve bir satır görünür. Yararlı sütunlar: | Sütun | Çağrı Tamamlandı alanı | |---|---| | Çağrı Kimliği | Çağrı Kimliği | | Ajan | Ajan Adı | | Yön | Yön | | Kimden | Kaynak Numara | | Kime | Hedef Numara | | Başlangıç | Başlangıç Zamanı | | Bitiş | Bitiş Zamanı | | Süre (sn.) | Saniye Cinsinden Süre | | Durum | Durum | | Çağrı bitiş nedeni | Bitiş Nedeni | | Çağrı bağlantısı | `https://app.thunderphone.com/dashboard/call-history/` yazın, ardından Çağrı Kimliği'ni ekleyin | Çağrı bağlantısı, kuruluşunuzun üyeleri için çağrıyı ThunderPhone panosunda transkripti ve kaydıyla birlikte açar; dolayısıyla e-tablonun bunlardan herhangi birini tutması gerekmez. Etkinlik ayrıca sıra listesi olarak transkripti ve süresi dolan imzalı bir bağlantı olan Kayıt URL'sini taşıyabilir. Bunları yalnızca e-tablonun ihtiyacı varsa ekleyin. Çağrı transkriptleri, özetleri ve kayıtları kişisel veya sağlık bilgileri içerebilir. Bunları yalnızca kuruluşunuzun bu veriler için kullanmasına izin verilen uygulamalara, sağlık bilgileri söz konusuysa bir BAA kapsamında gönderin ve yalnızca ihtiyacınız olan alanları saklayın. Tüm alanlar için [`telephony.complete` / `web.complete`](/tr/webhooks/call-complete) bölümüne bakın. Her teslimat imzalanır. Uygulama, Zap çalışmadan önce `X-ThunderPhone-Signature` HMAC'ini uç noktanın gizli anahtarıyla doğrular ve imzasız veya geçersiz her teslimatı durdurur. Zapier bir teslimatı kabul etmezse ThunderPhone bunu 24 saate kadar yeniden dener. [Webhook genel bakışı](/tr/webhooks/overview) bölümüne bakın. ## Tetikleyiciler, eylemler ve arama **Çağrı Değerlendirildi**, Çağrı Kimliği, Ajan Kimliği, Ajan Adı ve değerlendirme bilgilerini sunar: Değerlendirme Kimliği, Puan, Çağrı Sonucu, Özet, Değerlendirici Modeli ve Değerlendirme Zamanı. Bir Zap'i etkinleştirmek, **Zapier: Call Graded** adlı bir uç nokta oluşturur. Bir çağrı birden fazla kez değerlendirilebilir ve tamamlanan her değerlendirme çalıştırması tetikleyiciyi çalıştırır. Bkz. [`call.graded`](/tr/webhooks/events). **Çağrı Bul**, son çağrıların açılır listesinden seçilebilen bir Çağrı Kimliği alır. Çağrının ajanını, yönünü, numaralarını, başlangıç ve bitiş zamanlarını, durumunu, bitiş nedenini, değerlendirme puanını ve çağrı sonucunu, transkripti ve mevcut olduğunda imzalı kayıt URL'sini döndürür. Bilinmeyen bir Çağrı Kimliği, hata yerine sonuç döndürmez. **Giden Çağrı Başlat** şunları alır: | Alan | Anlamı | |---|---| | Ajan | Kaydedilmiş bir ajan. Açılır listede ajanlarınız yer alır. | | Hedef Numara | `+14155552671` gibi E.164 biçimindeki hedef numara. | | Kaynak Numara | Açılır listede yalnızca giden çağrılar için etkinleştirilmiş numaralar yer alır. | | Değişkenler | Ajan istemindeki yer tutucular için değerlerden oluşan isteğe bağlı JSON nesnesi. | | İdempotensi Anahtarı | Tetikleyiciden veya kaynak kayıttan alınan sabit bir kimlik. Zorunludur. | Çağrı Kimliği, Durum ve İdempotent Yeniden Yürütme değerlerini döndürür. **Kampanyaya Kişi Ekle**, taslak bir kampanyaya kişi ekler. Tek bir kişi için E.164 biçiminde **Telefon Numarası** alanını ve isteğe bağlı olarak özellikleri kampanya değişkenleri hâline gelen bir JSON nesnesi olan **Kişi Değişkenleri** alanını doldurun. Toplu ekleme için **Kişiler JSON** alanını en fazla 5.000 nesneden oluşan bir diziyle doldurun. Her nesnede `phone_number` gerekir ve diğer özellikleri değişken hâline gelir. Her kişi reddedildiğinde adım başarısız olur; yalnızca bazıları reddedildiğinde **Kısmi Başarı** durumunu ayarlar. **Kampanyayı Başlat**, en az bir kişisi bulunan bir kampanyayı başlatır veya sürdürür. **Ücretlendirme Onayı** gerektirir. Bkz. [Giden kampanyalar](/tr/guides/outbound-campaigns). ## Bir Zap çağrı başlatmadan önce Giden Çağrı Başlat ve Kampanyayı Başlat, gerçek telefon numaralarını arar ve ücretlendirilebilir çağrılar başlatır. - ThunderPhone, kuruluşunuzdan giden çağrılarının TCPA ve diğer arama yasalarına uygun olduğunu onaylamasını isterse, bir Zap çağrı başlatabilmeden önce bir yönetici bu onayı panoda kaydetmelidir. - Kaynak Numara, giden çağrılar için etkinleştirilmiş olmalıdır. Kendi operatörünüzden getirdiğiniz numaralar, doğrulandıktan sonra uygun olur. ThunderPhone tarafından sağlanan numaralar başlangıçta yalnızca gelen çağrılar içindir; bu numaralar için panodan giden çağrı erişimi talep edebilirsiniz. Bkz. [Telefon numarası alın](/tr/guides/get-a-phone-number). - Giden Çağrı Başlat, bir **İdempotensi Anahtarı** gerektirir. ThunderPhone etkinlik kimliği veya CRM kayıt kimliği gibi, tetikleyiciden ya da kaynak kayıttan sabit bir kimlik eşleyin. Zapier adımı yeniden denerse ThunderPhone anahtarı tanır ve ikinci bir çağrı başlatmak yerine özgün çağrıyı döndürür. Zaman damgalarından, rastgele değerlerden veya yalnızca Zap kimliğinden kaçının. - Kampanyayı Başlat, Zap'in hesabınızda ücretlendirilebilir giden çağrılar başlatabileceğini onaylayan **Ücretlendirme Onayı** gerektirir. - Kuruluşunuz, her numarayı aramak için onaya sahip olmaktan ve geçerli arama yasalarına uymaktan sorumludur. Bkz. [giden arama yasaları](/tr/guides/outbound-calling-laws). Bir idempotensi anahtarı kuruluşunuz genelinde benzersizdir ve en fazla 128 karakter olabilir. Anahtarı farklı bir ajan, numara veya değişkenlerle yeniden kullanmak çakışma nedeniyle başarısız olur. Bu nedenle iki Zap aynı kayıtla ilgili çağrı başlatabiliyorsa, kayıt kimliğinden önce her Zap için ayrı bir sabit önek kullanın. [Giden çağrılar başlatma](/tr/guides/place-outbound-calls), bu eylemin arkasındaki API'yi açıklar. ## Örnek Zap'ler - **CRM'ye tamamlanan çağrı.** Tamamlanan her çağrının durumunu, bitiş nedenini ve dökümünü içeren bir etkinlik kaydedin. - **Takip için derecelendirilen çağrı.** Çağrı sonucuna veya puanına göre filtreleyin ve çağrıyı doğru takip iş akışına yönlendirin. - **Kampanyaya yeni potansiyel müşteri.** Potansiyel müşteriyi Kişileri Kampanyaya Ekle ile taslak bir kampanyaya ekleyin, ardından biri listeyi onayladığında Kampanyayı Başlat'ı çalıştırın. Çağrı dökümleri, özetleri ve kayıtları kişisel veya sağlık bilgileri içerebilir. Bunları yalnızca kuruluşunuzun bu veriler için kullanmasına izin verilen uygulamalara gönderin, sağlık bilgileri söz konusuysa BAA kapsamında işlem yapın ve yalnızca ihtiyacınız olan alanları saklayın. ## Sorun giderme **Bir adım yetkilendirme hatasıyla başarısız oluyor.** Zapier'daki ThunderPhone bağlantısını yeniden bağlayın ve tekrar onaylayın. Bağlantıyı kuran kişi ThunderPhone'da **Organizasyon → Anahtarlar → Yetkili uygulamalar** altında bağlantıyı iptal ettiğinde, kuruluşten ayrıldığında veya 30 gün boyunca başarılı bir belirteç yenilemesi gerçekleşmediğinde bağlantı çalışmayı durdurur. [OAuth ile bağlanma](/tr/guides/oauth) bölümüne bakın. **Bir Zap'i açma veya kapatma işlemi başarısız oluyor ya da bir eylem reddediliyor.** Bağlantıyı kuran kişinin kuruluşta yönetici veya sahip rolüne sahip olması gerekir. Bu role sahip bir hesapla yeniden bağlanın. Halihazırda açık olan tetikleyici Zap, rol değiştirildikten veya bağlantı iptal edildikten sonra da çağrı etkinliklerini almaya devam eder. Bunları durdurmak için Zap'i kapatın. **Uygulamanın bağlantısını kesmek istiyorsunuz.** Bağlantıyı iptal etmeden önce ThunderPhone Zap'lerinizi kapatın; çünkü bir Zap'i kapatmak uç noktasını siler ve çalışan bir bağlantı gerektirir. Önce iptal ettiyseniz, yönetici API anahtarı kullanarak `DELETE /v1/developer/webhook-endpoints/{id}` ile kalan **Zapier: …** uç noktasını silin. [Webhook uç noktaları](/tr/webhooks/endpoints) bölümüne bakın. **Zap farklı bir kuruluş kullanmalı.** Her bağlantı tek bir kuruluşu kapsar. Önce Zap'i kapatın; böylece webhook uç noktası mevcut kuruluştan silinir. Ardından Zapier'da yeni bir ThunderPhone hesabı bağlayın, onaylarken diğer kuruluşu seçin ve her ThunderPhone adımında bu bağlantıyı seçin. Ajanlar, numaralar ve kampanyalar kuruluşlar arasında farklılık gösterir; bu nedenle bunların bulunduğu her adımda **Ajan**, **Kaynak Numara** ve **Kampanya** seçeneklerini yeniden belirleyin. Ardından Zap'i tekrar açın. **Tetikleyici çalışmayı durdurdu.** ThunderPhone tetikleyicisi olan her Zap, kuruluşunuzda **Zapier: Çağrı Tamamlandı** veya **Zapier: Çağrı Derecelendirildi** adlı bir webhook uç noktasına sahiptir. Zap açıldığında oluşturulur ve kapatıldığında silinir. Olduğu gibi bırakın. ThunderPhone'da düzenlendiyse veya silindiyse yeni bir tane oluşturmak için Zap'i kapatıp tekrar açın. Yönetici API anahtarıyla, [`GET /v1/developer/webhook-deliveries`](/api-reference/webhook-deliveries) son teslim denemelerini gösterir. Sesli AI ajanının çağrıdan sonra değil, çağrı sırasında Zapier eylemlerini kullanmasını mı istiyorsunuz? **Bağlantılar → MCP** altında bir Zapier MCP uç noktası bağlayın. [MCP sunucuları](/tr/guides/mcp-servers) bölümüne bakın. Aynı çağrı etkinliklerini kendi sunucunuza göndermek için [Webhook uç noktaları](/tr/webhooks/endpoints) bölümüne bakın.