Open in
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 jakoexternal_call_idpołączenia;User-to-User, zakodowany szesnastkowo, na przykładbusiness_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 poexternal_call_id, używając identyfikatora interakcji. - Skieruj przepływ na podstawie
handoff.intenti pokażhandoff.summaryosobie 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}.