---
title: "Conectarse desde Genesys Cloud"
description: "Envía llamadas de Genesys Cloud a un agente de ThunderPhone mediante un troncal de BYOC Cloud con el ID de conversación y UUI, y recíbelas de vuelta con la transferencia en UUI."
---

El flujo de Architect envía a quien llama al agente a través de una troncal BYOC Cloud, con el id de conversación y cualquier UUI que configures. Cuando quien llama necesita hablar con una persona, el agente envía un `REFER` de SIP, Genesys retoma la llamada y el id de transferencia llega en la UUI de la llamada.

## Antes de comenzar

- Un agente de ThunderPhone y una [clave de API](/es/guides/api-keys) de la organización.
- Genesys Cloud con BYOC Cloud y una troncal externa (tipo BYOC Carrier o
  PBX) con estas configuraciones activadas
  ([configuración de la troncal externa](https://help.genesys.cloud/articles/external-trunk-settings/)):
  - **Encabezados de conversación**, para que Genesys envíe su id de conversación en
    `x-inin-cnv`. Está desactivado de forma predeterminada.
  - **Transferencia de UUI**, con tipo de encabezado `User-To-User` y codificación Hex.
  - **Retomar y transferir**, para que Genesys acepte el `REFER` del agente.

## 1. Crea el endpoint SIP

Genesys responde a un desafío Digest, así que usa un endpoint estándar:

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

Guarda de inmediato el `password` de la respuesta; se muestra una sola vez. En la
troncal:

| Configuración | Valor |
|---|---|
| Servidor SIP | `sip.thunderphone.com`, puerto `5061` |
| Protocolo | TLS |
| Autenticación Digest | el `username` y el `password` del endpoint |
| Códecs | PCMU, PCMA o G.722 |

Coloca la troncal en una ruta saliente de tu sitio cuyo plan de numeración cubra la
dirección que marca el flujo.

## 2. Envía llamadas con contexto

En tu flujo de Architect:

1. De forma opcional, agrega una acción **Establecer datos UUI** con contexto para el agente, como
   `account=12345`. Genesys recomienda 128 caracteres o menos.
2. Agrega una acción **Transferir a número** con el `sip_uri` del endpoint, por
   ejemplo `sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

Genesys envía el id de conversación en `x-inin-cnv`. ThunderPhone lo almacena como
el `external_call_id` de la llamada. La UUI llega al prompt decodificada, como
`{{sip_uui}}`.

Los encabezados personalizados de la troncal son estáticos en Genesys, así que coloca los valores por llamada en la UUI.
Genesys reserva para sí los prefijos de encabezados `x-inin`, `x-genesys`, `x-pcv` y `x-gcv`.

## 3. Recupera la llamada

El agente transfiere con un `REFER` a una dirección en Genesys, con el id de transferencia
como UUI hexadecimal dentro de esa dirección. Agrega este número de transferencia (consulta
[Agregar el número de transferencia](/es/guides/contact-centers/overview)
y [Encabezados dentro de la dirección de transferencia](/es/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"
}
```

Reemplaza la dirección por una que enrute de vuelta a la cola o al flujo que debe
atender a quien llama; confirma su formato con Genesys. El `REFER` tiene este aspecto:

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

Con **Retomar y transferir** activado, Genesys retoma la llamada desde la troncal
y la enruta a esa dirección. Genesys documenta que la UUI entrante llega a
`Call.UUIData`; no lo documenta para una recuperación, así que confirma con
Genesys, o en una llamada de prueba, que el flujo que recibe a quien llama encuentre
allí el id de transferencia. Para obtener el resumen y la intención, llama a la búsqueda
de transferencia con una **Acción de datos de llamada** en una integración de Acciones de datos de servicios web:

- Solicitud: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  seguido del id de `Call.UUIData`.
- Credenciales: tu clave de API, enviada como `Authorization: Bearer sk_live_…`.
- Salida: asigna `handoff.summary` y `handoff.intent` a variables del flujo.

Consulta [Buscar una llamada transferida](/api-reference/calls#look-up-a-handed-off-call).

## Pruébalo

Llama a un número que llegue al flujo, pídele al agente que te comunique con una persona y verifica que Genesys lleve la llamada a la dirección que configuraste. En ese flujo, verifica que
`Call.UUIData` contenga el id de transferencia como texto (si muestra dígitos hexadecimales, verifica que la codificación UUI del troncal sea Hex). Luego abre la llamada con `GET /v1/calls/{call_id}`:
`external_call_id` debe ser el id de la conversación.

## Límites

- La acción **Obtener encabezados SIP** lee solo el `INVITE` inicial, por lo que no puede
  leer nada del `REFER` del agente. La transferencia llega a Genesys solo
  mediante UUI.
- Genesys descarta toda la UUI cuando una llamada incluye más de un encabezado UUI.
- La dirección de transferencia se limita a 254 caracteres, por lo que una UUI larga se recorta para ajustarse.
  Un id de transferencia siempre cabe.
