Open in
Připojení z Talkdesk
Směrujte hovory z Talkdesk na agenta ThunderPhone pomocí funkce Connect to Autopilot Voice a eskalujte je zpět pomocí ID předání v UUI.
Váš tok Talkdesk Studio odesílá volajícího agentovi s ID interakce
a UUI. Když volající potřebuje člověka, agent hovor eskaluje pomocí SIP
REFER do Talkdesku a ID předání se uloží do proměnné Studio.
Než začnete
- Agent ThunderPhone a organizační klíč API.
- Licence Talkdesk Conversation Orchestrator, která zahrnuje komponentu Studio Připojit k hlasovému Autopilotu v režimu Externí hlasový stream (článek Talkdesku). Talkdesk ji účtuje za minutu, dokud agent hovor obsluhuje.
1. Vytvořte koncový bod SIP
Talkdesk dokumentuje pouze seznam povolených IP adres, proto vytvořte koncový bod, který přijímá hovory podle zdrojové adresy:
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"
}'Článek Talkdesku uvádí, že odesílá zvuk přes SRTP, a "srtp": "optional"
odpoví pomocí SRTP, když ho Talkdesk nabídne. Článek neuvádí, zda Talkdesk
SRTP vyžaduje; pokud vám Talkdesk sdělí, že ano, nastavte srtp na required,
čímž odmítnete hovory bez SRTP.
Rozsahy signalizačních IP adres SIP Talkdesku získáte od Talkdesku. Každý musí
být veřejný rozsah IPv4 o velikosti /16 nebo menší (IPv6 /48 nebo menší).
Viz Platformy ověřované podle zdrojové IP adresy.
Talkdesk odesílá SIP ze sítě Twilio, jejíž adresy sdílejí všichni zákazníci
Twilio, takže právě adresa koncového bodu brání přístupu ostatních volajících:
nezveřejňujte ji.
Uložte si sip_uri z odpovědi, například
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. Odesílejte hovory s kontextem
Ve svém toku Studio přidejte Připojit k hlasovému Autopilotu v režimu
Externí hlasový stream a jako cíl nastavte sip_uri koncového bodu s přidaným ;transport=tls,
například sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls. Koncový
bod odmítá hovory přes UDP, které SIP Twilio používá, pokud není určeno jinak.
Talkdesk odesílá:
X-Talkdesk-Interaction-Id, uložené jakoexternal_call_idhovoru;User-to-User, kódované hexadecimálně, napříkladbusiness_hours=open. Do promptu dorazí dekódované jako{{sip_uui}}.
Verze 2.1 komponenty může také odesílat Definované hlavičky. Stránka předvoleb Talkdesku je popisuje jako JSON odesílaný přes WebSocket, proto si u Talkdesku ověřte, zda dorazí jako hlavičky SIP, než se na ně spolehnete.
3. Získejte hovor zpět
Agent eskaluje pomocí REFER na eskalační adresu Talkdesk, přičemž ID předání
je jako hexadecimální UUI uvnitř této adresy, což je jediné místo, odkud ho
Talkdesk načítá. Přidejte toto číslo pro přenos (viz
Přidání čísla pro přenos
a Hlavičky uvnitř adresy pro přenos):
{
"name": "Talkdesk escalation",
"number": "sip:escalation@talkdesk.com",
"headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
"headers_in_uri": true,
"uui_encoding": "hex"
}Adresa je uvedena v článku Talkdesk. Verze komponenty 2.1 načítá
autopilot_result=; verze 1.7 načítá escalate_to=, proto u verze 1.7 použijte
tento klíč. REFER vypadá takto:
Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>
Talkdesk uloží hodnotu do proměnné Studio. Chcete-li získat shrnutí a záměr, přidejte krok Spustit akci do vlastní integrace vytvořené pomocí Připojení:
- Typ ověřování Klíč API, název hlavičky
Authorization, hodnotaBearer sk_live_…. - Požadavek:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=následovaný ID z proměnné. Hovor můžete také vyhledat podleexternal_call_idpomocí ID interakce. - Směrujte podle
handoff.intenta zobraztehandoff.summaryosobě, která hovor převezme.
Viz Vyhledání předaného hovoru.
Otestujte jej
Spusťte hovor prostřednictvím toku Studio, požádejte agenta o spojení s
člověkem a ověřte, že tok pokračuje za komponentou s ID předání ve své
proměnné. Poté otevřete hovor pomocí GET /v1/calls/{call_id}:
external_call_id by mělo být ID interakce Talkdesk.
Omezení
- Talkdesk načítá maximálně 256 bajtů UUI a nepovoluje hodnoty oddělené znaky
|ani;, proto odešlete jednu hodnotu. ID předání se vejde. - Rozhraní API Talkdesk nemohou načíst přepis agenta. Místo toho použijte
vyhledání předaného hovoru nebo
GET /v1/calls/{call_id}.