Bandeja de entrada (Email)

Objetivo

Gestionar emails entrantes y salientes con IA y aprobación humana (human-in-the-loop).

Acceso

Sidebar -> Inbox Rutas:

• /app/{tenant}/inbox (vista principal)
• /app/{tenant}/inbox/all (todas las cuentas)
• /app/{tenant}/inbox/{credentialId} (una cuenta)
• /app/{tenant}/inbox/message/{id} (detalle del email)

Roles

• owner, admin, agent

Requisitos previos

• Al menos un agent con canal Email habilitado.
• Una cuenta de Email conectada (Gmail u Outlook OAuth).
• Integrations con OpenAI o Google si el plan no incluye modelos.

Conectar una cuenta de email

En Inbox, pulsa Connect Email Account (o Email Accounts).

Opciones:

1. Gmail/Workspace (OAuth)
2. Outlook / Microsoft 365 (OAuth)

Gmail (OAuth)

Pasos:

1. En el panel de Email Accounts, elige Gmail.
2. Selecciona un agent en Assign agent.
3. Pulsa Connect Gmail (OAuth).
4. Completa el flujo de Google y vuelve al portal.

Outlook (OAuth)

Pasos:

1. En el panel de Email Accounts, elige Outlook.
2. Selecciona un agent en Assign agent.
3. Pulsa Connect Outlook (OAuth).
4. Completa el flujo de Microsoft y vuelve al portal.

Gestionar cuentas conectadas

En la lista de cuentas puedes:

• Verify: prueba conectividad.
• Test email: envía correo de prueba.
• Toggle Active/Inactive.
• Assign Agent.
• Delete.
• Edit (abre Email Configuration).

Email Configuration (por cuenta)

Ruta rápida: Inbox -> card de cuenta -> Edit

Account Configuration

Campos:

Variables de firma disponibles:

• {sender_name}
• {agent_name}
• {tenant_name}
• {account_email}
• {sender_role}

AI Response Settings

• Generate AI Responses: crea borradores.
• Send Automatically: envía sin aprobación.
• Agent Signature: firma del agent.
• Auto-Reply Language: idioma de respuestas auto.
• Require Manual Review For: High / Urgent.
• Auto-Reply Guard: reglas de bloqueo por tokens, dominios y headers.

Campos clave (Auto-Reply Guard):

Email Categorization

• Lista de categorías activas.
• Enable dynamic categories.
• Enable Other category.
• Sync categories to Gmail labels / Outlook categories.
• Archive on label sync (solo Gmail).

Daily Summary Email

Configura un resumen diario de actividad.

Campos:

Bandeja de entrada (lista de emails)

Funciones principales:

• Search: busca por remitente, asunto, agent, categoría.
• Account filter: filtra por cuenta.
• Direction: inbound / outbound.
• Status: pending, ready_for_review, approved, sent, reviewed, failed, quota_exceeded.
• Agent filter: all, unassigned, o un agent.
• Category filter: all, uncategorized, not_analyzed, o una categoría.
• Sort: Date o Category.
• Sync: (solo en vista de una cuenta) fuerza sincronización.

Detalle del email

Ruta: /app/{tenant}/inbox/message/{id}

Secciones principales:

1. Subject
2. Summary (Generate/Refresh summary)
3. AI-Generated Response (editable)
4. Original Message
5. Metadata (Received, Assigned agent, Send using, Signature)
6. Analysis (Intent, Sentiment, Category, Tags)

Acciones:

• Regenerate Response
• No Reply Needed
• Approve & Send
• Refresh summary / analysis
• Reassign agent
• Elegir cuenta de envío (Send using)
• Elegir firma (My / Agent / Account / None)

Notas importantes:

• Si Auto-reply blocked, el sistema desactiva IA y pide confirmación para enviar.
• Para enviar, el campo de respuesta no debe estar vacío.

Buenas prácticas

• Asigna un agent a cada cuenta antes de activar IA.
• Usa categorías claras para clasificación.
• Manten reglas de Auto-Reply Guard para evitar respuestas a no-reply.
• Usa firmas con variables para consistencia.

Errores comunes

• Reconnect required en Gmail: reconecta el OAuth desde la tarjeta.
• Verify falla: desconecta y reconecta el OAuth de la cuenta.
• AI response no aparece: revisa agent y proveedor LLM.