Open in
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_iddeğeri olarak saklananX-Talkdesk-Interaction-Id; business_hours=opengibi 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ğerBearer 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 ileexternal_call_idüzerinden de arayabilirsiniz. handoff.intentdeğerine göre yönlendirin vehandoff.summarydeğ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.