API IMAP: Guía del desarrollador

Índice
Visión general
1
Introducción a la API de IMAP
2
¿Por qué utilizar una API IMAP?
3
API IMAP de Unipile
Características
4
Cómo IMAP mejora el correo electrónico
5
Autenticación y Seguridad
6
Características de la API IMAP
Integración
7
Configuración paso a paso
8
Unipile frente a Auto-Integración
PREGUNTAS FRECUENTES
9
PREGUNTAS FRECUENTES
Índice
Visión general
1
Introducción a la API de IMAP
2
¿Por qué utilizar una API IMAP?
3
API IMAP de Unipile
Características
4
Cómo IMAP mejora el correo electrónico
5
Autenticación y Seguridad
6
Características de la API IMAP
Integración
7
Configuración paso a paso
8
Unipile frente a Auto-Integración
PREGUNTAS FRECUENTES
9
PREGUNTAS FRECUENTES
Visión general

Introducción a las soluciones API de IMAP

¿Qué es IMAP y el protocolo IMAP?

IMAP (Protocolo de Acceso a Mensajes de Internet) es un protocolo de correo electrónico que permite a los usuarios acceder a los correos electrónicos de un servidor de correo sin descargarlos. Comprender cómo funciona una API IMAP es clave para crear integraciones de correo electrónico robustas. Con la API IMAP de Unipile, los desarrolladores pueden mejorar el manejo del correo electrónico, garantizando una sincronización en tiempo real entre la aplicación y las cuentas de correo electrónico del usuario de manera eficiente.

Simplificar IMAP con Unipile

IMAP no proporciona una API basada en HTTP, lo que obliga a los desarrolladores a trabajar directamente con sus comandos de protocolo y complejidades. La API IMAP de Unipile transforma este complejo protocolo en una API accesible basada en HTTP, completa con soporte de webhooks y contenido de valor añadido. Al utilizar Unipile, los desarrolladores pueden evitar las dificultades de implementar conexiones IMAP en bruto, garantizando al mismo tiempo una sincronización eficiente y en tiempo real entre la aplicación y las cuentas de correo electrónico del usuario.

Proveedores y funciones IMAP compatibles

La API IMAP de Unipile admite una amplia gama de proveedores de correo electrónico, lo que garantiza flexibilidad y compatibilidad para diversos casos de uso. Algunos de los proveedores admitidos incluyen:

FastMail
Zoho Mail
Correo de GoDaddy
Yandex.Mail
AOL Mail
Bluehost
Mail.com
EarthLink
Hover.com
GMX
IONOS

Estos son sólo algunos de los proveedores IMAP que pueden integrarse con Unipile, ofreciendo flexibilidad y una sólida funcionalidad para diversas plataformas de correo electrónico.

Guía completa de la API de correo electrónico
Aprende cómo Gmail, Outlook e IMAP trabajan juntos bajo una única API REST unificada.
Lee la guía

¿Qué es una API de IMAP?

En API IMAP es una interfaz REST que abstrae la complejidad del protocolo IMAP, permitiendo a los desarrolladores interactuar con servidores de correo electrónico utilizando sencillas solicitudes HTTP en lugar de comandos IMAP sin procesar. Maneja la gestión de conexiones, la autenticación y el análisis de datos, exponiendo operaciones de correo electrónico como la recuperación de mensajes, la gestión de carpetas y el envío de correos electrónicos a través de puntos finales de API estándar.

Deprecación de la autenticación básica de Microsoft (2026): Microsoft está eliminando la autenticación básica para IMAP y SMTP. Las aplicaciones que usan IMAP sin procesar con credenciales de nombre de usuario/contraseña dejarán de funcionar. Unipile se encarga de OAuth2 automáticamente tanto para Microsoft 365 como para Gmail, por lo que tu integración sigue funcionando sin cambios en el código. Aprende más sobre autenticación segura.

