ThunderPhone v3 yayında.Hemen kendiniz kullanmaya başlayın; dakikası 2 sentten başlayan fiyatlarla.Duyuruyu okuyun

Contact centers

Talkdesk

Talkdesk çağrılarını Autopilot Voice

Talkdesk Studio akışınız, arayanı etkileşim kimliği ve UUI ile yapay zeka ajanına gönderir. Arayanın bir insana ihtiyacı olduğunda, ajan Talkdesk'e SIP REFER ile yükseltir ve aktarım kimliği bir Studio değişkenine ulaşır.

Başlamadan önce

  • Bir ThunderPhone ajanı ve kuruluş API anahtarı.
  • Harici Ses Akışı modundaki Studio Otopilot Sese Bağlan bileşenini kapsayan bir Talkdesk Konuşma Düzenleyici lisansı (Talkdesk makalesi). Talkdesk, yapay zeka ajanı çağrıyı sürdürürken dakika başına ücretlendirir.

1. SIP uç noktasını oluşturun

Talkdesk yalnızca bir IP izin listesi belgeliyor; bu nedenle kaynak adresine göre çağrıları kabul eden bir uç nokta oluşturun:

curl -X POST https://api.thunderphone.com/v1/sip-endpoints \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": 12,
    "name": "Talkdesk",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["TALKDESK_SIGNALLING_RANGE_1", "TALKDESK_SIGNALLING_RANGE_2"],
    "srtp": "optional"
  }'

Talkdesk makalesi sesin SRTP üzerinden gönderildiğini ve "srtp": "optional" ayarının Talkdesk sunduğunda SRTP ile yanıt verdiğini belirtir. Makale, Talkdesk'in SRTP gerektirip gerektirmediğini söylemez; Talkdesk gerekli olduğunu bildirirse srtp değerini required olarak ayarlayın; bu ayar SRTP olmayan çağrıları reddeder.

Talkdesk'in SIP sinyalleşme aralıklarını Talkdesk'ten alın. Her biri /16 veya daha dar bir genel IPv4 aralığı olmalıdır (IPv6 için /48 veya daha dar). Kaynak IP'ye göre kimlik doğrulayan platformlar bölümüne bakın. Talkdesk, SIP'i her Twilio müşterisinin paylaştığı Twilio ağından gönderir; bu nedenle diğer arayanları dışarıda tutan şey uç noktanın adresidir: adresini yayımlamayın. Yanıttaki sip_uri değerini saklayın; örneğin sip:agent-12-jhxmginwjx@sip.thunderphone.com.

2. Çağrıları bağlamla gönderin

Studio akışınızda, Harici Ses Akışı modunda Otopilot Sese Bağlan ekleyin ve hedefini uç noktanın sonuna ;transport=tls eklenmiş sip_uri değeri olarak ayarlayın; örneğin sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls. Uç nokta, aksi belirtilmediği sürece Twilio SIP'in kullandığı UDP üzerinden gelen çağrıları reddeder.

Talkdesk şunları gönderir:

  • Çağrının external_call_id değeri olarak saklanan X-Talkdesk-Interaction-Id;
  • business_hours=open gibi onaltılık kodlanmış User-to-User. İstemlere kodu çözülmüş şekilde {{sip_uui}} olarak ulaşır.

Bileşenin 2.1 sürümü Tanımlı başlıklar da gönderebilir. Talkdesk'in tercihler sayfası bunları WebSocket üzerinden gönderilen JSON olarak açıklar; bunlara güvenmeden önce SIP başlıkları olarak ulaşıp ulaşmadıklarını Talkdesk ile doğrulayın.

3. Çağrıyı geri alın

Sesli AI ajanı, aktarım kimliği bu adresin içinde onaltılık UUI olarak yer alacak şekilde Talkdesk'in eskalasyon adresine bir REFER gönderir; Talkdesk bu kimliği yalnızca burada okur. Bu aktarım numarasını ekleyin (bkz. Aktarım numarasını ekleme ve Aktarım adresindeki başlıklar):

{
  "name": "Talkdesk escalation",
  "number": "sip:escalation@talkdesk.com",
  "headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}

Adres, Talkdesk makalesindeki adrestir. Bileşenin 2.1 sürümü autopilot_result= değerini okur; 1.7 sürümü escalate_to= değerini okur; bu nedenle 1.7'de bu anahtarı kullanın. REFER şu şekilde görünür:

Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>

Talkdesk değeri bir Studio değişkenine yerleştirir. Özeti ve amacı almak için Connections ile oluşturulmuş özel bir entegrasyona Eylemi Çalıştır adımı ekleyin:

  • Kimlik doğrulama türü API anahtarı, başlık adı Authorization, değer Bearer sk_live_….
  • İstek: GET https://api.thunderphone.com/v1/calls/handoff?handoff_id= ifadesinin ardından değişkendeki kimliği ekleyin. Çağrıyı etkileşim kimliği ile external_call_id üzerinden de arayabilirsiniz.
  • handoff.intent değerine göre yönlendirin ve handoff.summary değerini çağrıyı devralan kişiye gösterin.

Bkz. Aktarılmış bir çağrıyı arama.

Test edin

Studio akışı üzerinden bir çağrı başlatın, ajandan bir kişi isteyin ve akışın bileşeni değişkenindeki aktarım kimliğiyle geçmeye devam ettiğini kontrol edin. Ardından çağrıyı GET /v1/calls/{call_id} ile açın: external_call_id, Talkdesk etkileşim kimliği olmalıdır.

Sınırlar

  • Talkdesk en fazla 256 bayt UUI okur ve | veya ; ile ayrılmış değerlere izin vermez; bu nedenle tek bir değer gönderin. Aktarım kimliği sığar.
  • Talkdesk API'leri ajanın dökümünü okuyamaz. Bunun yerine aktarım aramasını veya GET /v1/calls/{call_id} kullanın.