ThunderPhone

n8n için ThunderPhone düğümünü yükleyin, bir sunucu API anahtarı bağlayın ve her arama sona erdiğinde çalışan bir iş akışı oluşturun.

n8n, bir iş akışı otomasyon aracıdır. n8n için ThunderPhone paketi iki düğüm ekler:

• ThunderPhone Trigger, bir çağrı sona erdiğinde (Çağrı Tamamlandı) veya bir çağrı değerlendirme çalıştırması tamamlandığında (Çağrı Değerlendirildi) iş akışını başlatır.
• ThunderPhone, giden çağrılar yapar, kişileri kampanyalara ekler ve kampanyaları başlatır, çağrıları transkriptleri ve kayıtlarıyla getirir, yapay zeka ajanlarınızı ve telefon numaralarınızı listeler.

Bu, doğrulanmış bir topluluk düğümüdür ve n8n'de ThunderPhone sayfasında listelenir.

Düğümü yükleyin#

n8n düzenleyicisinde, düğümler panelini açmak için + seçeneğine tıklayın ve ThunderPhone arayın. Diğer kullanıcılar ekleyebilmeden önce bir örnek sahibi doğrulanmış düğümleri ayarlamak zorunda kalabilir.

Kendi barındırdığınız n8n'de paket adına göre de yükleyebilirsiniz: Ayarlar > Topluluk Düğümleri bölümünü açın ve n8n-nodes-thunderphone paketini yükleyin. Yüklemeden önce topluluk düğümü risklerini ve örnek politikanızı kontrol edin.

Sunucu API anahtarı oluşturun#

1. Anahtarlar sekmesini açın

   ThunderPhone'da Kuruluş → Anahtarlar bölümüne gidin ve Anahtar oluştur seçeneğine tıklayın.

2. Ad verin

   Anahtarın nerede kullanıldığını belirten, örneğin "n8n" gibi bir ad kullanın.

3. Hemen kopyalayın

   Tam sk_live_... gizli anahtarı bir kez gösterilir. İletişim kutusunu kapatmadan önce kopyalayın.

Anahtarı yalnızca bir yönetici veya sahip oluşturabilir ve ThunderPhone, bu anahtarla yapılan istekleri o kişiden gelmiş sayar. Tetikleyici ve kampanya işlemleri, o kişinin yönetici veya sahip rolünü korumasını gerektirir. Sunucu API anahtarı oluşturma, döndürme ve iptal işlemlerini açıklar.

Kimlik bilgisini n8n'e ekleyin#

1. n8n'de ThunderPhone API türünde bir kimlik bilgisi oluşturun.
2. Anahtarı API Anahtarı alanına yapıştırın.
3. Kaydedin ve kimlik bilgisi testini çalıştırın. Test, kuruluşunuzdan bir çağrıyı GET /v1/calls?limit=1 ile okur.

İlk iş akışını oluşturun#

Bu iş akışı, her çağrı sona erdiğinde bir Google Sheet'e satır ekler.

1. Tetikleyiciyi ekleyin

   ThunderPhone Trigger ekleyin, ThunderPhone API kimlik bilginizi seçin ve Event değerini Call Completed olarak ayarlayın.

2. Çağrıyı alın

   Bir ThunderPhone düğümü ekleyin. Resource değerini Call, Operation değerini Get olarak ayarlayın ve Call ID alanına {{ $json.data.call_id }} ifadesini girin. Çıktı, çağrı kaydına ek olarak transcripts ile, çağrının kaydı olmadığında null olan kısa ömürlü bir bağlantı olan recording_url değerini içerir.

3. Satır ekleyin

   Satır ekleyen bir Google Sheets düğümü ekleyin ve istediğiniz sütunları Get Call çıktısından eşleyin (aşağıdaki tabloya bakın).

4. İş akışını etkinleştirin

   Kaydedin ve etkinleştirin. Tetikleyici, Production URL'sini ThunderPhone kuruluşunuzda bir webhook uç noktası olarak kaydeder. İş akışını devre dışı bırakmak bu uç noktayı siler.

5. Test edin

   Oluşturucuda bir ajan açın, Talk seçeneğine tıklayın ve çağrıyı sonlandırın. Oluşturucu test çağrıları, Call Completed'in arkasındaki iki olaydan biri olan web.complete olarak teslim edilir; böylece iş akışı ç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; bu nedenle sayfanın ikisini de saklaması gerekmez.

