---
title: "Conectar a partir do Genesys Cloud"
description: "Envie chamadas do Genesys Cloud para um agente do ThunderPhone por meio de um tronco BYOC Cloud com o ID da conversa e UUI, e retorne-as com a transferência em UUI."
---

Seu fluxo do Architect envia quem liga ao agente por um tronco BYOC Cloud, com o ID da conversa e qualquer UUI que você definir. Quando quem liga precisa falar com uma pessoa, o agente envia um `REFER` SIP, o Genesys recupera a chamada, e o ID de transferência chega na UUI da chamada.

## Antes de começar

- Um agente do ThunderPhone e uma [chave de API](/pt/guides/api-keys) da organização.
- Genesys Cloud com BYOC Cloud e um tronco externo (tipo BYOC Carrier ou
  PBX) com estas configurações ativadas
  ([configurações de tronco externo](https://help.genesys.cloud/articles/external-trunk-settings/)):
  - **Cabeçalhos de conversa**, para que o Genesys envie o ID da conversa em
    `x-inin-cnv`. Essa opção fica desativada por padrão.
  - **Passagem de UUI**, com tipo de cabeçalho `User-To-User` e codificação Hex.
  - **Recuperar e transferir**, para que o Genesys aceite o `REFER` do agente.

## 1. Crie o endpoint SIP

O Genesys responde a uma solicitação de autenticação digest, então use um endpoint padrão:

```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": "Genesys Cloud"}'
```

Armazene imediatamente o `password` da resposta; ele é exibido apenas uma vez. No
tronco:

| Configuração | Valor |
|---|---|
| Servidor SIP | `sip.thunderphone.com`, porta `5061` |
| Protocolo | TLS |
| Autenticação digest | o `username` e o `password` do endpoint |
| Codecs | PCMU, PCMA ou G.722 |

Coloque o tronco em uma rota de saída do seu site cujo plano de numeração cubra
o endereço discado pelo fluxo.

## 2. Envie chamadas com contexto

No seu fluxo do Architect:

1. Opcionalmente, adicione uma ação **Definir dados UUI** com contexto para o agente, como
   `account=12345`. O Genesys recomenda 128 caracteres ou menos.
2. Adicione uma ação **Transferir para número** com o `sip_uri` do endpoint, por
   exemplo, `sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

O Genesys envia o ID da conversa em `x-inin-cnv`. O ThunderPhone o armazena como
o `external_call_id` da chamada. A UUI chega ao prompt decodificada, como
`{{sip_uui}}`.

Os cabeçalhos personalizados do tronco são estáticos no Genesys, então coloque
os valores por chamada na UUI. O Genesys reserva os prefixos de cabeçalho
`x-inin`, `x-genesys`, `x-pcv` e `x-gcv` para uso próprio.

## 3. Recupere a chamada

O agente transfere com um `REFER` para um endereço no Genesys, com o ID de transferência
como UUI hexadecimal dentro desse endereço. 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": "Genesys support",
  "number": "sip:support@acme.byoc.mypurecloud.com",
  "headers": {"User-to-User": "{{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}
```

Substitua o endereço por um que encaminhe de volta para a fila ou o fluxo que deve
receber quem liga; confirme o formato com o Genesys. O `REFER` tem esta aparência:

```
Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>
```

Com **Recuperar e transferir** ativado, o Genesys recupera a chamada do tronco
e a encaminha para esse endereço. O Genesys documenta que a UUI de entrada chega em
`Call.UUIData`; ele não documenta isso para uma recuperação, então confirme com
o Genesys, ou em uma chamada de teste, que o fluxo que recebe quem liga encontra
o ID de transferência ali. Para obter o resumo e a intenção, faça a consulta da transferência
com uma **Ação de dados de chamada** em uma integração Web Services Data Actions:

- Solicitação: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  seguido pelo ID de `Call.UUIData`.
- Credenciais: sua chave de API, enviada como `Authorization: Bearer sk_live_…`.
- Saída: mapeie `handoff.summary` e `handoff.intent` para variáveis do fluxo.

Consulte [Consultar uma chamada transferida](/api-reference/calls#look-up-a-handed-off-call).

## Teste

Ligue para um número que alcance o fluxo, peça ao agente uma pessoa e verifique se
o Genesys encaminha a chamada para o endereço que você definiu. Nesse fluxo, verifique se
`Call.UUIData` contém o ID de transferência como texto (se ele mostrar dígitos hexadecimais, verifique se a codificação UUI do tronco está em Hex). Em seguida, abra a chamada com `GET /v1/calls/{call_id}`:
`external_call_id` deve ser o ID da conversa.

## Limites

- A ação **Obter cabeçalhos SIP** lê apenas o `INVITE` inicial, portanto não consegue
  ler nada do `REFER` do agente. A transferência chega ao Genesys apenas
  por UUI.
- O Genesys descarta todos os dados UUI quando uma chamada contém mais de um cabeçalho UUI.
- O endereço de transferência é limitado a 254 caracteres, portanto uma UUI longa é cortada para caber.
  Um ID de transferência sempre cabe.
