ThunderPhone v3 já está no ar.Contrate online, a partir de 2¢/min.Leia o anúncio

Contact centers

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 o external_call_id da chamada;
  • User-to-User, codificado em hexadecimal, como business_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, valor Bearer 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 por external_call_id usando o ID da interação.
  • Ramifique com base em handoff.intent e mostre handoff.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}.