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

Contact centers

Połącz z Talkdesk

Przekierowuj połączenia z Talkdesk do agenta ThunderPhone za pomocą Connect to Autopilot Voice i eskaluj je z powrotem, używając identyfikatora przekazania w UUI.

Przepływ Talkdesk Studio wysyła rozmówcę do agenta wraz z identyfikatorem interakcji i UUI. Gdy rozmówca potrzebuje człowieka, agent eskaluje połączenie za pomocą SIP REFER do Talkdesk, a identyfikator przekazania trafia do zmiennej Studio.

Przed rozpoczęciem

  • Agent ThunderPhone i organizacyjny klucz API.
  • Licencja Talkdesk Conversation Orchestrator, która obejmuje komponent Studio Connect to Autopilot Voice w trybie External Voice Stream (artykuł Talkdesk). Talkdesk nalicza opłatę za minutę, gdy agent obsługuje połączenie.

1. Utwórz punkt końcowy SIP

Talkdesk dokumentuje wyłącznie listę dozwolonych adresów IP, dlatego utwórz punkt końcowy, który akceptuje połączenia według adresu źródłowego:

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": "Talkdesk",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["TALKDESK_SIGNALLING_RANGE_1", "TALKDESK_SIGNALLING_RANGE_2"],
    "srtp": "optional"
  }'

Artykuł Talkdesk podaje, że wysyła ono dźwięk przez SRTP, a "srtp": "optional" odpowiada przez SRTP, gdy Talkdesk je oferuje. Artykuł nie określa, czy Talkdesk wymaga SRTP; jeśli Talkdesk poinformuje Cię, że tak jest, ustaw srtp na required, co odrzuca połączenia bez niego.

Uzyskaj zakresy sygnalizacji SIP Talkdesk od Talkdesk. Każdy z nich musi być publicznym zakresem IPv4 o masce /16 lub węższej (IPv6 /48 lub węższej). Zobacz Platformy uwierzytelniające według źródłowego adresu IP. Talkdesk wysyła SIP z sieci Twilio, której adresy są współdzielone przez każdego klienta Twilio, dlatego adres punktu końcowego uniemożliwia dostęp innym rozmówcom: nie publikuj go. Zachowaj sip_uri z odpowiedzi, na przykład sip:agent-12-jhxmginwjx@sip.thunderphone.com.

2. Wysyłaj połączenia z kontekstem

W przepływie Studio dodaj Connect to Autopilot Voice w trybie External Voice Stream i ustaw jego cel na sip_uri punktu końcowego z dodanym ;transport=tls, na przykład sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls. Punkt końcowy odrzuca połączenia przez UDP, którego SIP Twilio używa, jeśli nie zostanie wskazane inaczej.

Talkdesk wysyła:

  • X-Talkdesk-Interaction-Id, przechowywany jako external_call_id połączenia;
  • User-to-User, zakodowany szesnastkowo, na przykład business_hours=open. Dociera do promptu po zdekodowaniu jako {{sip_uui}}.

Wersja 2.1 komponentu może również wysyłać Defined headers. Strona preferencji Talkdesk opisuje je jako JSON wysyłany przez WebSocket, dlatego potwierdź w Talkdesk, czy docierają jako nagłówki SIP, zanim na nich polegasz.

3. Odbierz połączenie

Agent przekazuje połączenie za pomocą REFER na adres eskalacji Talkdesk, z identyfikatorem przekazania jako szesnastkowym UUI w tym adresie — jedynym miejscu, z którego Talkdesk go odczytuje. Dodaj ten numer przekierowania (zobacz Dodawanie numeru przekierowania oraz Nagłówki w adresie przekierowania):

{
  "name": "Talkdesk escalation",
  "number": "sip:escalation@talkdesk.com",
  "headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}

Adres jest zgodny z artykułem Talkdesk. Wersja 2.1 komponentu odczytuje autopilot_result=; wersja 1.7 odczytuje escalate_to=, więc w wersji 1.7 użyj tego klucza. REFER wygląda tak:

Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>

Talkdesk umieszcza wartość w zmiennej Studio. Aby uzyskać podsumowanie i intencję, dodaj krok Wykonaj działanie w niestandardowej integracji utworzonej za pomocą Connections:

  • Typ uwierzytelniania: Klucz API, nazwa nagłówka Authorization, wartość Bearer sk_live_….
  • Żądanie: GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=, po którym podaj identyfikator ze zmiennej. Możesz też wyszukać połączenie po external_call_id, używając identyfikatora interakcji.
  • Skieruj przepływ na podstawie handoff.intent i pokaż handoff.summary osobie odbierającej połączenie.

Zobacz Wyszukiwanie przekazanego połączenia.

Testowanie

Rozpocznij połączenie w przepływie Studio, poproś agenta o połączenie z osobą i sprawdź, czy przepływ kontynuuje działanie po komponencie, a identyfikator przekazania znajduje się w jego zmiennej. Następnie otwórz połączenie za pomocą GET /v1/calls/{call_id}: external_call_id powinien być identyfikatorem interakcji Talkdesk.

Ograniczenia

  • Talkdesk odczytuje maksymalnie 256 bajtów UUI i nie zezwala na wartości rozdzielane przez | ani ;, dlatego wysyłaj jedną wartość. Identyfikator przekazania się mieści.
  • Interfejsy API Talkdesk nie mogą odczytać transkrypcji agenta. Zamiast tego użyj wyszukiwania przekazania lub GET /v1/calls/{call_id}.