ArgorantDocs

Conectar cualquier buzón (SMTP e IMAP)

Conecta buzones de Zoho, Fastmail, Yahoo, iCloud, IONOS, tu proveedor de hosting o cualquier otro proveedor con su configuración de servidor. Prueba antes el inicio de sesión y conéctalos de uno en uno o muchos desde un archivo CSV.

Los buzones de Google y Microsoft se conectan con su propio inicio de sesión (consulta Conectar un Google Workspace, y Microsoft 365 en la app, en Buzones). Cualquier otro proveedor se conecta con dos conjuntos de configuración de servidor. El servidor de envío (SMTP) permite que las campañas envíen desde el buzón. El servidor para leer las respuestas (IMAP) trae las respuestas a tu bandeja de entrada en Argorant, de modo que una respuesta detiene la secuencia para esa persona.

Argorant inicia sesión en los dos antes de guardar nada. Un buzón solo se conecta cuando funcionan tanto el envío como la lectura de respuestas. La contraseña se guarda cifrada y no se vuelve a mostrar nunca, ni en la app, ni en la API, ni en la CLI, ni en el conector.

En la app

Abre Buzones, haz clic en Add accounts, después en Conectar existente y en Cualquier otro proveedor.

  1. Elige tu proveedor en la lista. Rellena por ti los nombres de servidor, los puertos y la seguridad. Elige Otro proveedor si el tuyo no aparece y copia la configuración de las páginas de ayuda de tu proveedor.
  2. Introduce la dirección de correo, el nombre de remitente que ve la gente y la contraseña.
  3. Haz clic en Probar conexión. Ves una línea para el envío y otra para la lectura de respuestas, cada una con lo que ha funcionado o lo que hay que corregir.
  4. Haz clic en Conectar buzón. Aparece en la lista al momento, con su límite diario y su estado de salud.

Para conectar muchos buzones a la vez, cambia a Varios desde un archivo CSV, sube el archivo y revisa el resultado de cada fila.

Contraseñas de aplicación

Muchos proveedores no aceptan tu contraseña normal desde otras apps cuando tienes activada la verificación en dos pasos. Crea una contraseña de aplicación en el proveedor y úsala en su lugar.

ProveedorDónde crear una contraseña de aplicación
Zoho MailMy Account, Security, App Passwords. Activa también el acceso IMAP en la configuración de Zoho Mail.
FastmailSettings, Privacy and Security, Manage app passwords. Siempre es necesaria.
Yahoo MailAccount Info, Account Security, Generate app password. Siempre es necesaria.
iCloud Mailaccount.apple.com, Sign-In and Security, App-Specific Passwords. Siempre es necesaria. El nombre de usuario es tu dirección completa de iCloud.
Outlook.com y HotmailMicrosoft suele rechazar las contraseñas de otras apps en estas cuentas. Prueba con una contraseña de aplicación; si la prueba dice que la contraseña es incorrecta, conecta con el inicio de sesión de Microsoft.

Configuración por proveedor

Elige un proveedor y estos datos se rellenan solos. La lista de la app y GET /api/v1/inboxes/smtp/presets siempre es la actual.

PresetProveedorServidor de envíoServidor para leer las respuestas
zohoZoho Mail (dominio de empresa)smtppro.zoho.com, 587, STARTTLSimappro.zoho.com, 993, SSL
zoho_euZoho Mail (centro de datos de la UE)smtppro.zoho.eu, 587, STARTTLSimappro.zoho.eu, 993, SSL
zoho_personalZoho Mail (plan personal o gratuito)smtp.zoho.com, 587, STARTTLSimap.zoho.com, 993, SSL
fastmailFastmailsmtp.fastmail.com, 587, STARTTLSimap.fastmail.com, 993, SSL
godaddyGoDaddy Professional Emailsmtpout.secureserver.net, 587, STARTTLSimap.secureserver.net, 993, SSL
titanTitan Emailsmtp.titan.email, 587, STARTTLSimap.titan.email, 993, SSL
hostingerHostinger Emailsmtp.hostinger.com, 587, STARTTLSimap.hostinger.com, 993, SSL
ionosIONOS (EE. UU.)smtp.ionos.com, 587, STARTTLSimap.ionos.com, 993, SSL
ionos_deIONOS (Alemania)smtp.ionos.de, 587, STARTTLSimap.ionos.de, 993, SSL
ionos_ukIONOS (Reino Unido)smtp.ionos.co.uk, 587, STARTTLSimap.ionos.co.uk, 993, SSL
namecheapNamecheap Private Emailmail.privateemail.com, 587, STARTTLSmail.privateemail.com, 993, SSL
yahooYahoo Mailsmtp.mail.yahoo.com, 587, STARTTLSimap.mail.yahoo.com, 993, SSL
icloudiCloud Mailsmtp.mail.me.com, 587, STARTTLSimap.mail.me.com, 993, SSL
outlookOutlook.com o Hotmailsmtp-mail.outlook.com, 587, STARTTLSoutlook.office365.com, 993, SSL
otherOtro proveedorlo introduces túlo introduces tú

Usa el puerto 587 para enviar. Si introduces 465, Argorant prueba 587 por ti y guarda 587 si funciona, y el resultado de la prueba muestra entonces el puerto 587 y STARTTLS para el envío. El nombre de usuario de los dos servidores es la dirección de correo, salvo que indiques otro. La lectura de respuestas usa el mismo usuario y contraseña que el envío, salvo que indiques otros. Sin preset, la seguridad depende del puerto: STARTTLS en 587 y 143, y SSL en 993.

