---
title: "Conectar a partir do Talkdesk"
description: "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](/pt/guides/api-keys) 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](https://support.talkdesk.com/hc/en-us/articles/48921776047259)).
  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:

```bash
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](/pt/guides/sip-addresses).
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](/pt/guides/contact-centers/overview)
e [Cabeçalhos dentro do endereço de transferência](/pt/guides/call-transfers)):

```json
{
  "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](/api-reference/calls#look-up-a-handed-off-call).

## 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}`.