API IMAP vs Protocolo IMAP Directo

CriteriosIMAP directoIMAP API (Unipile)
Conocimiento del protocoloRequerido (RFC 3501)No es necesario
Gestión de conexionesManual (sockets, IDLE, reconectar)Manejado automáticamente
AutenticaciónCredenciales de acceso directas o OAuth2 personalizadoAutenticación alojada (OAuth2 + IMAP)
Actualizaciones en tiempo realIMAP IDLE (complejo)Webhooks (HTTP POST)
Soporte multi-proveedorCódigo personalizado por proveedorUna API para todos los proveedores
Hora de integrarseDe semanas a mesesHoras a días
MantenimientoEn curso (cambios de proveedor, actualizaciones de autenticación)Zero (gestionado por Unipile)
¿Por qué la API de IMAP?

¿Por qué utilizar una API IMAP?

Una API IMAP simplifica el manejo de correos electrónicos al brindar a los desarrolladores la capacidad de acceder y administrar correos electrónicos entrantes de manera programática. Permite la sincronización perfecta de mensajes a través de múltiples plataformas y aplicaciones de usuario, asegurando que los usuarios siempre tengan acceso a los últimos correos electrónicos. Además, reduce la complejidad de administrar protocolos de correo electrónico, lo que facilita la creación de aplicaciones robustas integradas con el correo electrónico.

Sincronización en tiempo real
Mantén los correos electrónicos sincronizados en todos los dispositivos y plataformas en tiempo real, sin necesidad de actualizaciones manuales ni retrasos en la consulta.
Acceso programático al correo electrónico
Acceda y administre correos electrónicos entrantes mediante programación a través de una interfaz HTTP limpia en lugar de comandos directos del protocolo IMAP.
Integración más rápida
Integra funcionalidad de correo electrónico IMAP en tu aplicación en tan solo dos días, evitando la complejidad de la implementación del protocolo en bruto.
Soporte multi-proveedor
Conecta cualquier proveedor de correo electrónico compatible con IMAP, desde FastMail hasta Zoho Mail y servidores de correo corporativos personalizados.
Soporte de Webhook
Reciba notificaciones en tiempo real para correos electrónicos nuevos y eventos de la bandeja de entrada a través de webhooks, lo que permite flujos de trabajo reactivos impulsados por correo electrónico.
Seguro por defecto
La autenticación integrada alojada con cifrado de extremo a extremo significa que las credenciales nunca se almacenan directamente en su aplicación.
API IMAP Unipile

API IMAP de Unipile: Una Integración Robusta de Correo Electrónico

Resumen de la API de correo electrónico de Unipile

Unipile ofrece una potente API IMAP que integra fácilmente las funciones de correo electrónico en las aplicaciones. Proporciona sincronización de correo electrónico en tiempo real, obtención eficiente de correo y mecanismos de autenticación seguros.

IMAP es uno de los tres protocolos de correo electrónico compatibles con integración unificada de API de correo electrónico, junto con la API de Gmail y la API de Microsoft Graph.

Logo de GmailAPI de Gmail
Logotipo de OutlookAPI Graph de Microsoft
Logo de IMAPAPI IMAP

Beneficios clave de usar la API IMAP de Unipile

Autenticación alojada con credenciales
Proporciona mecanismos de inicio de sesión seguros al permitir a los usuarios autenticarse utilizando sus credenciales sin almacenarlas directamente en la aplicación.
Sincronización de correo electrónico sin interrupciones
Sincronización en tiempo real entre múltiples dispositivos, asegurando que los usuarios siempre tengan acceso a los últimos mensajes.
Análisis Automático de Correos Electrónicos
Extraiga datos estructurados de correos electrónicos sin esfuerzo, permitiendo potentes integraciones de automatización y flujos de trabajo.

Visión general

Simplificar IMAP con Unipile

