Open in
Połącz z NICE CXone
Przekierowuj połączenia NICE CXone do agenta ThunderPhone ze skryptu Studio, umieszczając ContactID w nagłówku SIP, a następnie wyszukuj przekazanie agenta, gdy skrypt jest kontynuowany.
Skrypt CXone Studio wykonuje połączenie z agentem, używając nagłówków SIP zawierających identyfikator kontaktu i wszelki inny kontekst. Gdy agent zakończy pracę, rozłącza się, a akcja REST API w skrypcie pobiera przekazanie.
Zanim zaczniesz
- Agent ThunderPhone i klucz API organizacji.
- Grupa łączy SIP CXone akceptująca niestandardowe nagłówki. Przed wysłaniem ich przez CXone przedstawiciel NICE obsługujący Twoje konto musi włączyć to ustawienie.
1. Utwórz punkt końcowy SIP
Placecall wybiera numer telefonu przez grupę łączy CXone, a nie adres SIP.
NICE nie dokumentuje dla niego poświadczeń SIP, a integracja CXone innego dostawcy AI
używa TLS z listą dozwolonych adresów IP. Utwórz więc punkt końcowy ip_allowlist
z numerem, który skrypt będzie wybierać, jako numerem do połączeń przychodzących (zobacz
Platformy wybierające numer telefonu):
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: zakresy sygnalizacji SIP klastra CXone, otrzymane od NICE. Każdy musi być publicznym zakresem IPv4/16lub węższym (IPv6/48lub węższym).dial_in_numbers: numer, który wybierze Placecall, zapisany w formie, w jakiej wysyła go CXone. Nie musi być prawdziwym numerem telefonu. Nie może już być używany w ThunderPhone jako numer telefonu ani w innym punkcie końcowym: w takim przypadku zwracany jest kod409.
Adresy CXone są współdzielone przez wszystkich klientów, więc każdy inny klient CXone, który wybierze ten numer, dotrze do Twojego agenta. Wybierając numer, użyj długiego, którego nikt nie odgadnie (do 15 cyfr), upewnij się, że CXone wysyła go do ThunderPhone, a nie do sieci telefonicznej, i nie publikuj go.
2. Wysyłaj połączenia z kontekstem
W skrypcie Studio, przed Placecall:
- Dodaj akcję Sipputheader z nagłówkiem
X-Call-IDi wartościąContactID. CXone nie wysyła własnego nagłówka call-id; ThunderPhone zapisuje ten nagłówek jakoexternal_call_idpołączenia. - Dodaj akcję Sipputheader dla każdej innej wartości, którą agent powinien znać,
na przykład
X-Skillustawione nasupport. Trafia ona do promptu jako{{sip_x_skill}}. Sipputheader obsługujeUser-to-User, dowolny nagłówekX-oraz większość nagłówkówP-; NICE zaleca wartości liczące maksymalnie 256 znaków.
Następnie wykonaj Placecall na ten numer przez grupę łączy, która wysyła go do
sip.thunderphone.com z numerem zarówno w identyfikatorze URI żądania, jak i nagłówku To.
Punkt końcowy obsługuje TLS (port 5061) lub TCP (port 5060) i odrzuca UDP, a NICE nie
dokumentuje transportu łącza, więc upewnij się, że nie jest to UDP.
3. Odbierz połączenie z powrotem
CXone odczytuje nagłówki SIP tylko w INVITE i jego końcowej odpowiedzi, dlatego agent
zwraca połączenie: żegna się i rozłącza, a skrypt ponownie przejmuje rozmówcę. Dodaj ten
numer przekierowania (zobacz
Dodaj numer przekierowania):
{"name": "NICE CXone", "action": "return"}NICE nie dokumentuje, że skrypt kontynuuje działanie po Placecall, gdy wykonane
połączenie się zakończy. Integracje CXone innych dostawców AI zamiast tego sygnalizują
skryptowi przez Signal API CXone (POST /interactions/{contactId}/signal), zanim się
rozłączą; ThunderPhone go nie wywołuje. Potwierdź z NICE, w jaki sposób Twój skrypt
ponownie przejmuje rozmówcę, a następnie pobierz przekazanie za pomocą akcji REST API:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=po którym następujeContactID.- Nagłówek
Authorization: Bearer sk_live_…. - Odczytaj z odpowiedzi
handoff.summaryihandoff.intent, aby skierować kontakt.
Zobacz Wyszukiwanie przekazanego połączenia.
Przetestuj
Zadzwoń na numer uruchamiający skrypt, poproś agenta o osobę i sprawdź, czy
skrypt jest kontynuowany, a akcja interfejsu REST API zwraca przekazanie połączenia. Jeśli połączenie
nigdy nie dociera do agenta, sprawdź numer wysyłany przez CXone, czy jego adres
źródłowy znajduje się w allowed_source_cidrs oraz czy połączenie odbyło się przez TCP lub TLS. Następnie otwórz
połączenie za pomocą GET /v1/calls/{call_id}: sip_headers powinno zawierać x-call-id, a
external_call_id powinno być równe ContactID.
Ograniczenia
- CXone wysyła i odczytuje nagłówki tylko w
INVITEi jego końcowej odpowiedzi2xx, więc nic zBYEagenta nie dociera do skryptu. - NICE nie dokumentuje obsługi
REFERod agenta. - Akcja interfejsu REST API domyślnie przekracza limit czasu po 10 sekundach (maksymalnie przed upływem 90 sekund) i odczytuje odpowiedzi o rozmiarze do 32 KB.