Chat Agent Gateway

Deja de construir integraciones. Empieza a conversar.

Sois AI no expone endpoints. Expone un agente. Le dices en lenguaje natural lo que necesitas. El propio agente de Sois lee tu mensaje, negocia los detalles, actúa en todo tu espacio de trabajo y responde cuando termina.

Esta es la vía de acceso para quienes llaman sin una IA propia: webhooks, scripts, sistemas heredados y automatizaciones. Un solo endpoint, lenguaje natural, y el agente hace el razonamiento. Para quienes llaman sin agente, esto hace innecesaria una API REST tradicional con muchos endpoints. No hay esquemas que aprender, ni mapeos de campos que mantener, ni cambios incompatibles que perseguir. Solo una conversación entre tu sistema y el nuestro.

¿Ya tienes un agente de IA? Conéctalo directamente a través del servidor MCP. Esa es la vía estratégica: tu propio Claude, ChatGPT, Cursor o Gemini razona sobre las herramientas de Sois, así que Sois no gasta IA por ti. El Chat Agent Gateway es para quienes llaman sin aportar su propio agente.

Cómo funciona

You:    "Create a contact for Jane Doe, CEO of Acme Corp, [email protected]"
Agent:  Contact created. Added to workspace with company Acme Corp.

Un mensaje de entrada. Un resultado de salida. El agente de Sois negocia todo lo que hay en medio. Como el agente hace el razonamiento, esta vía consume créditos de IA de Sois.

Tres formas de recibir la respuesta

Método Ideal para
Webhook Define una response_url en tu clave. El agente entrega el resultado firmado cuando termina. Fire and forget.
Polling Consulta el estado de la conversación cuando quieras. Sencillo, sin infraestructura necesaria.
Ambos Webhooks como entrega principal, polling como respaldo. Doble seguridad.

Inicio rápido

1. Obtén tus credenciales desde Configuración en tu espacio de trabajo Sois AI

2. Envía un mensaje

curl -X POST "https://your-workspace.sois.ai/api/agent" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Api-Key: sois_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Find all contacts from London"}'

3. Recibe la respuesta a través de tu webhook o consultando la conversación

¿Qué puede hacer el agente?

Todo lo que un usuario puede hacer dentro de Sois AI:

  • Buscar, crear, actualizar y eliminar contactos
  • Gestionar tareas y asignaciones
  • Redactar y enviar correos electrónicos
  • Explorar y organizar archivos y documentos
  • Consultar departamentos, equipos y miembros
  • Trabajar con cualquier extensión instalada
  • Combinar varias acciones en una sola conversación

El agente no solo lee datos, actúa sobre ellos. Pídele que "le envíe a John el informe del primer trimestre" y encontrará el contacto, ubicará el documento, redactará el correo y lo enviará. Sin orquestación.

De sistema a sistema

Cuando ambas partes son inteligentes, negocian. Dos espacios de trabajo Sois AI, o cualquier sistema agéntico, pueden intercambiar datos a través del Chat Agent Gateway sin intervención humana. Sin mapeo de campos. Sin middleware. Sin conectores. Solo dos agentes que se entienden.

Tu ERP habla con tu CRM. Ellos lo resuelven. Tú recibes un resumen.

Gobernanza: qué puede hacer una integración

El gateway se rige por la misma gobernanza de herramientas que el asistente dentro de la aplicación. Cada acción que el agente podría realizar tiene uno de tres modos, y una clave de API nunca supera los permisos del usuario propietario.

  • Siempre. Las acciones seguras (lecturas, escrituras rutinarias) se ejecutan automáticamente.
  • Preguntar. Las acciones sensibles (enviar correo, eliminar registros, cualquier cosa que afecte al dinero o la identidad) necesitan la aprobación de una persona. Como el gateway es un canal de tipo «fire-and-forget» sin nadie mirando una pantalla, una acción «preguntar» no se ejecuta de forma predeterminada.
  • Denegar. Bloqueada en todas partes, incluido el gateway.

Para permitir que una integración realice una acción sensible concreta sin supervisión, autorice esa acción previamente en la clave (Configuración, Claves de API, aprobación automática). Es una decisión única y auditada que toma al emitir la clave, igual que conceder un ámbito a una aplicación. Una acción «preguntar» preautorizada se ejecuta entonces automáticamente para esa clave; todo lo no preautorizado se rechaza, y el agente le indica que necesita autorización en lugar de fingir que actuó.

Cada acción rechazada se le informa, tanto en la respuesta del agente como de forma legible por máquina en la carga del webhook bajo governance.tools_blocked (cada entrada lleva la acción y el motivo: deny o ask_unauthorised). Así su sistema ve exactamente qué se hizo y qué no.

Presupuesto, no límites de tasa. Cada clave tiene un presupuesto en dólares: diario, mensual o total. Tú decides cuánto vale cada integración. Sin cuotas de solicitudes arbitrarias. Cuando el presupuesto se agota, el agente te lo dice con claridad.

¿Listo? Lee la referencia completa de la interfaz Task para los formatos de solicitud y webhook, o trae tu propio agente a través del servidor MCP.