IMAP no proporciona una API basada en HTTP, lo que obliga a los desarrolladores a trabajar directamente con sus comandos de protocolo y sus complejidades. La API IMAP de Unipile transforma este complejo protocolo en una API accesible basada en HTTP., completo con soporte para webhooks y sincronización en tiempo real.

Al utilizar Unipile, los desarrolladores pueden superar los desafíos de implementar conexiones IMAP sin procesar, garantizando al mismo tiempo una sincronización eficiente y en tiempo real entre la aplicación y las cuentas de correo electrónico del usuario.

Proveedores y funciones IMAP compatibles

La API IMAP de Unipile admite una amplia gama de proveedores de correo electrónico, lo que garantiza flexibilidad y compatibilidad para diversos casos de uso:

FastMail Zoho Mail Correo de GoDaddy Yandex.Mail AOL Mail Bluehost Mail.com EarthLink Hover.com GMX IONOS Yahoo Mail Cualquier servidor IMAP que cumpla con los estándares

Estos son solo algunos de los proveedores IMAP que se pueden integrar con Unipile, ofreciendo flexibilidad y funcionalidad robusta para diversas plataformas de correo electrónico.

Funcionalidad

Cómo la API IMAP mejora la funcionalidad del correo electrónico

La API IMAP desempeña un papel crucial en las aplicaciones de correo electrónico modernas al permitir una sincronización perfecta, una gestión eficaz del correo electrónico y una comunicación segura. Mediante los comandos IMAP, los desarrolladores pueden recuperar, organizar y enviar correos electrónicos al tiempo que garantizan el acceso en tiempo real y una elevada integridad de los datos.

Sincronización de correo electrónico y acceso en tiempo real

Con la API IMAP de Unipile, los correos electrónicos se sincronizan en tiempo real entre dispositivos, permitiendo una gestión actualizada de la bandeja de entrada y la recuperación de todo el historial de correo electrónico sin limitaciones de tiempo.

Administrar carpetas y etiquetas con comandos IMAP

Los usuarios pueden crear, eliminar y organizar correos electrónicos utilizando etiquetas y carpetas para una mejor categorización y automatización del flujo de trabajo.

Envío de correos electrónicos a través de IMAP

La API IMAP de Unipile permite a los desarrolladores enviar mensajes directamente usando comandos IMAP, asegurando una transmisión de correo electrónico fluida mientras se mantiene la sincronización en todos los dispositivos vinculados.

Seguridad

Autenticación y seguridad de la API IMAP con Unipile

Garantizar una autenticación segura y la protección de los datos es crucial a la hora de integrar soluciones API IMAP. Unipile ofrece sólidos mecanismos de autenticación y estándares de cifrado para salvaguardar las comunicaciones por correo electrónico.

Autenticación alojada para IMAP

Unipile simplifica la autenticación permitiendo a los usuarios conectar sus cuentas de correo electrónico a través de una interfaz alojada segura, eliminando la necesidad de almacenar credenciales dentro de su aplicación.

Cifrado y privacidad de datos

La seguridad de los datos se prioriza con el cifrado de extremo a extremo, lo que garantiza que el contenido del correo electrónico siga siendo confidencial y esté protegido frente a accesos no autorizados.

Integración

Guía paso a paso para configurar la API IMAP de Unipile

Esta guía te ayudará a integrar la API IMAP de Unipile en tu aplicación para una gestión de correo electrónico sin interrupciones. Sigue los pasos a continuación para autenticarte y comenzar a usar la API IMAP de manera efectiva. Para desarrolladores de Python, consulta nuestra Ejemplos de código Python para enviar correos electrónicos a través de la API unificada.

1

Paso 1: Obtener acceso a la API

Crear una cuenta en Unipile

Antes de empezar, asegúrese de tener:

Una registrada Cuenta Unipile.
Acceso a las credenciales de la API de Unipile (ID de cliente, secreto de cliente y token de acceso).

Generar credenciales de API

