ThunderPhone v3 je venku.Spustíte sami, od 2 ¢/min.Přečíst oznámení

Contact centers

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é jako external_call_id hovoru;
  • User-to-User, kódované hexadecimálně, například business_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, hodnota Bearer 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 podle external_call_id pomocí ID interakce.
  • Směrujte podle handoff.intent a zobrazte handoff.summary osobě, 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}.