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

Contact centers

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-User i kodowaniem Hex.
    • Przejęcie z powrotem i transfer, aby Genesys akceptował REFER agenta.

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:

UstawienieWartość
Serwer SIPsip.thunderphone.com, port 5061
ProtokółTLS
Uwierzytelnianie digestusername i password punktu końcowego
KodekiPCMU, 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:

  1. Opcjonalnie dodaj akcję Ustaw dane UUI z kontekstem dla agenta, na przykład account=12345. Genesys zaleca maksymalnie 128 znaków.
  2. Dodaj akcję Transfer na numer z sip_uri punktu końcowego, na przykład sip: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 z Call.UUIData.
  • Poświadczenia: klucz API wysłany jako Authorization: Bearer sk_live_….
  • Dane wyjściowe: zmapuj handoff.summary i handoff.intent na 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 z REFER agenta. 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.