Qué significa el resultado de la prueba

ResultadoQué significaQué hacer
signed_inEl servidor aceptó el inicio de sesión.Nada.
wrong_passwordEl servidor rechazó el usuario o la contraseña.Revisa los dos. Usa una contraseña de aplicación si el proveedor la pide y comprueba que el acceso IMAP está activado en el proveedor.
not_reachableEl servidor no respondió, o no existe ningún servidor con ese nombre.Revisa el nombre del servidor y el puerto.
security_mismatchLa conexión segura no funcionó.Prueba la otra opción de seguridad. Para el envío, usa el puerto 587 con STARTTLS.
not_allowedEl nombre del servidor apunta a una red privada.Usa el nombre de servidor público de tu proveedor.
failedHa fallado otra cosa.Revisa la configuración y vuelve a intentarlo, o contacta con soporte.

Muchos buzones desde un archivo CSV

Una fila por buzón. Cada fila necesita email, smtp_password (o password) y un preset o bien smtp_host, smtp_port e imap_host. Las columnas vacías toman los valores por defecto de arriba, y 25 correos al día.

ColumnaEjemplo
emailanna@yourcompany.com
sender_nameAnna Weber
presetzoho
smtp_host, smtp_port, smtp_securitymail.yourcompany.com, 587, starttls
smtp_username, smtp_passwordanna@yourcompany.com, tu contraseña de aplicación
imap_host, imap_port, imap_securitymail.yourcompany.com, 993, ssl
imap_username, imap_passwordsolo si son distintos de los de envío
daily_limit30
CSV
email,sender_name,preset,smtp_password
anna@yourcompany.com,Anna Weber,zoho,app-password-1
ben@yourcompany.com,Ben Hill,zoho,app-password-2
cara@othercompany.com,Cara Lane,,app-password-3

La tercera fila no tiene preset, así que también necesita smtp_host, smtp_port e imap_host rellenados; si no, vuelve como fila que hay que corregir. Cada fila recibe su propio resultado. Las filas que se conectaron siguen conectadas aunque otras fallen, así que corrige las filas que fallaron y sube solo esas de nuevo.

Vuelve a conectar tras un cambio de contraseña

Cuando el proveedor rechaza la contraseña, el buzón muestra Sign in again en la lista de Buzones. Si la lectura de respuestas se rechaza tres veces seguidas, el buzón se marca como desconectado y sigue así hasta que lo vuelvas a conectar.

Para reconectarlo, conecta la misma dirección otra vez con la contraseña nueva. En la app, haz clic en Reconectar en el buzón, introduce la contraseña nueva y conéctalo; el resto de la configuración se mantiene. Con la API, la CLI o tu asistente de IA, conecta la misma dirección otra vez y se sustituyen la configuración y la contraseña guardadas de ese buzón.

Desde la API

Shell
# Test first: nothing is saved
curl -X POST "https://app.argorant.com/api/v1/inboxes/smtp/test" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"email":"anna@yourcompany.com","preset":"zoho","smtp_password":"app-password"}'

# Connect one mailbox
curl -X POST "https://app.argorant.com/api/v1/inboxes/smtp" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"email":"anna@yourcompany.com","display_name":"Anna Weber","preset":"zoho","smtp_password":"app-password"}'

# Connect up to 25 at once
curl -X POST "https://app.argorant.com/api/v1/inboxes/smtp/bulk" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"mailboxes":[{"email":"anna@yourcompany.com","preset":"zoho","smtp_password":"app-password-1"},{"email":"ben@yourcompany.com","preset":"zoho","smtp_password":"app-password-2"}]}'

Un inicio de sesión rechazado al conectar responde 422 con el código sign_in_failed y el resultado de la prueba en error.details.test. La ruta masiva responde 200 con un resultado por fila. Una prueba gratuita conecta hasta 2 buzones. Puedes hacer 30 pruebas y 30 conexiones por hora, y conectar hasta 500 buzones por hora con la ruta masiva.

Desde la terminal

Shell
argorant inboxes presets
argorant inboxes test-smtp --email anna@yourcompany.com --preset zoho
argorant inboxes connect-smtp --email anna@yourcompany.com --preset zoho --name "Anna Weber"
argorant inboxes connect-smtp --csv mailboxes.csv

La CLI nunca recibe la contraseña en la línea de comandos. Te la pide, o la lee de una variable de entorno que indicas con --password-env NAME, o de ARGORANT_MAILBOX_PASSWORD. Consulta CLI.

Desde tu asistente de IA

Con el conector de Argorant, pídelo con tus propias palabras, por ejemplo “conecta anna@yourcompany.com, es un buzón de Zoho”. El asistente usa argorant_test_smtp_mailbox para comprobar el inicio de sesión y argorant_connect_smtp_mailbox para conectar un buzón o hasta 25. Consulta Herramientas.

Después de conectar

El buzón envía como cualquier otro. Fija su límite diario y su calentamiento en Buzones o con PATCH /api/v1/inboxes/{email}, y elígelo como remitente en cualquier campaña. Los seguimientos salen en el mismo hilo, las respuestas llegan a tu bandeja de entrada en Argorant y las contestas desde allí en el mismo hilo. Las respuestas que caen en la carpeta de correo no deseado o spam también se leen, pero solo las de personas a las que escribiste, así que el spam se ignora.

En esta página