---
title: "Conéctate desde Amazon Connect"
description: "Envía llamadas de Amazon Connect a un agente de ThunderPhone mediante SIP con el ID de contacto y UUI, y reanuda tu flujo con la transferencia del agente."
---

Tu flujo de Amazon Connect envía a quien llama al agente con el ID de contacto y
cualquier UUI que configures. Cuando el agente termina, cuelga, tu flujo continúa y
una Lambda obtiene la transferencia mediante el ID de contacto.

## Antes de comenzar

- Un agente de ThunderPhone y una [clave de API](/es/guides/api-keys) de la organización.
- El conector de **Transferencia de voz externa** de Amazon Connect. Primero solicita el
  aumento de cuota de "Conectores de transferencia de voz externa por cuenta": el
  menú permanece oculto hasta que AWS lo aprueba. AWS factura cada conector por día
  ([$100 al día desde el 21 de julio de 2025](https://aws.amazon.com/about-aws/whats-new/2025/07/amazon-connect-announces-per-day/))
  más el uso por minuto.

<Warning>
  La guía de administración actual de AWS ya no incluye páginas sobre la transferencia
  de voz externa. Antes de implementarla, confirma con AWS que el conector está
  disponible para tu instancia y Región.
</Warning>

## 1. Crea el punto de conexión SIP

El conector no documenta la autenticación de resumen SIP, así que crea un
punto de conexión que acepte llamadas por dirección de origen:

```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": "Amazon Connect",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["CONNECT_SIGNALLING_RANGE_1", "CONNECT_SIGNALLING_RANGE_2"]
  }'
```

Obtén de AWS los rangos de señalización SIP del conector para tu Región. Cada uno debe ser
un rango IPv4 público de `/16` o más específico (IPv6 `/48` o más específico). Consulta
[Plataformas que se autentican mediante IP de origen](/es/guides/sip-addresses)
para conocer las reglas y el riesgo de una dirección compartida por cada cliente de la
plataforma. Conserva el `sip_uri` de la respuesta, por ejemplo,
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. Envía llamadas con contexto

1. En la consola de Amazon Connect, abre **Sistemas de voz externos → Integraciones de
   transferencia de voz** y selecciona **Crear**.
2. Elige el tipo de destino (un SBC) y agrega una ruta saliente con el host
   `sip.thunderphone.com`, el puerto `5061` y el protocolo TLS. El punto de conexión requiere
   TLS o TCP (puerto `5060`) y rechaza UDP. AWS no documenta qué
   protocolos ofrece el conector, así que confirma con AWS que puede usar uno de
   ellos.
3. En tu flujo, agrega un bloque de **Transferir a número de teléfono** con **Transferir a**
   configurado como **Sistema de voz externo**, y establece:
   - **ARN de destino:** el conector.
   - **Al usuario:** la parte de usuario del `sip_uri` del punto de conexión, como
     `agent-12-jhxmginwjx`.
   - **UUI** (opcional): contexto para el agente. Connect lo envía codificado en hexadecimal.
   - **Reanudar flujo después de desconectar:** Sí, para que el flujo continúe cuando el
     agente cuelgue.

Connect envía el ID de contacto en `X-Amzn-ConnectContactId`. ThunderPhone lo almacena
como el `external_call_id` de la llamada, que es cómo tu flujo encuentra la llamada
más tarde. La UUI llega al prompt como `{{sip_uui}}`. Las integraciones de terceros
documentan el encabezado del ID de contacto; la documentación de AWS no, así que revísalo en
tu primera llamada de prueba.

## 3. Recupera la llamada

AWS no documenta ninguna forma de que Connect lea encabezados en el `BYE` ni de que acepte un
`REFER` del agente. Por lo tanto, el agente devuelve la llamada: se despide y cuelga, y tu flujo se reanuda después del bloque de transferencia. Agrega este número de transferencia (consulta [Agregar el número de transferencia](/es/guides/contact-centers/overview)):

```json
{"name": "Amazon Connect", "action": "return"}
```

Luego, obtén la transferencia con un bloque **Invocar función de AWS Lambda** después de la
transferencia. La Lambda busca la llamada por ID de contacto:

```python
import json
import os
import urllib.error
import urllib.parse
import urllib.request


def lambda_handler(event, context):
    contact_id = event["Details"]["ContactData"]["ContactId"]
    url = "https://api.thunderphone.com/v1/calls/handoff?" + urllib.parse.urlencode(
        {"external_call_id": contact_id}
    )
    request = urllib.request.Request(
        url, headers={"Authorization": "Bearer " + os.environ["THUNDERPHONE_API_KEY"]}
    )
    try:
        with urllib.request.urlopen(request, timeout=5) as response:
            call = json.load(response)
    except (urllib.error.URLError, TimeoutError):
        return {"found": "false"}
    handoff = call.get("handoff") or {}
    return {
        "found": "true",
        "intent": handoff.get("intent") or "",
        "summary": handoff.get("summary") or "",
    }
```

El bloque devuelve un mapa plano, por lo que el flujo puede bifurcarse según `intent` o establecer
`summary` como un atributo de contacto para la persona que toma la llamada. Ejecuta el
bloque de forma síncrona (hasta 8 segundos) y guarda la clave de API cifrada, por
ejemplo, en AWS Secrets Manager. Los campos de respuesta se encuentran en
[Buscar una llamada transferida](/api-reference/calls#look-up-a-handed-off-call).

## Pruébalo

Llama a un número de tu instancia de Connect que llegue al bloque de transferencia, pídele al
agente que te transfiera con una persona y verifica que el flujo se reanude. Luego abre la llamada con
`GET /v1/calls/{call_id}`: `sip_headers` debe incluir
`x-amzn-connectcontactid`, y `external_call_id` debe ser igual al `ContactId`
que recibe tu Lambda. Si la transferencia falla con SIP `404`, ThunderPhone no
encontró la parte de usuario del endpoint: debe estar tanto en la URI de la solicitud como en el
encabezado `To`.

## Límites

- AWS no documenta ninguna forma de leer encabezados en el `BYE`, incluido
  `X-TP-Handoff-Id`, por lo que el ID de contacto es el único vínculo de regreso a la llamada.
- AWS no documenta una longitud máxima de UUI para el conector.
- Un bloque de Lambda síncrono agota el tiempo de espera después de 8 segundos.
