Sallyport
MenúCerrar
Ir a la documentación
DocumentaciónCorreo

Correo

Deja que un agente envíe desde tu buzón, lo busque y lo lea, y ordene su correo, mientras Sallyport guarda la contraseña.

En esta página

Tu agente escribe el mensaje y Sallyport lo envía desde tu propio buzón. Busca en tu bandeja de entrada, lee mensajes y adjuntos, mueve y marca el correo. La contraseña se queda en Sallyport y el agente nunca la ve.

Conecta un buzón

  • Abre Conectar un buzón. Desde Claves es «Añadir una clave» y luego «Correo electrónico» en «Origen de la clave».
  • Elige el «Proveedor de correo»: Gmail / Google Workspace, Outlook / Microsoft 365, Yahoo Mail, iCloud Mail, Fastmail, Zoho Mail o «Tu propio servidor de correo». Los servidores, los puertos y el cifrado se rellenan solos y se pueden editar.
  • Escribe la «Dirección de correo» y la «Contraseña del buzón». La mayoría de los proveedores piden aquí una contraseña de aplicación, y el formulario enlaza con la página que la emite.
  • Pulsa «Probar conexión». Sallyport inicia sesión en cada servidor y nombra el que se negó.
  • Pulsa «Guardar buzón». La contraseña queda sellada y no se puede leer de vuelta. Todos los agentes del espacio de trabajo reciben el buzón.
ProveedorContraseña que usar
Gmail / Google WorkspaceUna contraseña de aplicación. Google la emite cuando la verificación en dos pasos está activada.
Outlook / Microsoft 365La contraseña del buzón. Tu administrador de Microsoft 365 activa SMTP AUTH y el inicio de sesión IMAP con contraseña para el buzón.
Yahoo MailUna contraseña de aplicación de Seguridad de la cuenta.
iCloud MailUna contraseña específica de app de tu cuenta de Apple.
FastmailUna contraseña de aplicación con acceso IMAP y SMTP.
Zoho MailUna contraseña específica de app. Los buzones de organización usan smtppro.zoho.com e imappro.zoho.com.

Un buzón envía por su servidor SMTP y se lee por su servidor IMAP. Apaga uno en «Envío (SMTP)» o «Lectura (IMAP)» y sus herramientas se van con él.

Iniciar sesión con Google o Microsoft

Los buzones de Gmail y Microsoft 365 inician sesión con el proveedor en lugar de una contraseña. En «Cómo inicia sesión Sallyport», elige «Iniciar sesión con Google» o «Iniciar sesión con Microsoft» y pulsa «Guardar e iniciar sesión con Google» o «Guardar e iniciar sesión con Microsoft». El proveedor te pide permitir el acceso y te devuelve a la página de la clave.

  • Sallyport guarda el token en la bóveda y lo renueva solo, como cualquier clave con inicio de sesión. No se guarda ninguna contraseña.
  • Google inicia sesión con la aplicación propia de Sallyport. En Microsoft registras una aplicación tuya: el formulario da la «URI de redirección» que debes añadir y recibe su «Client ID» y su «Client secret». La aplicación necesita IMAP.AccessAsUser.All, SMTP.Send y offline_access.
  • El token va solo a los servidores de correo del propio proveedor: smtp.gmail.com e imap.gmail.com, o smtp.office365.com, outlook.office365.com y smtp-mail.outlook.com.

Qué puede hacer el agente

El agente conserva su conexión MCP con Sallyport. Un buzón le da tres herramientas, con el nombre de la conexión:

HerramientaQué haceClase
_readlist_folders; search en una carpeta; fetch de un mensaje por su uid; un attachment por su part. Leer no marca nada como visto.Lectura
_sendEnvía un mensaje desde el buzón: to, cc, bcc, subject, text, html, reply_to, in_reply_to, references y attachments.Escritura
_changemove y copy a to_folder; flag y unflag con flags; delete; create_folder.Escritura. delete y marcar deleted son destructivos.
Argumentos de _read · el correo sin leer de facturación
{
  "operation": "search",
  "from": "[email protected]",
  "unseen": true
}
Argumentos de _send · una respuesta con un archivo
{
  "to": "Ana Lima <[email protected]>",
  "bcc": "[email protected]",
  "subject": "Re: Invoice 42",
  "text": "Paid today. The receipt is attached.",
  "in_reply_to": "<[email protected]>",
  "attachments": [{ "filename": "receipt.csv", "content_type": "text/csv", "content_base64": "YW1vdW50LGR1ZQo0MjAwLEZyaWRheQo=" }],
  "intent": "Confirm the payment of invoice 42"
}
Argumentos de _change · archivar la factura pagada
{
  "operation": "move",
  "uids": [4102],
  "to_folder": "Archive",
  "intent": "File the paid invoice"
}
  • search devuelve el total y los mensajes más nuevos, 20 por defecto y 100 como máximo, cada uno con su uid, remitente, asunto, fecha y marcas.
  • fetch devuelve los encabezados, el texto, el HTML y la lista de adjuntos con su part.
  • Un mensaje sale siempre del propio buzón. La copia oculta llega a sus destinatarios y nunca entra en el mensaje.
  • Un cambio solo toca los mensajes que nombra. Un uid que la carpeta no tiene vuelve como missing.

Elige qué te espera

El correo funciona sin preguntar por defecto. Para ver cada mensaje antes de que salga, abre el agente en Agentes, busca el buzón en su lista «Acceso» y pon la columna de escritura en «Requiere aprobación», o activa «Preguntar en cada llamada».

La tarjeta de aprobación muestra cada destinatario, copia oculta incluida, el asunto, el texto y cada archivo por nombre y tamaño. Sale exactamente el mensaje de la tarjeta.

Límites y seguridad

  • Un mensaje lleva hasta 100 destinatarios, 20 adjuntos y 10 MiB en total.
  • Un mensaje se lee hasta 80 MiB, su texto y su HTML hasta 2 MiB cada uno. Una respuesta más larga se guarda y la lee fetch_body.
  • Una operación dura hasta 120 segundos.
  • Siempre TLS con certificado comprobado: SMTP en 465 o 587, IMAP en 993 o 143. El puerto 25 se rechaza.
  • El registro guarda los destinatarios, el asunto y los nombres de archivo de cada mensaje. El texto queda fuera.