Inicia sesión en tu panel de desarrollador de Unipile.
Navega a la sección de Claves de API.
Cree una nueva clave API y anote el ID de cliente, el secreto de cliente y el token de acceso.
2

Paso 2: Configurar IMAP

Para conectar su aplicación con una cuenta de correo electrónico a través de IMAP, necesita lo siguiente:

Usuario IMAP: La dirección de correo electrónico que deseas integrar
Contraseña IMAP: La contraseña o la contraseña de aplicación para la cuenta de correo electrónico
Servidor IMAP: La dirección del servidor de correo electrónico
3

Paso 3: Autenticarse con la API IMAP de Unipile

Punto final de la API para la autenticación

Punto final
POST https://{subdomain}.unipile.com:{port}/api/v1/accounts

Ejemplo de solicitud API (cURL):

cURL
curl --request POST \ --url https://{TU_DSN}/api/v1/accounts \ --header 'X-API-KEY: {TU_TOKEN_DE_ACCESO}' \ --header 'content-type: application/json' \ --datos '{ "provider": "MAIL", "imap_user": "tu_email@example.com", "imap_password": "tu_contraseña", "imap_host": "imap.tuproveedordemail.com", "imap_port": 993, "imap_encryption": "SSL" }'

Sustituya los marcadores de posición por sus credenciales reales y los datos del servidor:

{TU_DSN}: Tu dominio de instancia de Unipile.
{TU_TOKEN_DE_ACCESO}: Tu token de acceso a la API.
Parámetros relacionados con el correo electrónico (imap_user, imap_password, imap_host, etc.) con los datos de su cuenta.
4

Paso 4: Probar la conexión IMAP

Una vez que la solicitud tenga éxito, Unipile responderá con un ID de cuenta y detalles de conexión. Utilice estos datos para verificar la integración:

Ejemplo de respuesta:

Respuesta JSON
{ "objeto": "CuentaCreada", "account_id": "id_cuenta_unico", "estado": "conectado" }
5

Paso 5: Obtención de correos electrónicos mediante comandos IMAP

Después de la autenticación, utiliza la API de Unipile para recuperar correos electrónicos mediante programación.

Obtener correos electrónicos (ejemplo):

SDK de Node.js
import { UnipileClient } from "unipile-node-sdk"; const cliente = new UnipileClient("tu_url_base", "tu_token_de_acceso"); async function fetchEmails() { intentar { const response = await client.account.getAll(); console.log(response); } captura (error) { console.error(error); } } fetchEmails();
Listar todos los correos electrónicos: Esta función permite recuperar una lista de correos electrónicos de la cuenta de un usuario, aplicando varios filtros para buscar mensajes específicos basados en criterios como remitente, fecha o contenido. Simplifica el proceso de búsqueda y organización de correos electrónicos, ahorra tiempo al eliminar la clasificación manual y mejora la participación del usuario al mostrar rápidamente las correspondencias relevantes.
6

Paso 6: Solucionar errores comunes

Problemas comunes

401 No autorizado
Verifica tus credenciales de API y token de acceso.
Host IMAP no válido
Asegúrate de que los detalles del servidor IMAP sean correctos.
Errores de tiempo de espera
Verificar la conectividad de red y la disponibilidad del servidor.

Consejos de depuración

Registre la respuesta de error completa para diagnósticos.
Utilice Documentación para desarrolladores de Unipile y apoyo para obtener ayuda adicional.
API IMAP

Características de las soluciones API IMAP

Integra proveedores de correo electrónico de Gmail, Outlook e IMAP a través de una única API unificada. Envía, recibe, organiza y rastrea correos electrónicos en todos los proveedores importantes con puntos de conexión consistentes.

Explorar todos los puntos finales
Gmail Outlook IMAP
Conexión de cuentasCuenta
Enviar / RecibirEnviar
Organice
Webhooks

Conexión de cuentas

3 puntos finales disponibles