Yine de transkripti eklemek için {{ $json.transcripts.filter(t => typeof t.content === 'string').map(t => t.role + ': ' + t.content).join('\n') }} ifadesini eşleyin. Kayıt URL'sinin süresi dolar; bu nedenle çağrı kimliğini saklayın ve yeni bir bağlantıya ihtiyaç duyduğunuzda Get Call işlemini yeniden çalıştırın. Ç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 konusu olduğunda BAA kapsamında gönderin ve yalnızca ihtiyacınız olan alanları saklayın.

Tetikleyici tam olayı çıktılar: type, event_id ve data. Tüm alanlar için telephony.complete / web.complete ve call.graded belgelerine bakın. Teslimat en az bir kez gerçekleşir ve event_id, tek bir olayın yeniden denemelerinde aynı kalır; bu nedenle tekrarlanmaması gereken bir adımdan önce bunu kontrol edin.

Giden aramaları güvenle başlatın#

Giden Arama Başlat (Kaynak Giden Arama, İşlem Başlat) şunları alır:

İdempotentlik Anahtarı alanını, CRM kayıt kimliği veya tetikleyicinin event_id değeri gibi çalıştırmayı başlatan kaynaktan gelen bir kimlikle eşleyin. Düğüm n8n:<node ID>:<your value> gönderir; bu nedenle:

• Otomatik yeniden deneme veya Yürütmeyi yeniden dene aynı anahtarı gönderir ve ThunderPhone yeniden arama yapmak yerine idempotent_replay: true ile özgün aramayı döndürür.
• Aynı kayıttan beslenen iki ThunderPhone düğümü farklı anahtarlar gönderir.
• Boş bir değer, herhangi bir istek gönderilmeden önce başarısız olur.

Zaman damgalarından, rastgele değerlerden ve n8n yürütme veya iş akışı kimliklerinden kaçının. Yeniden denemede yeni bir değer, ikinci bir gerçek arama başlatır. Anahtarın tamamı en fazla 128 karakter olabilir. Farklı bir ajan, numara veya değişkenle bir anahtarı yeniden kullanmak çakışma hatasıyla başarısız olur.

Kampanyalar. Kişi Ekle (Kaynak Kampanya) kişileri taslak bir kampanyaya ekler. Bir Kampanya Kimliği ve kişilerden oluşan bir JSON dizisi alır. Her kişi için phone_number gereklidir; diğer anahtarlar arama değişkenlerine dönüşür. Düğüm, tüm kişiler reddedildiğinde başarısız olur ve yalnızca bazıları reddedildiğinde partial_success: true ayarlar. Başlat, kampanyanın gerçek aramalar başlattığını ve ThunderPhone kredilerini harcadığını onaylayan onay kutusunu gerektirir. Bkz. Giden arama kampanyaları.

Bir iş akışı arama başlatmadan önce:

• ThunderPhone kuruluşunuzdan giden aramalarının TCPA ve diğer arama yasalarına uyduğunu onaylamasını isterse, bir yönetici önce bu onayı panoda kaydetmelidir.
• Aramanın yapılacağı numara giden aramalar için etkinleştirilmiş olmalıdır. Kendi operatörünüzden getirdiğiniz numaralar doğrulandıktan sonra uygun olur. ThunderPhone numaraları başlangıçta yalnızca gelen aramalara açıktır ve giden kullanım için onaylanabilir: bir yönetici bunu Telefon Numaraları sayfasından talep eder. Bkz. Telefon numarası alın.
• Kuruluşunuz, her numarayı aramak için onaya sahip olmaktan ve geçerli arama yasalarına uymaktan sorumludur. Bkz. Giden arama yasaları.

Örnek iş akışları#

• CRM kişilerini kampanyaya ekleme. CRM kişilerini taslak bir ThunderPhone kampanyasına ekleyin, ardından biri listeyi onayladığında kampanyayı başlatın.
• Tamamlanan aramayı müşteri kaydına ekleme. Arama Tamamlandığında, Aramayı Getir işlemini çalıştırın ve transkripti ile kayıt bağlantısını eşleşen müşteri kaydına kaydedin.
• Düşük puanları incelemeye gönderme. Arama Puanlandığında, {{ $json.data.grade.score }} üzerinde filtre uygulayın ve düşük puanlı aramaları arama kimliği ve puanlama ayrıntılarıyla birlikte inceleme kuyruğuna yönlendirin. Bir arama birden fazla kez puanlanabilir ve tamamlanan her puanlama çalıştırması tetikleyiciyi çalıştırır; bu nedenle her arama kimliği için yalnızca en son graded_at değerini saklayın.

Arama transkriptleri, özetler 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 konusu olduğunda bir BAA kapsamında gönderin ve yalnızca ihtiyaç duyduğunuz alanları saklayın.