ThunderPhone 2.0 yayında.Kendi başınıza kullanmaya başlayın; dakikada 2¢'den başlayan fiyatlarla.Duyuruyu okuyun
Hemen başlayın

Connect tools & data

ThunderPhone

Ajanları listelemek, çağrıları ve transkriptleri incelemek ve bir kuruluş API anahtarıyla giden çağrılar başlatmak için herhangi bir Streamable HTTP MCP istemcisini ThunderPhone

ThunderPhone, şu adreste bir Model Context Protocol sunucusu sunar:

https://api.thunderphone.com/v1/mcp

Kuruluşunuzun ajanlarını ve çağrılarını araç olarak kullanılabilir hale getirmek için bir MCP istemcisini bu Streamable HTTP uç noktasına yönlendirin. Bu, uzak bir MCP sunucusunu sesli AI ajanına bağlama işleminin ters yönüdür:

YönSonuç
Uzak MCP sunucusu → ThunderPhone ajanıSesli AI ajanınız uzak sunucunun araçlarını çağırabilir.
ThunderPhone → MCP istemcinizMCP istemciniz ajanlar ve çağrılar için ThunderPhone araçlarını çağırabilir.

Kimlik doğrulama

Organization → Keys altında bir sk_live_ anahtarı oluşturun ve bunu Bearer belirteci olarak gönderin. MCP uç noktası, pano oturum tanımlama bilgilerini veya yayımlanabilir widget anahtarlarını değil, kuruluş API anahtarlarını kabul eder.

Generic client configuration
{
  "mcpServers": {
    "thunderphone": {
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_YOUR_API_KEY"
      }
    }
  }
}

Kullanılabilir araçlar

AraçBağımsız değişkenlerİşlevi
list_agentsyokKuruluş ajanlarını kimlik, ad, ürün ve ses bilgileriyle listeler.
get_agentagent_idTek bir ajanı getirir.
place_callagent_id, from_number, to_numberREST çağrı uç noktasıyla aynı doğrulama ve faturalandırma kontrolleriyle giden çağrı başlatır.
get_callcall_idÇağrı durumunu, özetini ve notunu getirir.
list_callsisteğe bağlı limit (1–100), isteğe bağlı statusSon çağrıları listeler.
get_call_transcriptcall_idBir çağrının tam dökümünü getirir.

Tüm araçlar API anahtarına bağlı kuruluşla sınırlıdır. Başka bir kuruluşa ait kimlik, kullanılamazmış gibi davranır.

Protokol yöntemleri

Uç nokta, Streamable HTTP istemcileri için gerekli MCP JSON-RPC yöntemlerini uygular:

  • initialize
  • notifications/initialized
  • tools/list
  • tools/call

Araç kataloğunu doğrudan inceleyebilirsiniz:

curl -X POST https://api.thunderphone.com/v1/mcp \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

Bir aracı adı ve bağımsız değişkenleriyle çağırın:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "list_calls",
    "arguments": { "limit": 20, "status": "completed" }
  }
}

Araç sonuçları MCP metin içeriği öğeleridir. Araç hataları sonuç içinde isError: true ile döndürülür; bilinmeyen JSON-RPC yöntemleri protokol hatası döndürür.

Çağrıları güvenli şekilde başlatma

place_call, POST /v1/call ile aynı kuralları izler: ajan ve numara anahtarın kuruluşuna ait olmalı, numara giden çağrılar için uygun olmalı, kuruluşun yeterli bakiyesi bulunmalı ve geçerli tüm giden çağrı onayları tamamlanmış olmalıdır.

place_call erişimi olan bir istemciyi üretim ortamında çağrı başlatan bir istemci olarak değerlendirin. İstemciyi kimlerin kullanabileceğini kısıtlayın, amaçlanan ajanı ve numarayı kendi isteminde açıkça belirtin ve çağrıları Çağrı Geçmişi'nde inceleyin.

Tam bağlantı referansı

Yanıt örnekleri, JSON-RPC hataları ve uzak sunucu yönetimi API'si için MCP Servers API sayfasına bakın.