Open in
NICE CXone
NICE CXone çağrılarını, ContactID bir SIP üst bilgisinde olacak şekilde bir Studio betiğinden ThunderPhone ajanına gönderin ve betik devam ettiğinde ajanın aktarmasını sorgulayın.
CXone Studio betiğiniz, iletişim kimliğini ve diğer bağlam bilgilerini taşıyan SIP başlıklarıyla yapay zeka ajanını arar. Ajan işi bittiğinde çağrıyı kapatır ve betikteki bir REST API eylemi çağrı aktarımını getirir.
Başlamadan önce
- Bir ThunderPhone ajanı ve bir kuruluş API anahtarı.
- Özel başlıkları kabul eden bir CXone SIP trunk grubu. CXone bunları göndermeden önce NICE hesap temsilcinizin bu ayarı etkinleştirmesi gerekir.
1. SIP uç noktasını oluşturun
Placecall, bir SIP adresi yerine CXone trunk grubu üzerinden bir telefon numarasını arar.
NICE bunun için SIP kimlik bilgilerini belgelemez ve başka bir yapay zeka sağlayıcısının CXone
entegrasyonu, IP izin listesiyle TLS kullanır. Bu nedenle, betiğin arayacağı numarayı arama
numarası olarak içeren bir ip_allowlist uç noktası oluşturun (bkz.
Telefon numarası arayan platformlar):
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": "NICE CXone",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["CXONE_SIGNALLING_RANGE_1", "CXONE_SIGNALLING_RANGE_2"],
"dial_in_numbers": ["+14155550188"]
}'allowed_source_cidrs: NICE'ten alınan CXone kümenizin 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: Placecall'ın arayacağı, CXone'un gönderdiği biçimde yazılmış numara. Gerçek bir telefon numarası olmak zorunda değildir. ThunderPhone üzerinde telefon numarası olarak veya başka bir uç noktada zaten kullanılıyor olamaz; aksi durumda409döner.
CXone adresleri tüm müşterileri tarafından paylaşılır; bu nedenle numarayı arayan başka bir CXone müşterisi yapay zeka ajanınıza ulaşır. Numarayı seçtiğiniz yerde kimsenin tahmin edemeyeceği uzun bir numara seçin (en fazla 15 hane), CXone'un bunu telefon ağına çıkarmak yerine ThunderPhone'a gönderdiğinden emin olun ve numarayı yayımlamayın.
2. Çağrıları bağlamla gönderin
Studio betiğinizde, Placecall öncesinde:
X-Call-IDbaşlığı veContactIDdeğeriyle bir Sipputheader eylemi ekleyin. CXone kendi çağrı kimliği başlığını göndermez; ThunderPhone bunu çağrınınexternal_call_iddeğeri olarak kaydeder.- Ajanın bilmesi gereken diğer her değer için, örneğin
supportolarak ayarlanmışX-Skilliçin bir Sipputheader eylemi ekleyin. Bu değer isteme{{sip_x_skill}}olarak ulaşır. Sipputheader,User-to-User, tümX-başlıklarını ve çoğuP-başlığını kabul eder; NICE, 256 karakter veya daha kısa değerler önerir.
Ardından, numarayı hem istek URI'sinde hem de To başlığında kullanarak, onu
sip.thunderphone.com adresine gönderen bir trunk grubu üzerinden Placecall yapın.
Uç nokta TLS'yi (5061 numaralı bağlantı noktası) veya TCP'yi (5060 numaralı bağlantı noktası)
kabul eder ve UDP'yi reddeder. NICE trunk'ın aktarım türünü belgelemediğinden UDP
olmadığından emin olun.
3. Çağrıyı geri alın
CXone SIP başlıklarını yalnızca INVITE ve onun nihai yanıtında okur; bu nedenle
ajan çağrıyı geri döndürür: vedalaşır ve çağrıyı kapatır, ardından betiğiniz arayanı
yeniden devralır. Bu aktarım numarasını ekleyin (bkz.
Aktarım numarasını ekleyin):
{"name": "NICE CXone", "action": "return"}NICE, başlatılan çağrı sona erdiğinde bir betiğin Placecall sonrasında devam ettiğini
belgelemez. Diğer yapay zeka sağlayıcılarının CXone entegrasyonları bunun yerine,
çağrıyı kapatmadan önce CXone'un Signal API'si (POST /interactions/{contactId}/signal)
aracılığıyla betiğe sinyal gönderir; ThunderPhone bunu çağırmaz. Betiğinizin arayanı
nasıl geri devraldığını NICE ile doğrulayın, ardından bir REST API eylemiyle çağrı
aktarımı verilerini getirin:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=sonrasındaContactID.Authorization: Bearer sk_live_…başlığı.- İletişimi yönlendirmek için yanıttan
handoff.summaryvehandoff.intentdeğerlerini okuyun.
Bkz. Aktarılan bir çağrıyı arayın.
Test edin
Komut dosyasını çalıştıran bir numarayı arayın, yapay zeka ajanından bir kişi isteyin ve
komut dosyasının devam ettiğini ve REST API eyleminin aktarımı döndürdüğünü kontrol edin. Çağrı
hiç yapay zeka ajanına ulaşmıyorsa CXone'un gönderdiği numarayı, 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-call-id değerini listelemeli ve
external_call_id, ContactID ile eşit olmalıdır.
Sınırlar
- CXone, başlıkları yalnızca
INVITEve onun son2xxyanıtında gönderir ve okur; bu nedenle yapay zeka ajanınınBYEmesajındaki hiçbir şey komut dosyasına ulaşmaz. - NICE, yapay zeka ajanından gelen bir
REFERisteğini kabul etmeyi belgelemez. - REST API eylemi varsayılan olarak 10 saniye sonra zaman aşımına uğrar (en fazla 90 saniye) ve 32 KB'a kadar yanıt okur.