> **Can't find what you're looking for?** Use `search_docs` on the docs MCP server at `https://naturgy-comer-documentation-p5mde.vercel.app/api/mcp` to find what you need.

# Interfaces y sistemas

Esta referencia resume la finalidad de cada integración sin copiar payloads,
credenciales ni endpoints internos. El contrato completo pertenece al sistema
owner y debe verificarse por entorno.

| Interfaz o sistema | Origen → destino | Finalidad | Datos mínimos |
|---|---|---|---|
| Omega | App ↔ Omega | Login, sesión, cliente, contratos, facturas y documentos | Token/sesión y contexto autorizado. |
| HappyRobot Chat | App → conversación | Crear o continuar chat y recibir respuestas | Sesión, mensaje y metadata de canal. |
| Connect / Chime | App ↔ voz | Iniciar audio y gestionar la llamada | Identidad técnica, IDs de llamada y atributos aprobados. |
| Cognito / HR Proxy | Workflow → servicios de identidad | OTP, ficha, tokens y citas | Documento o sesión ya autorizada, tokens y entorno. |
| Workflow Function | Dispatcher → especialista | Ejecutar un workflow hijo con respuesta estructurada | Canal, intención, confianza, resumen y correlación explícitos. |
| Mulesoft / Salesforce / Carolina | Workflow → casos | Crear, actualizar y cerrar CI/CG y encuestas | Caso, motivo, estado, resumen y campos contractuales. |
| [TeLeo](/use-cases/super-app/teleo) | Workflow texto → agente humano | Crear y continuar una sesión humana | Ticket, sesión, transcript/resumen minimizado y routing. |
| KB / Exa | Workflow → conocimiento | Consultar coberturas, distribuidora y diagnóstico | Pregunta, producto o marca/modelo. |
| AEM / NAPAI | App → contenido | Obtener contenido editorial y meteorología | Municipio, idioma y configuración editorial. |
| Firebase / GA4 / Crashlytics | App → observabilidad | Eventos, errores, flags y métricas | Evento minimizado y consentimiento aplicable. |
| OneTrust | App ↔ CMP | Gestionar consentimiento | Preferencias y estado de consentimiento. |
| EAS / Remote Config | Owner → app | Distribuir bundle, flags y kill switches | Versión, perfil y configuración aprobada. |
| Twin / Connect history | Workflow → observabilidad | Persistir ejecución, transcript o resultados según configuración | Correlación, resultado y metadata permitida. |

## Contrato mínimo por integración

Antes de considerar una interfaz lista para UAT, registra:

* sistema owner y responsable de la decisión;
* método, evento o tool que la utiliza;
* campos de entrada y salida, con clasificación de sensibilidad;
* identidad y permiso por entorno;
* timeout, reintentos e idempotencia;
* estado esperado, errores y fallback;
* correlación con sesión, run, caso y canal;
* retención, borrado y evidencia de auditoría.

La lista de interfaces describe la finalidad; no concede acceso. La presencia de
un token o una API key en una integración no demuestra que el usuario final
pueda ejecutar esa operación.

## Estado de contratos

El Dispatcher multicanal, el handoff de ATC texto, la asignación de agentes de
TeLeo, la habilitación Mulesoft de producción y el aislamiento por conversación
siguen siendo puntos de verificación. Las interfaces ya conectadas tampoco se
consideran listas para ampliación sin UAT y aprobación de sus owners.