Asixto Gateway
Documentación de integración del Asixto Gateway
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).
La integración tiene dos etapas independientes:
| Etapa | Dirección | Qué construye usted |
|---|---|---|
| 1. Servidor de herramientas | Asixto → sus sistemas | Un servidor MCP que expone sus operaciones de negocio |
| 2. API del Gateway | sus sistemas → Asixto | Llamadas a nuestra API para iniciar conversaciones y recibir eventos |
Esta documentación cubre la etapa 1. Se construyen en ese orden y la etapa 1 no depende de la etapa 2: puede desarrollar y probar su servidor de herramientas antes de tener credenciales de la API.
Dónde se da de alta su servidor. El registro de los tres datos —la URL de su servidor, la credencial y la URL de su entorno de pruebas— se hace en la aplicación de Asixto, con su usuario autenticado, y esa pantalla llega con la etapa 2. Mientras tanto la incorporación es asistida: usted entrega esos datos a su contacto técnico de Asixto y nosotros los registramos. No hay nada que usted deba construir para eso y no bloquea nada de la etapa 1: puede desarrollar, probar y certificar su servidor antes de que la pantalla exista. Cuando exista, su alta ya estará hecha y pasará a poder editarla usted mismo.
Qué es la etapa 1
En una frase: un servidor que el agente puede leer y escribir. Consulta empresa, catálogo, clientes, casos, agenda y embudo, y también abre casos, actualiza datos, agenda, reagenda, cancela y mueve oportunidades. De las 25 herramientas del catálogo de referencia, 13 son de lectura y 12 mutan su sistema.
Sus sistemas siguen siendo suyos. Usted publica un servidor MCP (Model Context Protocol, estándar abierto) y entrega a Asixto dos datos: la URL y una credencial. A partir de ahí, el agente descubre su catálogo de herramientas y las ejecuta durante la conversación.
Lo que no hay que hacer: declarar endpoints uno por uno, mandarnos un OpenAPI para que lo revisemos, o esperar una liberación nuestra cuando usted agregue una herramienta.
┌──────────────────────┐ ┌─────────────────┐ ┌──────────────────┐
│ Su servidor MCP │ MCP │ Asixto Gateway │ │ Agente de IA │
│ (sus tools sobre su │◄──────►│ descubre, │◄──────►│ chat y llamadas │
│ backend / ERP / BD) │ HTTPS │ valida, ejecuta │ │ telefónicas │
└──────────────────────┘ └─────────────────┘ └──────────────────┘
usted Asixto AsixtoÍndice
| # | Página | Contenido |
|---|---|---|
| 01 | Quickstart | La primera hora: servidor mínimo funcionando y probado en local |
| 02 | Contrato de herramientas | Referencia: entrada, salida, anotaciones, nombres |
| 03 | Autenticación | OAuth 2.1, metadatos de recurso protegido, token rotable |
| 04 | Catálogo requerido | Qué exponer según lo que quiera que el agente resuelva |
| 05 | Garantías obligatorias | Idempotencia, propiedad, estado terminal, dato crítico |
| 06 | Errores | Forma del error y códigos que interpreta el agente |
| 07 | Límites y rendimiento | Latencia, tamaños, paginación, cuotas |
| 08 | Certificación | Comprobaciones automáticas antes de producción |
| 09 | Versionado | Revisión del protocolo y política de cambios |
| 10 | Operación y soporte | Reintentos, concurrencia, caídas, pruebas con agente real, trazas y contacto |
Requisitos previos
- Un servidor HTTPS alcanzable desde internet, con certificado válido.
- Un entorno de pruebas separado de producción (la certificación escribe en él).
- Revisión del protocolo: 2026-07-28. Los SDK oficiales de TypeScript, Python, Go y C# la implementan en su línea v2.
Convenciones de esta documentación
- DEBE: requisito. Su ausencia bloquea la certificación.
- DEBERÍA: recomendado. Genera aviso, no bloquea.
- PUEDE: opcional.
Los nombres de herramienta de los ejemplos son ilustrativos: usted nombra las suyas. Lo que está fijado es la forma, no los identificadores.
Para agentes de IA
Si va a implementar esto con un asistente de programación, no le pase la página HTML: pásele uno de estos enlaces. Devuelven Markdown plano, sin navegación ni maquetado.
/llms-full.txtToda la documentación en un archivo Markdown. Es el enlace que conviene pasarle a un agente./llms.txtÍndice compacto con un enlace por página, en el orden de implementación./docs/01-quickstart.mdCualquier página en Markdown plano: la misma ruta con sufijo .md.