# ruiv.ai

> ruiv.ai — plataforma de correo transaccional y marketing operable por humanos (UI), por agentes (MCP, OAuth) y por código (REST, API key). Esta es la documentación legible por IA: úsala para entender cada flujo y guiar/ejecutar por el usuario.

Regla de oro para agentes: Antes de enviar correos reales (send_email, send_broadcast, A/B con send=true) o de ejecutar acciones de infra/destructivas, CONFIRMA con el usuario. La autenticación del agente es OAuth: NO se necesita API key.

## Recursos
- Catálogo completo de flujos (texto): https://ruiv.ai/llms-full.txt
- Catálogo de flujos (JSON): https://ruiv.ai/api/flows
- API REST (OpenAPI 3.1): https://ruiv.ai/api/openapi
- Servidor MCP (Streamable HTTP, OAuth 2.1): https://ruiv.ai/api/mcp
- Discovery OAuth: https://ruiv.ai/.well-known/oauth-protected-resource
- Referencia interactiva: https://ruiv.ai/docs
- Estado del servicio: https://ruiv.ai/status

## Flujos (40) por área
### Conexión & identidad
- Conectar el agente (MCP / OAuth) — Quiero operar ruiv.ai desde mi agente o chat. [ui:ok mcp:ok rest:none]
- Conectar por API key (REST) — Quiero integrar el envío desde mi código. [ui:ok mcp:pending rest:ok]
- Saber quién soy / mis workspaces — ¿Qué cuenta y workspaces tengo? [ui:ok mcp:ok rest:none]
- Crear workspace — Quiero un nuevo espacio para esta marca o cliente. [ui:ok mcp:ok rest:none]

### Remitente & dominios
- Enviar desde el remitente del sistema — Quiero mandar ya, sin configurar DNS. [ui:ok mcp:ok rest:ok]
- Agregar y verificar un dominio propio — Quiero enviar desde @mimarca.com. [ui:ok mcp:ok rest:none]
- Subdominio de envío delegado (sin DNS del cliente) — No quiero tocar mi DNS; háganlo ustedes. [ui:pending mcp:ok rest:none]

### Plantillas & marca
- Crear plantilla (la IA escribe el HTML) — Diséñame un correo de bienvenida bonito y guárdalo. [ui:ok mcp:ok rest:none]
- Galería + Brand Kit (arranque rápido) — Dame una plantilla ya hecha con mi marca. [ui:ok mcp:ok rest:none]
- Ver / editar / borrar plantilla — Quiero gestionar mis plantillas. [ui:ok mcp:ok rest:none]
- Configurar Brand Kit — Usen mi logo y mis colores. [ui:ok mcp:ok rest:none]
- Previsualizar con merge tags (sin enviar) — ¿Cómo le llega al destinatario? [ui:ok mcp:ok rest:none]

### Envío transaccional
- Enviar un correo (1:1) — Manda este correo a ana@cliente.com. [ui:ok mcp:ok rest:ok]
- Personalización por contacto (merge tags) — Que diga el nombre de cada quien. [ui:ok mcp:ok rest:ok]
- Ver estado / seguimiento de un correo — ¿Llegó el correo? [ui:ok mcp:ok rest:ok]
- Idempotencia (REST) — No quiero duplicar envíos al reintentar. [ui:none mcp:none rest:ok]

### Audiencias & contactos
- Crear audiencia — Quiero una lista de contactos. [ui:ok mcp:ok rest:none]
- Agregar contacto — Añade a juan@x.com a la lista. [ui:ok mcp:ok rest:none]
- Importar en lote (CSV/Excel) — Sube esta lista de 2,000 contactos. [ui:ok mcp:ok rest:none]
- Etiquetas (tags) — Etiqueta a estos contactos como 'vip'. [ui:ok mcp:ok rest:none]
- Segmentos por reglas — Los que abrieron la campaña X y son plan pro. [ui:ok mcp:ok rest:none]
- Temas de suscripción — Quiero categorías a las que la gente se suscribe. [ui:ok mcp:ok rest:none]
- Leer contactos / segmentos / temas — Muéstrame mis contactos y segmentos. [ui:ok mcp:pending rest:none]

### Campañas (broadcasts)
- Crear y enviar un broadcast (normal) — Manda este newsletter a la audiencia. [ui:ok mcp:pending rest:none]
- Targeting (incluir/excluir) — Manda solo a los 'vip' menos los que se dieron de baja. [ui:ok mcp:ok rest:none]
- Prueba A/B — Prueba 2 asuntos y manda el ganador. [ui:ok mcp:ok rest:none]

### Automatizaciones (journeys)
- Crear automatización + pasos + activar — Cuando etiquete a alguien 'vip', mándale un correo tras 1 día. [ui:ok mcp:ok rest:none]
- Disparadores de inscripción — ¿Cómo decido a quién inscribir? [ui:ok mcp:ok rest:none]
- Pausar / listar / reportar — Pausa esta automatización y dime cómo va. [ui:ok mcp:ok rest:none]

### Onboarding agéntico
- Diagnóstico de readiness — ¿Qué me falta para salir en vivo? [ui:ok mcp:ok rest:none]
- Delegar tarea técnica por correo — No manejo DNS; que lo haga mi técnico. [ui:pending mcp:ok rest:none]
- Conectar/Configurar el Auth del cliente (Supabase) — Que los correos de auth de mi app salgan por ruiv.ai. [ui:none mcp:ok rest:none]

### Operación & observabilidad
- Logs de API — Quiero ver el log de una request. [ui:ok mcp:pending rest:none]
- Webhooks (eventos de entrega) — Quiero recibir eventos (delivered/bounce) en mi endpoint. [ui:ok mcp:pending rest:none]
- Inbound (recibir correo) — Quiero recibir correos entrantes. [ui:ok mcp:pending rest:none]
- Métricas — Dame el panel de envíos/aperturas/clics. [ui:ok mcp:pending rest:none]
- Plan, límites y facturación — ¿Cuál es mi plan y mi consumo? [ui:ok mcp:pending rest:none]
- Equipo / miembros — Quiero invitar a un compañero. [ui:ok mcp:pending rest:none]
- Actividad del agente (audit trail MCP) — ¿Qué ha hecho mi agente? [ui:ok mcp:none rest:none]

### Destinatario
- Baja / centro de preferencias — El destinatario quiere darse de baja. [ui:ok mcp:none rest:none]

Para el detalle de cada flujo (pasos, tools/endpoints, errores) usa /llms-full.txt o /api/flows.