Documentación
Agentes de Email.md

Ficha del agente de email

La ficha del agente es la pantalla central de configuración. Desde aquí defines la identidad del agente, sus instrucciones de comportamiento, la firma de los correos y la casilla desde la que opera. Los cambios se guardan con el botón Guardar cambios al final de la página.

Cómo acceder

En el menú lateral ve a Agentes de Email, busca el agente en la grilla y haz clic en Ver ficha →.

Encabezado del agente

En la parte superior de la ficha verás el avatar, el nombre del agente y su estado (Activo / Pausado). Haciendo clic en el avatar puedes subir una foto de perfil.

Sección: Identidad

Define la información básica del agente.

Campo Descripción
📷 Foto del agente Haz clic en el avatar para subir una imagen (JPG, PNG, WEBP). Si no se sube ninguna, se muestra la inicial del nombre.
🏷️ Nombre del agente Nombre para identificarlo en el panel.
📤 Nombre del remitente (From name) El nombre que verán los destinatarios en su cliente de correo, por ejemplo: "Equipo de Ventas - Empresa".
🌐 Idioma Idioma principal en el que el agente redacta sus respuestas.
🎭 Tono Estilo de comunicación: Profesional, Cercano, Formal, Amigable o Directo.
✅ Agente activo Activa o pausa el agente. Un agente pausado no responde correos aunque los reciba.

Sección: Instrucciones

Define el comportamiento completo del agente: quién es, cómo responde, qué puede hacer y qué no, cómo cierra una conversación.

Ejemplos de lo que puedes definir:

  • Nombre del agente y empresa que representa.
  • Objetivo de cada conversación (calificar, resolver, seguir, cerrar).
  • Temas que puede responder y temas que debe escalar.
  • Cómo reaccionar si el contacto quiere hablar con una persona.
  • Cuántos intercambios hacer antes de cerrar el hilo.

💡 Las instrucciones son el system prompt del agente. Cuanto más específicas, mejores serán las respuestas.

Sección: Conocimiento

Base de información que el agente puede consultar para responder: preguntas frecuentes, precios, políticas, catálogos, etc.

A diferencia de las instrucciones (que definen el comportamiento), el conocimiento contiene información específica de tu empresa. El agente la interpreta para dar respuestas naturales, sin copiar el texto textualmente.

Sección: Firma

Texto o HTML que se agrega automáticamente al pie de cada correo que envía el agente.

  • Puedes escribir texto plano (se respeta el formato con saltos de línea).
  • También puedes escribir HTML para incluir formato, colores, logo o links.
  • Debajo del campo aparece una vista previa en tiempo real que renderiza el contenido mientras escribís.

Ejemplo de firma en HTML:

<p>Saludos,<br>
<strong>Equipo de Ventas</strong><br>
<a href="https://tuempresa.com">tuempresa.com</a> · +54 11 1234-5678</p>

Sección: Conexión de la casilla

Define desde qué cuenta de correo opera el agente. Hay dos métodos:

Gmail (recomendado)

Conecta una cuenta de Gmail con OAuth. El agente enviará y recibirá correos directamente desde esa cuenta, sin necesidad de contraseñas ni configuración técnica.

Ver Conectar Gmail para el paso a paso.

Estado de la conexión:

Estado Descripción
✅ Gmail conectado Muestra el correo conectado. El agente está listo para operar.
⚠️ Sin conexión El agente no puede enviar ni responder hasta que se conecte una cuenta.

Botones disponibles cuando está conectado:

  • Cambiar — conecta otra cuenta de Gmail en lugar de la actual.
  • Desconectar — revoca el acceso y limpia los tokens. El agente queda sin casilla.

SMTP / IMAP

Configura el acceso a cualquier servidor de correo con credenciales directas.

Campo Descripción
From email Dirección de correo desde la que se enviarán los mensajes.
IMAP Host / Puerto / Usuario / Contraseña / Encriptación Datos de acceso para leer el correo entrante.
SMTP Host / Puerto / Usuario / Contraseña / Encriptación Datos de acceso para enviar correo saliente.

💡 Si tu proveedor es Google Workspace o Gmail, usa la opción Gmail en lugar de SMTP/IMAP — es más confiable y no requiere contraseñas de aplicación.

Sección: Escalamiento

🔜 Próximamente

Cuando esté disponible, el agente detectará correos urgentes o con quejas y avisará a una persona en vez de responder solo. Esta función se activará junto con el motor de respuestas automáticas completo.

Guardar cambios

Haz clic en Guardar cambios en la parte inferior de la página para aplicar todos los cambios de la ficha. La página se recarga y muestra una confirmación verde si el guardado fue exitoso.

Esc