ThunderPhone v3 już działa.Uruchom samodzielnie, od 2¢/min.Przeczytaj komunikat

Contact centers

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 /16 lub węższym (IPv6 /48 lub 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 kod 409.

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:

  1. Dodaj akcję Sipputheader z nagłówkiem X-Call-ID i wartością ContactID. CXone nie wysyła własnego nagłówka call-id; ThunderPhone zapisuje ten nagłówek jako external_call_id połączenia.
  2. Dodaj akcję Sipputheader dla każdej innej wartości, którą agent powinien znać, na przykład X-Skill ustawione na support. Trafia ona do promptu jako {{sip_x_skill}}. Sipputheader obsługuje User-to-User, dowolny nagłówek X- oraz większość nagłówków P-; 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ępuje ContactID.
  • Nagłówek Authorization: Bearer sk_live_….
  • Odczytaj z odpowiedzi handoff.summary i handoff.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 INVITE i jego końcowej odpowiedzi 2xx, więc nic z BYE agenta nie dociera do skryptu.
  • NICE nie dokumentuje obsługi REFER od 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.