Open in
ThunderPhone
Bir ajanı açık dosyalar olarak dışa aktarın, kodlama ajanı becerisiyle LiveKit Agents, Pipecat, Vapi veya Retell üzerinde yeniden oluşturun ve arama geçmişinizi ve kayıtlarınızı indirin.
ThunderPhone'dan istediğiniz zaman ayrılabilirsiniz. Her ajanı açık dosyalardan oluşan ücretsiz bir zip olarak dışa aktarabilirsiniz; ayrıca bir beceri, kodlama ajanınızın bunu LiveKit Agents, Pipecat, Vapi veya Retell üzerinde yeniden oluşturmasına yardımcı olur. Bu sayfa neleri yanınıza alabileceğinizi, nasıl dışa aktaracağınızı ve diğer tarafta neleri yeniden yapmanız gerektiğini kapsar.
Yanınıza alabilecekleriniz
| Ne | Nasıl |
|---|---|
| Bir ajan: talimatlar, araçlar, aktarma numaraları, adımlar, ayarlar, numara yönlendirme ve web kancaları | Ajan dışa aktarımı, ajan başına bir zip |
| Ajanın bilgi dosyaları | Ajan dışa aktarımının içinde |
| Arama geçmişi ve transkriptler | Arama dışa aktarımı, istek başına en fazla 1.000 arama |
| Kayıtlar | Arama bazında, istek başına bir kayıt |
| Kendi operatörünüzdeki telefon numaraları | Operatörünüzden hiç ayrılmadılar. Bkz. Telefon numaraları |
Bir ajanı dışa aktarma
Zeus'ta
Ajanı açın ve ayarlarına gidin (ajan düzenleyicisindeki Çağrı yönetimi). En altta, Dışa aktar, kopyala veya sil bölümünden Dışa Aktar seçeneğini belirleyin. ZIP dosyası bilgisayarınıza indirilir.
API ile
curl 'https://api.thunderphone.com/v1/agents/12/export' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-o agent-12.zipZIP dosyası istediğinizde oluşturulur. Ajanı okuyabilen herkes onu dışa
aktarabilir. Bilgi, numaralar ve web kancaları yalnızca kimlik bilgisinin
bunları okuyabilmesi durumunda dahil edilir: bir OAuth belirtecinin
knowledge:read, numbers:read ve integrations:read izinlerine sahip
olması gerekir; web kancaları için ayrıca yönetici veya sahip olmanız gerekir.
Atlanan bir bölüm, manifest.json içindeki omitted altında listelenir.
API, dakikada 30 dışa aktarmanın üzerinde 429 yanıtını döndürür.
| Sorgu parametresi | Açıklama |
|---|---|
include_url_paths | true, bir aracın uç noktası gibi her URL'nin yolunu dışa aktarmada korur. Varsayılan olarak her URL ana makinesine kadar kısaltılır. Kullanıcı adları, parolalar ve sorgu dizeleri her iki durumda da URL'lerden kaldırılır |
Araç uç noktalarına orada ihtiyaç duyulacağından, ajanı başka bir yerde yeniden
oluşturmak üzereyseniz include_url_paths=true kullanın. Paylaşmayı
planladığınız bir kopya için bunu kapalı bırakın.
ZIP dosyasının içeriği
| Dosya | İçerik |
|---|---|
manifest.json | Biçim (thunderphone.agent-export/v1), dahil edilenler ve atlanan her şeyi nedenleriyle adlandıran bir omitted listesi |
agent.json | Kimlik bilgileri kaldırılmış olarak, GET /v1/agents/{agent_id} tarafından döndürüldüğü biçimde ajan |
prompt.md | Yayındaki talimatlar |
knowledge/index.json ve yanındaki dosyalar | Ajanın bilgisi. Her belge, depolandığı yerde özgün dosyadır; aksi durumda çıkarılmış metnidir |
numbers.json | Sabitlenmiş sürüm veya varyantla birlikte, bu ajana yönlendirilen gelen ve giden numaralar |
webhooks.json | Gizli anahtarları olmadan, bu ajan kapsamındaki web kancası uç noktaları |
README.md | Her dosyanın ne olduğu |
25 MB'tan büyük bir bilgi dosyası ve dışa aktarmanın tamamında 100 MB'ı aşan
her şey atlanır. Her biri, onu indiren uç noktayla birlikte manifest.json
içinde listelenir:
GET /v1/knowledge/documents/{document_id}/original.
Hiçbir zaman dahil edilmeyenler
- Kimlik bilgisi değerleri. Bir aracın üst bilgileri yalnızca adlarıyla listelenir. Üst bilgi değerleri ThunderPhone'da yalnızca yazılabilir: hiçbir API yanıtı bunları döndürmez, dolayısıyla hiçbir dışa aktarma da döndüremez. Bunları diğer tarafta yeniden girersiniz. Bu, ThunderPhone'un kimlik bilgisi olarak sakladığı kimlik bilgilerini kapsar. Talimatlarınız ve bilgi dosyalarınız, yazdığınız veya yüklediğiniz biçimde aynen kopyalanır; bu nedenle bir anahtar bir isteme veya belgeye yapıştırıldıysa ZIP dosyasındadır. Paylaşmadan önce kontrol edin.
- Çağrı geçmişi ve kayıtlar. Bunların kendi dışa aktarmaları vardır; bkz. Çağrı geçmişi ve kayıtlar.
- Sürüm geçmişi. Dışa aktarma, ajanı şu anda yayında olduğu haliyle içerir.
Önceki sürümler şurada listelenmeye devam eder:
GET /v1/agents/{agent_id}/versions. - Bu ajanın devrettiği diğer ajanlar. Her birini aynı şekilde dışa aktarın.
Başka bir platforma geçin
migrate-off-thunderphone becerisi, kodlama ajanınıza geçiş sürecinde rehberlik eder.
ThunderPhone becerilerini yükleyin:
npx skills add thunderphone/skillsArdından kodlama ajanınızdan bir ajanı ThunderPhone'dan taşımasını isteyin ve hedefi belirtin: LiveKit Agents, Pipecat, Vapi veya Retell. Bu beceri dışa aktarmayı indirir, her kimlik bilgisi için size sorar, ajanı bu hedefin eşlemesine göre yeniden oluşturur ve herhangi bir numara taşınmadan önce orada test eder. Dönüştürme, kendi anahtarlarınızla kodlama ajanınızda çalışır. ThunderPhone başka bir platformdaki hesabınıza asla yazmaz.
Becerinin sizin için eşlediği dosyalar olarak aktarılanlar:
- Paylaşılan talimatlar ve adımlar dahil olmak üzere talimatlar.
- Araçlar: aynı uç nokta, yöntem ve parametre şeması. Her aracın
request_formatdeğeri, uç noktanızın beklediği istek gövdesi biçimini kaydeder. - Aktarım numaraları ile aramayı sonlandırma ve tuş takımı ayarları.
- Bilgi dosyaları.
- Sesli mesaj, sessizlik ve arama süresi ayarları.
- Ajanın yanıtladığı ve arama yaptığı numaralar.
Diğer tarafta yeniden yapacaklarınız:
- Konuşma, dil modeli ve ses sağlayıcıları. Bunları hedefte siz seçersiniz. Bir sesin veya aramanın sesinin aynı olacağı garanti edilmez.
- Kimlik bilgileri. Araç üst bilgi değerleri ve webhook gizli anahtarları.
- Telefon hizmetleri. Numaraların ajana nasıl ulaştığı her platformda farklı şekilde ayarlanır.
- Adımlar ve aktarımlar. Akış veya aktarım özelliği bulunan bir hedefte bunlar orada yeniden oluşturulur. Diğer yerlerde beceri adımları talimatlarla birleştirir ve size bildirir.
- Karşılığı olmayan ThunderPhone ayarları. Intelligence, dinleme ve yanıt hızı ayarları, yerleşik e-posta ve kısa mesaj araçları ile arama değerlendirmesi, özetler ve sonuç etiketleri siz bunları yeniden oluşturmadıkça taşınmaz.
- İstek imzaları. ThunderPhone gönderdiği araç isteklerini ve webhook'ları imzalar. Başka bir platform kendi yöntemiyle imzalar; bu nedenle ThunderPhone imzasını doğrulayan bir uç noktanın yeni bir denetime ihtiyacı vardır.
- Test. Bir numarayı taşımadan önce yeniden oluşturulan ajanı hedefte test edin.
Yeni ajan testlerinizi geçene kadar ThunderPhone ajanını yerinde bırakın. Bu, geri dönüş yolunuzdur.
Telefon numaraları
Numaraları en son, yeni ajan testlerini geçtikten sonra taşıyın.
- Kendi operatörünüzdeki bir numara (bir VoIP bağlantısı)
o operatörde kalır. Operatörünüzün konsolunda numarayı yeni platforma
yönlendirin. Ardından ThunderPhone'da numara için Serbest Bırak seçeneğini
belirleyin ve Bu numarayı … hesabımda da iptal et seçeneğini işaretlemeyin:
numaranın ThunderPhone bağlantısı kesilir ve numara operatör hesabınızda kalır.
API üzerinden,
DELETE /v1/phone-numbers/{phone_number_id}?confirm=trueile serbest bırakın verelease_at_providergöndermeyin. - ThunderPhone'un sağladığı bir numara. Saklamak istediğiniz bir numarayı serbest bırakmadan önce destek ekibiyle iletişime geçin. ThunderPhone numarasını serbest bırakmak kalıcıdır: numara havuza döner ve başka bir müşteriye verilebilir.
Arama geçmişi ve kayıtlar
Bunlar ajan dışa aktarmasından ayrıdır.
- Aramalar.
GET /v1/calls/exportistek başına CSV (meta veriler) veya JSON (transkriptlerle) olarak en fazla 1.000 arama döndürür.agent_idile filtreleyin vestart_dateileend_datekullanarak geçmişinizde sayfalama yapın. Döndürülenlerden daha fazla eşleşen arama olduğundaX-Truncatedyanıt üst bilgisitrueolur. - Kayıtlar.
GET /v1/calls/{call_id}/audiotek bir aramanın kaydı için kısa ömürlü bir URL döndürür. Toplu kayıt indirme özelliği yoktur.
curl 'https://api.thunderphone.com/v1/calls/export?export_format=json&agent_id=12&start_date=2026-10-01T00:00:00Z&end_date=2026-11-01T00:00:00Z' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-o calls-2026-10.jsonMaliyeti
Hiçbir şey. Ajan dışa aktarma, arama dışa aktarma ve kayıt indirmeleri ücretsizdir. ThunderPhone, abonelik veya kullanıcı başına ücret olmadan kullandıkça öde modelinde çalışır. Bir ThunderPhone numarasını serbest bıraktığınızda faturalandırma durur.
Ayrıldıktan sonra
Sabit bir sözleşme süresi yoktur. Hesabın yönetici e-posta adresinden veya doğrulanabilir başka bir kanaldan legal@thunderphone.com adresine yazılı bildirim göndererek sözleşmeyi sona erdirebilirsiniz. Ödemedeki gecikme hizmeti askıya alabilir; ancak tek başına sözleşmeyi asla sona erdirmez veya Müşteri Verilerinin silinmesini tetiklemez. Verilerle ilgili olarak Koşullar şunu belirtir: "Resmî fesih sonrasında Sağlayıcı, Müşterinin dışa aktarma hakları, yedekleme döngüleri, yasal saklama yükümlülükleri, kanunen zorunlu saklama, DPA ve yürürlüğe konmuş herhangi bir BAA saklı kalmak üzere Müşteri Verilerini altmış (60) gün içinde iade eder veya siler."
Tam metin, Hizmet Koşulları sayfasında Hizmet süresi; askıya alma; fesih başlığı altında yer alır. Koşullar geçerlidir; bu metin bir özettir.