ThunderPhone

Zapier

Zapier, 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 sayfasında bulabilirsiniz. Zapier'i ThunderPhone ile kullanmanın iki yoluna genel bakış için Zapier entegrasyonu sayfasına 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.

1. Bir ThunderPhone adımı ekleyin

   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.

2. Oturum açın ve kuruluşu seçin

   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.

3. Bağlantı adını kontrol edin

   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.

1. Örnek veri olarak kullanmak için çağrı yapın

   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.

2. Tetikleyiciyi ekleyin

   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.

3. Google E-Tablolar'ı ekleyin

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

4. Zap'i yayınlayı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.

5. Test edin

   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:

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

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

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

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.
• 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ı.

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, 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 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ı 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 son teslim denemelerini gösterir.