IMAP Move

Tipo: imap-move · Paquete: SMTP / IMAP Email Activities v1.0.5

Mueve un correo de una carpeta IMAP a otra. La forma de organizar la bandeja tras procesar: llevar lo atendido a una carpeta “Procesados”, archivar, o clasificar por tipo.

Cómo funciona

A partir del mailId (de IMAP Read), mueve el correo desde su carpeta de origen (folder, por defecto INBOX) a targetFolder.

La carpeta destino debe existir en el servidor: la actividad no la crea. INBOX se acepta sin distinguir mayúsculas; las demás, con el nombre y separador que usa el servidor ("Procesados", "INBOX/Procesados" o "INBOX.Procesados").
En la carpeta destino el correo recibe un UID nuevo: el .Id anterior ya no sirve. Haz las demás acciones (adjuntos, marcar) antes de moverlo.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`host`	`string`	—	Servidor IMAP.
`username`	`string`	—	Usuario.
`password`	`credential`	—	Contraseña o App Password. Usa `credential("nombre")["password"]`.
`mailId`	`string`	—	UID del correo (de `correo.Id`). Debe ser numérico.
`targetFolder`	`string`	—	Carpeta destino (ej. `"Procesados"`, `"Archive"`).

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
`port`	`int`	`993`	Puerto IMAP.
`folder`	`string`	`"INBOX"`	Carpeta de origen (la misma con la que se leyó el correo).
`security`	`string`	`"ssl"`	Cifrado: `auto`, `none`, `ssl` o `starttls`.

Salida

Esta actividad no devuelve ningún valor.

Errores comunes

Mensaje	Causa y solución
`'mailId' no es válido. Debe ser el UID numérico que devuelve imap-read.`	`mailId` no es un número. Pasa `correo.Id` de IMAP Read.
`'mailId' es obligatorio.` / `'targetFolder' es obligatorio.`	Falta el parámetro o la expresión dio `null`.
Error de carpeta no encontrada	`folder` o `targetFolder` no existe en el servidor. Créala desde tu cliente de correo o corrige el nombre.
Error de autenticación o de conexión	Igual que en IMAP Read.

Ejemplo

For Each   items = correos   itemVariable = correo
 └─ activities:
      ... procesar ...
      IMAP Move   host = "imap.gmail.com"   username = credential("correo-bot")["user"]   password = credential("correo-bot")["password"]
                  mailId = correo.Id   targetFolder = "Procesados"

Actividades relacionadas

IMAP Mark Read — marcar como leído.
IMAP Delete — eliminar en vez de archivar.