Open in
Połącz z Genesys Cloud
Przekierowuj połączenia Genesys Cloud do agenta ThunderPhone przez trunk BYOC Cloud z identyfikatorem rozmowy i UUI, a następnie kieruj je z powrotem z przekazaniem w UUI.
Przepływ Architect wysyła rozmówcę do agenta przez trunk BYOC Cloud wraz z identyfikatorem konwersacji i dowolnym ustawionym przez Ciebie UUI. Gdy rozmówca potrzebuje człowieka, agent wysyła SIP REFER, Genesys przejmuje połączenie z powrotem, a identyfikator przekazania trafia do UUI połączenia.
Zanim zaczniesz
- Agent ThunderPhone i organizacyjny klucz API.
- Genesys Cloud z BYOC Cloud oraz trunk zewnętrzny (typ BYOC Carrier lub
PBX) z włączonymi tymi ustawieniami
(ustawienia trunku zewnętrznego):
- Nagłówki konwersacji, aby Genesys wysyłał identyfikator konwersacji w
x-inin-cnv. Domyślnie jest wyłączone. - Przekazywanie UUI, z typem nagłówka
User-To-Useri kodowaniem Hex. - Przejęcie z powrotem i transfer, aby Genesys akceptował
REFERagenta.
- Nagłówki konwersacji, aby Genesys wysyłał identyfikator konwersacji w
1. Utwórz punkt końcowy SIP
Genesys odpowiada na wyzwanie digest, więc użyj standardowego punktu końcowego:
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": "Genesys Cloud"}'Od razu zapisz password z odpowiedzi; jest wyświetlane tylko raz. Na
trunku:
| Ustawienie | Wartość |
|---|---|
| Serwer SIP | sip.thunderphone.com, port 5061 |
| Protokół | TLS |
| Uwierzytelnianie digest | username i password punktu końcowego |
| Kodeki | PCMU, PCMA lub G.722 |
Umieść trunk na trasie wychodzącej witryny, której plan numeracyjny obejmuje adres wybierany przez przepływ.
2. Wysyłaj połączenia z kontekstem
W przepływie Architect:
- Opcjonalnie dodaj akcję Ustaw dane UUI z kontekstem dla agenta, na
przykład
account=12345. Genesys zaleca maksymalnie 128 znaków. - Dodaj akcję Transfer na numer z
sip_uripunktu końcowego, na przykładsip:agent-12-jhxmginwjx@sip.thunderphone.com.
Genesys wysyła identyfikator konwersacji w x-inin-cnv. ThunderPhone zapisuje
go jako external_call_id połączenia. UUI trafia do promptu w postaci
zdekodowanej jako {{sip_uui}}.
Niestandardowe nagłówki trunku są statyczne w Genesys, dlatego wartości
specyficzne dla połączenia umieszczaj w UUI. Genesys rezerwuje dla siebie
prefiksy nagłówków x-inin, x-genesys, x-pcv i x-gcv.
3. Przejmij połączenie z powrotem
Agent przekazuje połączenie za pomocą REFER na adres w Genesys, z
identyfikatorem przekazania jako szesnastkowym UUI w tym adresie. Dodaj ten
numer transferu (zobacz
Dodawanie numeru transferu
oraz Nagłówki w adresie transferu):
{
"name": "Genesys support",
"number": "sip:support@acme.byoc.mypurecloud.com",
"headers": {"User-to-User": "{{handoff_id}}"},
"headers_in_uri": true,
"uui_encoding": "hex"
}Zastąp adres takim, który kieruje z powrotem do kolejki lub przepływu
obsługującego rozmówcę; potwierdź jego format w Genesys. REFER wygląda tak:
Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>
Po włączeniu Przejęcia z powrotem i transferu Genesys przejmuje połączenie
z powrotem z trunku i kieruje je na ten adres. Genesys dokumentuje, że
przychodzące UUI trafia do Call.UUIData; nie dokumentuje tego dla przejęcia
z powrotem, dlatego potwierdź w Genesys lub podczas połączenia testowego, że
przepływ odbierający rozmówcę znajduje tam identyfikator przekazania. Aby
pobrać podsumowanie i intencję, wywołaj wyszukiwanie przekazania za pomocą
Akcji danych połączenia w integracji Akcje danych usług internetowych:
- Żądanie:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=z identyfikatorem zCall.UUIData. - Poświadczenia: klucz API wysłany jako
Authorization: Bearer sk_live_…. - Dane wyjściowe: zmapuj
handoff.summaryihandoff.intentna zmienne przepływu.
Zobacz Wyszukiwanie przekazanego połączenia.
Przetestuj
Zadzwoń na numer kierujący do przepływu, poproś agenta o połączenie z osobą i sprawdź, czy
Genesys przekierowuje połączenie na ustawiony adres. W tym przepływie sprawdź, czy
Call.UUIData zawiera identyfikator przekazania jako tekst (jeśli wyświetla cyfry szesnastkowe, sprawdź, czy kodowanie UUI magistrali jest ustawione na Hex). Następnie otwórz połączenie za pomocą GET /v1/calls/{call_id}:
external_call_id powinno być identyfikatorem rozmowy.
Ograniczenia
- Akcja Pobierz nagłówki SIP odczytuje tylko początkowe
INVITE, więc nie może odczytać niczego zREFERagenta. Przekazanie dociera do Genesys wyłącznie przez UUI. - Genesys odrzuca wszystkie dane UUI, gdy połączenie zawiera więcej niż jeden nagłówek UUI.
- Adres przekierowania jest ograniczony do 254 znaków, więc długie UUI jest skracane, aby się zmieściło. Identyfikator przekazania zawsze się mieści.