Gmail Gmail
Outlook Outlook
IMAP IMAP
Hosted Auth: Autenticación de correo electrónico de marca blanca
Autenticación personalizada: Conectar usuario con credenciales
Utilice su pantalla App OAuth

Enviar / Recibir

3 puntos finales disponibles

Gmail Gmail
Outlook Outlook
IMAP IMAP
Enviar un correo electrónico
Responder a un correo electrónico
Lista de correos electrónicos

Organice

4 puntos finales disponibles

Gmail Gmail
Outlook Outlook
IMAP IMAP
Borrar correo electrónico
Mover correo electrónico
Lista de carpetas
Obtener carpeta

Webhooks

2 eventos disponibles

Gmail Gmail
Outlook Outlook
IMAP IMAP
Nuevo correo electrónico
Seguimiento de aperturas y clics
Comparación

Unipile vs Autointegración: Por qué Unipile es la mejor opción

Al integrar la funcionalidad de correo electrónico en tu aplicación, te puedes encontrar con la disyuntiva de usar una solución ya hecha como Unipile o construir tu propia autointegración. Si bien esta última puede parecer atractiva por el control total, Unipile (un líder Nylas alternativa) ofrece ventajas significativas en términos de tiempo, esfuerzo de desarrollo y fiabilidad general. Aquí, comparamos Unipile con la auto-integración para soluciones de API IMAP.

Criterios API IMAP Unipile Autointegración
Hora de integrarse
Tan solo 2 días
De semanas a meses
Costo de desarrollo
Infraestructura preconstruida
Se requieren recursos significativos
Fiabilidad
Características de fiabilidad integradas
Riesgos de mala configuración del servidor
Seguridad
Cifrado de extremo a extremo incluido
Se requiere implementación manual
Escalabilidad
Escamas sin esfuerzo
Alto costo operativo

Comience a integrar IMAP en sólo dos días

Facilidad de aplicación
Unipile
Con Unipile, los desarrolladores pueden integrar soluciones de API IMAP en tan solo dos días. Su API simplificada y su sólida documentación simplifican enormemente el proceso, incluso para flujos de trabajo de correo electrónico complejos.
Autointegración
Construir tu propia auto-integración desde cero requiere una comprensión profunda de las extensiones IMAP, las configuraciones del servidor y los protocolos de seguridad.
Tiempo y coste de desarrollo
Unipile
Al aprovechar la infraestructura preconstruida de Unipile, las empresas pueden ahorrar un tiempo y unos costos de desarrollo sustanciales, permitiendo a los equipos centrarse en las características principales del producto.
Autointegración
La autointegración exige considerables recursos para desarrollo, pruebas y mantenimiento. Las actualizaciones continuas para manejar los cambios de los proveedores añaden una sobrecarga adicional.
Fiabilidad y rendimiento
Unipile
Unipile garantiza alta fiabilidad y rendimiento con funciones integradas como la obtención eficiente de correos electrónicos, la gestión de carpetas y la sincronización en tiempo real.
Autointegración
Las autointegraciones personalizadas a menudo presentan desafíos de confiabilidad debido a la mala configuración del servidor, los límites de frecuencia, el manejo de errores y las extensiones IMAP.
Seguridad y conformidad
Unipile
Unipile ofrece autenticación segura, cifrado de extremo a extremo y cumplimiento de los principales proveedores de correo electrónico como Gmail y Outlook.
Autointegración
Los desarrolladores deben implementar manualmente protocolos de seguridad, lo que aumenta el riesgo de vulnerabilidades, especialmente con las extensiones IMAP.
Escalabilidad y flexibilidad
Unipile
Unipile se escala sin esfuerzo para manejar múltiples proveedores de correo electrónico y cuentas vinculadas. Sus APIs están diseñadas para adaptarse a diversas necesidades empresariales.
Autointegración
Escalar una auto-integración requiere una sobrecarga de desarrollo y operativa significativa, particularmente cuando se trata de extensiones IMAP.
Listo para integrar
Empieza a usar la API IMAP en solo dos días

