# Documentación de integración del Asixto Gateway

> Integración con los agentes de IA de Asixto, en dos etapas INDEPENDIENTES: (1) un servidor MCP que expone las operaciones de negocio de la empresa para que el agente las ejecute, y (2) la API del Gateway para iniciar conversaciones y recibir eventos. Se puede llamar a la API sin haber publicado ningún servidor: sin herramientas el agente conversa, pero no ejecuta nada en los sistemas de la empresa. Protocolo de la etapa 1: Model Context Protocol, revisión 2026-07-28 recomendada (transporte Streamable HTTP, sin estado); también se admite un servidor de la revisión anterior, que se registra con su era.

Cada enlace devuelve Markdown plano, sin HTML ni navegación. El orden de las páginas es el orden
recomendado de implementación. Si prefiere un solo archivo con todo el contenido, use
`llms-full.txt`.

## Documentación

- [Documentación de integración del Asixto Gateway](https://gateway.asixto.com/docs/README.md): Guía para equipos de ingeniería que van a conectar sus sistemas a los agentes de IA de Asixto (chat omnicanal y llamadas telefónicas).
- [01 · Quickstart](https://gateway.asixto.com/docs/01-quickstart.md): Esta página cubre solo la primera hora: una herramienta de lectura corriendo en local, para validar que el protocolo, el esquema y las pruebas funcionan antes de escribir la lógica de negocio.
- [02 · Contrato de herramientas](https://gateway.asixto.com/docs/02-tool-contract.md): Referencia de lo que el Gateway envía a cada herramienta y de lo que espera de vuelta.
- [03 · Autenticación](https://gateway.asixto.com/docs/03-authentication.md): Su servidor MCP es un endpoint expuesto a internet que puede leer y escribir en sus sistemas. La autorización es opcional en el estándar; en este contrato no lo es.
- [04 · Catálogo requerido](https://gateway.asixto.com/docs/04-capabilities.md): Qué herramientas debe exponer según lo que quiera que el agente resuelva.
- [05 · Garantías obligatorias](https://gateway.asixto.com/docs/05-guarantees.md): Seis garantías que hoy aporta la plataforma Asixto y que su sistema debe aportar en su lugar. No son buenas prácticas genéricas:
- [06 · Errores](https://gateway.asixto.com/docs/06-errors.md): Cómo debe fallar su herramienta para que el agente reaccione bien.
- [07 · Límites y rendimiento](https://gateway.asixto.com/docs/07-limits.md): Esta página fija los límites de tamaño, latencia y paginación que aplica el Gateway, y las reglas de forma del canal de voz.
- [08 · Certificación](https://gateway.asixto.com/docs/08-certification.md): Esta página lista las comprobaciones que su servidor debe pasar antes de entrar en producción y en qué orden ocurre cada fase. No revisamos su código:
- [09 · Versionado y cambios](https://gateway.asixto.com/docs/09-changelog.md): El contrato se ancla a 2026-07-28, pero eso no obliga a su servidor a hablarla: un servidor de la revisión anterior se certifica igual y se registra con su era.
- [10 · Operación y soporte](https://gateway.asixto.com/docs/10-operation.md): Esta página responde lo que aparece cuando el servidor ya está escrito: reintentos, concurrencia, qué pasa si su servidor se cae, cómo prueba con un agente real, dónde ve las trazas y a quién…
- [11 · Webhooks](https://gateway.asixto.com/docs/11-webhooks.md): Cómo recibe su sistema los eventos que Asixto le entrega: la forma del sobre, la verificación de la firma, la deduplicación y qué pasa cuando su receptor no responde.
- [12 · Precios](https://gateway.asixto.com/docs/12-pricing.md): Lo que consume cada operación de la API, en créditos. El turno del agente se factura con un solo código y un solo precio; el resto, cada uno por su propia unidad. Aquí están los dos.
- [13 · Datos, retención y subencargados](https://gateway.asixto.com/docs/13-data.md): Qué guarda Asixto de su tráfico, cuánto tiempo, quién más lo ve y qué no se hace con él. Todo con cifra:
- [14 · La API del Gateway: primeros pasos](https://gateway.asixto.com/docs/14-api-quickstart.md): Esta es la etapa 2: sus sistemas llaman a Asixto. La etapa 1 —su servidor de herramientas— es lo que cubren las páginas 01 a 10, y las dos son independientes:
- [15 · Referencia de las operaciones](https://gateway.asixto.com/docs/15-api-reference.md): Las ocho operaciones de /v1, con su permiso, su unidad de cobro y su contrato de entrada.
- [16 · Errores de la API](https://gateway.asixto.com/docs/16-api-errors.md): Este es el contrato de error de /v1. No es el mismo vocabulario que el de su servidor de herramientas:
- [17 · Trabajos, resultados y reintentos](https://gateway.asixto.com/docs/17-jobs.md): Toda petición a /v1 crea un trabajo, y su identificador viaja en el sobre como job_id. En las cinco operaciones síncronas eso es un detalle de contabilidad;
- [18 · Ritmo y cuotas](https://gateway.asixto.com/docs/18-api-limits.md): El Gateway acota su tráfico en tres planos distintos, y confundirlos lleva a dimensionar mal:
- [19 · El stream del turno](https://gateway.asixto.com/docs/19-api-stream.md): El turno del agente se lee mientras se genera, por GET /v1/agent/streams/{job_id}, como Server-Sent Events.

## Corpus completo

- [Documentación completa en un archivo](https://gateway.asixto.com/llms-full.txt): las 20 páginas concatenadas en Markdown, en orden.
