> For the complete documentation index, see [llms.txt](https://aizy.gitbook.io/aizy-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://aizy.gitbook.io/aizy-docs/aizy-docs-es/channels/mail.md).

# Mail

## 1. Descripción

El canal **Mail** permite que tu agente reciba correos, los convierta en conversaciones de Aizy y responda desde el mismo buzón. Las conversaciones también quedan disponibles en **Inbox** y **Chat Detail**.

Puedes conectar un único proveedor de correo por bot:

* **Microsoft Outlook** mediante autorización segura de Microsoft.
* **Buzón SMTP/IMAP** para cuentas de correo estándar compatibles.

## 2. Antes de empezar

Comprueba que:

* El canal Mail está disponible en la suscripción del environment.
* El buzón que vas a conectar puede recibir y enviar correos.
* Tienes permiso para autorizar la cuenta de Microsoft o conoces las credenciales IMAP/SMTP.
* El buzón no está configurado simultáneamente con los dos proveedores: al conectar uno se desconecta el otro.

Aizy procesa únicamente los correos nuevos recibidos después de conectar el buzón. No importa el historial anterior.

## 3. Elegir proveedor

En **Knowledge Admin > Canales**, selecciona **Mail** y elige una opción en **Proveedor de correo**:

| Proveedor             | Cuándo utilizarlo                                                                      |
| --------------------- | -------------------------------------------------------------------------------------- |
| **Microsoft Outlook** | Para buzones personales o corporativos administrados mediante Microsoft 365 u Outlook. |
| **Buzón SMTP**        | Para buzones estándar que permitan IMAP seguro y envío SMTP autenticado.               |

## 4. Configurar Microsoft Outlook

1. Selecciona **Microsoft Outlook**.
2. Pulsa **Conectar Correo Outlook**.
3. Elige la cuenta de Microsoft que utilizará el agente.
4. Autoriza los permisos solicitados para leer y enviar correo.
5. Comprueba que aparece el estado **Buzón conectado** con la dirección correcta.

Aizy solicita acceso de lectura y envío del buzón y mantiene la autorización para poder seguir procesando mensajes. No se importan correos anteriores.

Si la opción de conexión indica que Microsoft OAuth no está preparado, contacta con el administrador de la plataforma.

## 5. Configurar un buzón SMTP/IMAP

Selecciona **Buzón SMTP** y completa estos campos:

| Campo                           | Obligatorio | Configuración                                                                                   |
| ------------------------------- | ----------- | ----------------------------------------------------------------------------------------------- |
| **Nombre del remitente**        | Sí          | Nombre que verán los destinatarios, por ejemplo, el nombre comercial.                           |
| **Dirección del buzón**         | Sí          | Dirección completa desde la que se reciben y envían los correos.                                |
| **Reply-To**                    | No          | Dirección alternativa a la que deben responder los destinatarios.                               |
| **Host IMAP**                   | Sí          | Nombre DNS público del servidor de entrada. Aizy utiliza siempre el puerto **993 con SSL/TLS**. |
| **Usuario IMAP**                | Sí          | Usuario de acceso al buzón; normalmente es la dirección de correo completa.                     |
| **Host SMTP**                   | Sí          | Nombre DNS público del servidor de salida. Aizy utiliza siempre el puerto **587 con STARTTLS**. |
| **Usuario SMTP**                | Sí          | Usuario de autenticación del servidor de salida.                                                |
| **Contraseña común**            | Sí          | Contraseña utilizada para IMAP y, por defecto, también para SMTP.                               |
| **Contraseña SMTP alternativa** | No          | Rellénala únicamente cuando SMTP utilice una contraseña diferente.                              |

Los hosts deben ser nombres DNS públicos, no direcciones IP, y sus certificados TLS deben ser válidos. No se admiten certificados autofirmados.

### Probar y conectar

Pulsa **Probar y conectar**. Aizy realizará tres comprobaciones:

1. Autenticará el acceso IMAP.
2. Enviará un correo de prueba al propio buzón mediante SMTP.
3. Confirmará que el mensaje se ha recibido por IMAP.

La conexión solo se guarda si las tres comprobaciones terminan correctamente.

## 6. Escalado y respuestas automáticas

### Escalar directamente

Si activas **Escalar directamente**, el agente no responderá automáticamente. Cada conversación nueva se enviará directamente a los operadores en Inbox.

### Máximo de respuestas automáticas por hilo

Si desactivas el escalado directo, puedes definir entre **1 y 20** respuestas automáticas por hilo.

Cuando se alcanza el límite:

* El agente deja de responder automáticamente.
* El hilo se escala permanentemente al Inbox humano.
* Los operadores pueden continuar la conversación desde Inbox.

## 7. Cómo procesa Aizy los correos

* Cada hilo de correo se registra como una conversación.
* Las respuestas conservan el asunto y la relación con el hilo original.
* El agente utiliza su configuración, Knowledge, tareas y reglas de escalado habituales.
* Los correos automáticos, listas, mensajes masivos y avisos de rebote se ignoran para evitar bucles.
* Se procesa el texto del mensaje; los adjuntos no se importan.
* En mensajes HTML se extrae el contenido textual y no se cargan imágenes remotas.
* Si el agente no puede generar una respuesta válida, la conversación se escala.

## 8. Desconectar el buzón

Pulsa **Desconectar buzón** para detener la recepción y el envío desde ese proveedor.

La desconexión:

* Conserva el historial de conversaciones almacenado en Aizy.
* No elimina mensajes del buzón original.
* Permite conectar posteriormente otro proveedor o buzón.

## 9. Recomendaciones de seguridad

* Utiliza un buzón dedicado para el agente cuando sea posible.
* No compartas las credenciales por correo, chat o documentos.
* Mantén activado TLS y usa certificados válidos.
* Revisa periódicamente quién tiene acceso al buzón.
* Desconecta la integración si la cuenta deja de utilizarse o sus credenciales pueden estar comprometidas.
