ThunderPhone v3 ya está disponible.Empieza por tu cuenta desde 2¢/min.Lee el anuncio

Contact centers

Conéctate desde Amazon Connect

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 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) más el uso por minuto.

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:

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 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):

{"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:

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.

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.