Open in
Five9
Five9 çağrılarını AI Agent Connect ile SIP üzerinden bir ThunderPhone yapay zeka ajanına gönderin ve IVR betiğinizin okuduğu yönlendirme başlıklarıyla geri alın.
Five9 IVR betiğiniz, arayanı Five9'un çağrı ayrıntılarıyla ajana gönderir. Ajan işi tamamladığında, SIP BYE üzerindeki yönlendirme başlıklarıyla çağrıyı sonlandırır; betik de arayanı yönlendirmek için bunları çağrı değişkenlerine okur.
Başlamadan önce
- Bir ThunderPhone ajanı ve bir kuruluş API anahtarı.
- Five9'un AI Agent Connect eklentisi. Five9 bunu akredite ettiği yapay zeka sağlayıcılarıyla sınırlar ve Five9'un uygulama ekibi kurulumu yapar: sağlayıcının IVR betik şablonunu içe aktarır, çağrı değişkenlerini oluşturur ve betiğin Üçüncü Taraf Aktarımı modülünü sağlayıcıya yönlendirir. ThunderPhone henüz Five9'un akredite listesinde değildir: buna göre plan yapmadan önce Five9 hesap ekibinize veya ThunderPhone desteğine danışın.
1. SIP uç noktasını oluşturun
Five9'un Üçüncü Taraf Aktarımı modülü SIP adresini değil, bir telefon numarasını arar ve diğer sağlayıcıların Five9 entegrasyonları Five9'u parola yerine kaynak adresiyle doğrular. Bu nedenle, Five9'un arayacağı numarayı arama numarası olarak içeren bir ip_allowlist uç noktası oluşturun (telefon numarası arayan platformlar bölümüne bakın):
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": "Five9",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["FIVE9_SIGNALLING_RANGE_1", "FIVE9_SIGNALLING_RANGE_2"],
"dial_in_numbers": ["+14155550188"]
}'allowed_source_cidrs: Five9'dan alınan, Five9 veri merkezlerinizin SIP sinyalleşme aralıkları. Her biri/16veya daha dar bir genel IPv4 aralığı olmalıdır (IPv6 için/48veya daha dar).dial_in_numbers: Five9 betiğinin arayacağı, Five9'un gönderdiği biçimde yazılmış numara. Gerçek bir telefon numarası olması gerekmez. ThunderPhone üzerinde telefon numarası olarak veya başka bir uç noktada zaten kullanılıyor olamaz: aksi durumda409döner.
Five9'un adresleri tüm müşterileri tarafından paylaşıldığından, numarayı arayan başka herhangi bir Five9 müşterisi ajanınıza ulaşır. Numarayı seçebildiğiniz yerde, kimsenin tahmin edemeyeceği uzun bir numara seçin (en fazla 15 hane), Five9'un bunu telefon ağına yönlendirmek yerine ThunderPhone'a gönderdiğinden emin olun ve numarayı yayımlamayın.
2. Çağrıları bağlamla gönderin
Five9'un uygulama ekibinden şunları isteyin:
- Çağrıyı Üçüncü Taraf Aktarımı modülünden, numara hem istek URI'sinde hem de
Tobaşlığında olacak şekildesip:+14155550188@sip.thunderphone.comadresine gönderin. Modül, sağlayıcının SIP alan adıyla birlikte numarayı bir başlıkta alır. - TLS (5061 numaralı bağlantı noktası) veya TCP (5060 numaralı bağlantı noktası) üzerinden gönderin. Uç nokta UDP'yi reddeder ve Five9 hangi taşıma yöntemini kullandığını yayımlamaz; bu nedenle UDP olmadığından emin olun.
- Ajan çağrıyı sonlandırdığında betiğin devam etmesi için Üçüncü Taraf Çağrısından Sonra Dön seçeneğini etkinleştirin (Five9, üçüncü taraf çağrısında en fazla 3.600 saniyeye izin verir).
Five9'un kılavuzu, gönderdiği değerleri (call.ANI, call.DNIS,
call.call_id, call.session_id, call.campaign_name ve diğerleri) listeler; başlık adlarını değil. Diğer yapay zeka sağlayıcılarının Five9 entegrasyonları bunları ağ üzerinde X-CallANI, X-CallDNIS, X-CallID, X-CallSessionID, X-CallCampaign
ve X-AgentID olarak belgeler; ilk test çağrınızda bunları kontrol edin. Her biri, örneğin
{{sip_x_callcampaign}} gibi bir değişken olarak isteme ulaşır. X-CallID, çağrının
external_call_id değeri olarak saklanır.
3. Aramayı geri alın
Ajan çağrıyı geri döndürür: vedalaşır ve kapatır; BYE, Five9 betiğinin
okuduğu dört başlığı taşır. Bu aktarım numarasını ekleyin (bkz.
Aktarım numarasını ekleme):
{
"name": "Five9 agent",
"action": "return",
"headers": {
"X-RouteType": "SkillTransfer",
"X-RouteValue": "Support",
"X-RouteReason": "{{handoff_intent}}",
"X-CustomMetaData": "handoff_id={{handoff_id}}"
}
}X-RouteTypeveX-RouteValue, betiğe arayanı nereye göndereceğini, burada Support yeteneğine yönlendireceğini belirtir. Diğer sağlayıcılarınX-RouteTypeiçin belgelediği değerler arasındaSkillTransfer,PhoneTransfer,HangupveDispositionOnlybulunur; değerleri betiği yöneten kişiyle kararlaştırın. Birden fazla hedef için, her hedefe farklı ad veX-RouteValuedeğeriyle bir geri dönüş ekleyin.X-RouteReason,billing_disputegibi ajanın amaç etiketini taşır.X-CustomMetaData, aktarma kimliğini taşır.BYEbunu ayrıcaX-TP-Handoff-Idolarak taşır; Five9 bunu okumaz.
Five9 betiği dört başlığı çağrı değişkenlerine eşler. Ajan özetini almak için,
betiğin bir IVR Sorgu modülüyle aktarma sorgusunu çağırmasını sağlayın:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= ardından
call.call_id; Authorization: Bearer ve API anahtarınızı gönderen bir
Yetkilendirme Profili kullanın. Bkz.
Aktarılan bir çağrıyı sorgulama.
Test edin
IVR betiğini arayın, yapay zeka ajanından bir insan isteyin ve betiğin arayanı
çağrı değişkenleri doldurulmuş şekilde yönlendirdiğini doğrulayın. Çağrı hiçbir
zaman ajana ulaşmazsa istek URI'sindeki ve To başlığındaki numaranın erişim
numarasıyla eşleştiğini, Five9 kaynak adresinin allowed_source_cidrs içinde
olduğunu ve çağrının TCP veya TLS üzerinden geldiğini kontrol edin. Ardından
çağrıyı GET /v1/calls/{call_id} ile açın: sip_headers, x-callid değerini
listelemeli ve external_call_id, Five9 içindeki call.call_id ile eşleşmelidir.
Sınırlar
- Five9 kılavuzu yönlendirme verilerini
BYEüzerinde belgeler ve birREFERkabulünden bahsetmez; bu nedenle geri aktarma, betik tarafından yapılan soğuk bir aktarmadır. - Five9,
User-to-UseryerineX-RouteType,X-RouteValue,X-RouteReasonveX-CustomMetaDatadeğerlerini okur. ThunderPhone her başlık değerini en fazla 256 bayt uzunluğunda gönderir. - Five9, paket parçalanmasını önlemek için özel başlıkların sayısını yaklaşık onla sınırlamayı önerir.