Open in
Conectar a partir do Talkdesk
Envie chamadas do Talkdesk para um agente ThunderPhone com o Connect to Autopilot Voice e encaminhe-as de volta com o ID de transferência na UUI.
O fluxo do Talkdesk Studio envia quem liga ao agente com o ID da interação
e o UUI. Quando quem liga precisa de uma pessoa, o agente escala com um
REFER SIP para o Talkdesk, e o ID da transferência chega em uma variável do Studio.
Antes de começar
- Um agente do ThunderPhone e uma chave de API da organização.
- Uma licença do Talkdesk Conversation Orchestrator, que cobre o componente Conectar ao Autopilot Voice do Studio no modo Fluxo de voz externo (artigo da Talkdesk). O Talkdesk cobra por minuto enquanto o agente mantém a chamada.
1. Crie o endpoint SIP
O Talkdesk documenta apenas uma lista de permissões de IP, então crie um endpoint que aceite chamadas por endereço de origem:
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"
}'O artigo da Talkdesk informa que ela envia áudio por SRTP, e "srtp": "optional"
responde com SRTP quando o Talkdesk o oferece. O artigo não informa se o Talkdesk
exige SRTP; se o Talkdesk informar que sim, defina srtp como required, o que
recusa chamadas sem ele.
Obtenha as faixas de sinalização SIP do Talkdesk com o Talkdesk. Cada uma deve ser uma faixa
IPv4 pública de /16 ou mais específica (IPv6 /48 ou mais específica). Consulte
Plataformas que autenticam por IP de origem.
O Talkdesk envia SIP pela rede da Twilio, cujos endereços são compartilhados por todos os clientes da Twilio,
portanto o endereço do endpoint é o que impede outros chamadores de entrar: não
o publique.
Guarde o sip_uri da resposta, por exemplo
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. Envie chamadas com contexto
No fluxo do Studio, adicione Conectar ao Autopilot Voice no modo Fluxo de voz
externo e defina o destino como o sip_uri do endpoint com ;transport=tls adicionado, por
exemplo, sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls. O
endpoint recusa chamadas por UDP, que é o protocolo usado pelo SIP da Twilio, a menos que seja informado o contrário.
O Talkdesk envia:
X-Talkdesk-Interaction-Id, armazenado como oexternal_call_idda chamada;User-to-User, codificado em hexadecimal, comobusiness_hours=open. Ele chega ao prompt decodificado, como{{sip_uui}}.
A versão 2.1 do componente também pode enviar Cabeçalhos definidos. A página de preferências do Talkdesk os descreve como JSON enviado por um WebSocket, portanto confirme com o Talkdesk se eles chegam como cabeçalhos SIP antes de depender deles.
3. Receba a chamada de volta
O agente encaminha a escalada com um REFER para o endereço de escalada do Talkdesk, com o ID de transferência como UUI hexadecimal dentro desse endereço, o único lugar onde o Talkdesk o lê. Adicione este número de transferência (consulte
Adicionar o número de transferência
e Cabeçalhos dentro do endereço de transferência):
{
"name": "Talkdesk escalation",
"number": "sip:escalation@talkdesk.com",
"headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
"headers_in_uri": true,
"uui_encoding": "hex"
}O endereço é o informado no artigo do Talkdesk. A versão 2.1 do componente
lê autopilot_result=; a versão 1.7 lê escalate_to=, portanto use essa chave
na versão 1.7. O REFER fica assim:
Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>
O Talkdesk coloca o valor em uma variável do Studio. Para obter o resumo e a intenção, adicione uma etapa Executar ação em uma integração personalizada criada com Connections:
- Tipo de autenticação Chave de API, nome do cabeçalho
Authorization, valorBearer sk_live_…. - Solicitação:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=seguido pelo ID da variável. Você também pode buscar a chamada porexternal_call_idusando o ID da interação. - Ramifique com base em
handoff.intente mostrehandoff.summaryà pessoa que atende a chamada.
Consulte Buscar uma chamada transferida.
Teste
Inicie uma chamada pelo fluxo do Studio, peça ao agente para falar com uma pessoa e verifique
se o fluxo continua após o componente com o ID de transferência em sua variável. Em seguida, abra a chamada com GET /v1/calls/{call_id}:
external_call_id deve ser o ID da interação do Talkdesk.
Limites
- O Talkdesk lê no máximo 256 bytes de UUI e não permite valores separados por
|ou;, portanto envie um único valor. O ID de transferência cabe. - As APIs do Talkdesk não conseguem ler a transcrição do agente. Use a busca de transferência ou
GET /v1/calls/{call_id}.