La API IMAP de Unipile ofrece a los desarrolladores una forma eficiente de integrar la funcionalidad de la API IMAP en sus aplicaciones. Con características como sincronización en tiempo real, autenticación segura y gestión de carpetas, elimina las complejidades de los protocolos IMAP brutos a la vez que garantiza una configuración rápida.

Empezar gratis
Lea la documentación

PREGUNTAS FRECUENTES

Preguntas frecuentes

Todo lo que necesitas saber sobre la integración de IMAP con la API de Unipile

La API unificada de correo electrónico de Unipile cubre tres rutas de integración: Gmail (a través de la API de Gmail y OAuth), Outlook vía Microsoft Graph y OAuth (cubre Outlook personal, Microsoft 365 y Exchange Online), y IMAP como el respaldo universal para cualquier otro proveedor.

Los proveedores compatibles con IMAP incluyen: Yahoo Mail, AOL Mail, GMX, FastMail, Zoho Mail, Mail.com, ProtonMail (a través de Bridge) y cualquier dominio personalizado que ejecute un servidor IMAP que cumpla con los estándares.

Sí. Las credenciales IMAP se cifran en reposo utilizando cifrado estándar de la industria. El flujo de autenticación alojado de Unipile significa que su aplicación nunca maneja contraseñas sin procesar: los usuarios ingresan sus credenciales en una página segura alojada por Unipile, y su aplicación solo recibe un account_id.

Todas las conexiones utilizan TLS en tránsito. Para Gmail y Outlook, se utiliza OAuth 2.0 en lugar de contraseñas por completo.

Sí: ese es el valor principal de Unipile. Una vez que se conecta una cuenta, todas las operaciones posteriores utilizan los mismos puntos de conexión: GET /api/v1/emails, POST /api/v1/correos, GET /api/v1/cuentas/{id}/carpetas.

Escribes la integración una vez, luego pasas diferentes account_id valores para cada proveedor.

Sí. El envío está gestionado (ver enviar correo electrónico en nombre del usuario API) a través de un solo POST /api/v1/correos Unipile enruta el mensaje a través del transporte correcto para cada proveedor: SMTP para cuentas IMAP, la API de Gmail para Gmail y Microsoft Graph para Outlook.

Se admiten el encadenamiento de respuestas, CC/BCC y archivos adjuntos.

Unipile mantiene conexiones IMAP persistentes en tu nombre, incluyendo la monitorización IDLE para la detección de correo nuevo en tiempo real. La agrupación de conexiones, la reconexión en caso de caída y la gestión de límites de tasa por proveedor se manejan de forma transparente.

Tu aplicación realiza llamadas HTTP sin estado; Unipile absorbe toda la complejidad del protocolo IMAP.

API de Gmail (ver nuestro Guía de la API de Gmail) es una API REST propietaria de Google que solo funciona con cuentas de Gmail. IMAP es el protocolo estándar abierto que funciona con cualquier servidor de correo compatible con los estándares, pero IMAP sin procesar requiere programación de sockets y no tiene una API HTTP nativa.

Unipile cierra la brecha: expone Gmail e IMAP a través de los mismos endpoints REST, por lo que obtienes la confiabilidad de Gmail para cuentas de Google y cobertura IMAP universal para todos los demás, con una sola integración.

Regístrese gratis en dashboard.unipile.com - no se requiere tarjeta de crédito. Obtiene acceso completo a la API para conectar cuentas y probar todos los puntos finales de correo electrónico.

Los planes de pago escalan por el número de cuentas enlazadas. Ver página de precios para obtener más detalles, o hable con el equipo para discutir precios por volumen.

¿Aún tiene preguntas? Habla con un experto; normalmente respondemos en pocos minutos

es_ESES