LinkedIn
Instagram
WhatsApp
Telegrama
Calendario de Google
Únase a la comunidad SlackConstruyendo un API de correo electrónico multi-proveedor la integración que funciona en Gmail, Outlook e IMAP es uno de los desafíos que más tiempo consumen para los equipos de desarrollo. Cada proveedor envía su propio flujo OAuth, límites de frecuencia y modelo de datos. Un API de correo electrónico unificada resumimos todo eso en una única interfaz REST: escribes una integración y obtienes cobertura para todas las bandejas de entrada principales en las que confían tus usuarios.
Qué aprenderás
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.
¿Por qué los desarrolladores necesitan una API de correo electrónico multiproveedor?
La mayoría de los productos SaaS eventualmente necesitan leer o enviar correos electrónicos en nombre de sus usuarios. El problema no es el concepto, sino la ejecución. Gmail utiliza la API de Gmail con Google OAuth 2.0. Outlook utiliza Microsoft Graph con su propio ciclo de vida de tokens. Los proveedores basados en IMAP se comportan de manera ligeramente diferente. La creación y el mantenimiento de tres integraciones separadas agotan los ciclos de ingeniería que deberían dedicarse a su producto principal. Si se trata específicamente de cuentas IMAP, el Guía de la API IMAP cubre la complejidad adicional involucrada. API de correo electrónico unificada resuelve esto colapsando toda la complejidad específica del proveedor detrás de una única interfaz: esa es la promesa central de un API de correo electrónico multi-proveedor enfoque. Para una referencia técnica completa sobre cómo API para enviar correo electrónico llamadas a través de Gmail, Outlook e IMAP, consulte nuestra guía dedicada.
En 3 proveedores de correo electrónico cubierto
Una API unificada normaliza Gmail, Outlook e IMAP en una interfaz idéntica. Tu código nunca cambia cuando un usuario conecta un proveedor diferente.
Conecta cualquier cuenta de Gmail o Google Workspace a través de Google OAuth 2.0. Envía, lee, busca y sincroniza hilos en tiempo real a través de la capa Unipile, sin necesidad de credenciales directas de la API de Gmail en tu aplicación.
Admite cuentas personales de Outlook, Microsoft 365 y Exchange Online bajo un único gestor de proveedores. Microsoft OAuth es gestionado por Unipile, tu integración se mantiene estable en todas las configuraciones de inquilino.
Cualquier buzón accesible a través de IMAP (Yahoo, Fastmail, ProtonMail Bridge, servidores corporativos personalizados) se vuelve instantáneamente accesible a través de la misma interfaz de API utilizada para Gmail y Outlook.
Unipile vs construirlo tú mismo
¿Cuánto cuesta realmente hacer tú mismo un API de correo electrónico multi-proveedor ¿integración? Aquí tienes una comparación honesta a través de las dimensiones que importan en producción. Es por eso que los equipos eligen cada vez más una API de correo electrónico unificada como Unipile en lugar de construir cada integración de proveedor desde cero.
Cómo integración funciona
Conectar tu primera cuenta de correo electrónico con Unipile consta de cuatro pasos. El mismo flujo funciona independientemente de si el usuario tiene una cuenta de Gmail, Outlook o Cuenta IMAP - tu código de aplicación permanece idéntico en todo momento. Este es el poder práctico de una API de correo electrónico unificada: escribe una vez, cubre los tres proveedores.
Tu backend llama a la API de Unipile para crear una URL de autenticación alojada de corta duración. Redirige al usuario a esa URL; Unipile presenta la pantalla de selección del proveedor y maneja el flujo OAuth completo en tu nombre.
// POST /api/v1/hosted/accounts/link const res = await fetch('https://api5.unipile.com:13515/api/v1/hosted/accounts/link', { método: POST, encabezados: { 'X-API-KEY': process.env.UNIPILE_API_KEY, 'Content-Type': aplicación/json }, cuerpo: JSON.stringify({ tipo: 'CORREO ELECTRÓNICO', proveedores_filtro: ['GOOGLE', 'MICROSOFT', 'IMAP'], url_redirección_éxito: 'https://tuapp.com/auth/success' }) }); const { url } = await res.json(); // redirigir usuario a `url`
Una vez que el usuario completa OAuth, Unipile envía un webhook a tu endpoint (o agrega el ID de cuenta a tu URL de redirección). Almacena este ID de cuenta; es tu referencia permanente a esa cuenta enlazada, independiente del proveedor.
{
"evento": "cuenta.conectada",
"account_id": "acc_01HXYZ...",
"proveedor": "Google",
"correo electrónico": "alice@gmail.com"
}
Use el ID de cuenta para listar, buscar y recuperar correos electrónicos. Este es el API de correo electrónico unificada en acción: el esquema de respuesta es idéntico ya sea que la cuenta sea Gmail, Outlook o IMAP: su lógica de análisis nunca se ramifica según el proveedor.
// OBTENER /api/v1/emails?account_id=acc_01HXYZ... const emails = await fetch( https://api5.unipile.com:13515/api/v1/emails?account_id=${accountId}`&límite=20`, { encabezados: { 'X-API-KEY': process.env.UNIPILE_API_KEY } } ).entonces(r => r.json()); // Misma estructura de respuesta para Gmail, Outlook, IMAP: // { id, asunto, de, para, fecha, cuerpo, archivosAdjuntos }
Un único endpoint POST envía correos electrónicos independientemente del proveedor detrás de la cuenta: este es el poder completo de un API de correo electrónico multi-proveedor. Pase el ID de cuenta, el destinatario, el asunto y el cuerpo. Unipile enruta a través de la API de Gmail, Microsoft Graph o SMTP según corresponda. Este es el API de correo electrónico unificada en su forma más concreta: un punto final, tres proveedores, cero ramificaciones en su código.
// POST /api/v1/emails/enviar await fetch('https://api5.unipile.com:13515/api/v1/emails/send', { método: POST, encabezados: { 'X-API-KEY': process.env.UNIPILE_API_KEY, 'Content-Type': aplicación/json }, cuerpo: JSON.stringify({ account_id: 'acc_01HXYZ...', a: [{ email: 'bob@example.com' }], tema: 'Hola desde Unipile', cuerpo: 'Funciona con Gmail, Outlook e IMAP.
' }) });
Cómo abstracción del proveedor funciona
La API unificada de correo electrónico se sitúa entre tu aplicación y los tres protocolos de proveedor subyacentes, traduciendo flujos de OAuth, esquemas de datos y modelos de límites de tasa divergentes en una única interfaz coherente.
Gmail utiliza Google OAuth 2.0 con un ciclo de actualización de tokens específico y devuelve correos electrónicos en un modelo centrado en hilos con etiquetas. Outlook utiliza Microsoft Graph con un modelo de inquilino OAuth diferente y devuelve correos electrónicos como objetos de mensajes individuales con carpetas. Los servidores IMAP tienen sus propios parámetros de conexión, métodos de autenticación y conjuntos de capacidades.
Unipile's API de correo electrónico unificada normaliza los tres en una única interfaz REST. Tu código llama /api/v1/emails y recibe objetos de respuesta con la misma forma, independientemente de si la cuenta subyacente es una cuenta de Gmail, Outlook o IMAP. Lo mismo se aplica al envío, al manejo de archivos adjuntos, a los eventos de webhook y a la gestión del ciclo de vida de la cuenta.
Este es el beneficio de ingeniería principal del API de correo electrónico multi-proveedor la complejidad se absorbe en la capa de infraestructura, no en el código de su aplicación. Cuando Google cambia sus requisitos de ámbito de OAuth o Microsoft actualiza la paginación de la API de Graph, Unipile se encarga del cambio upstream: su integración permanece intacta.
Seguridad y cumplimiento
Cuando su aplicación maneja correos electrónicos en nombre de los usuarios, la seguridad no es opcional. A continuación, se explica cómo la capa de API de correo electrónico unificada administra las credenciales, los datos y las obligaciones de cumplimiento.
Unipile almacena y actualiza tokens OAuth en tu nombre. Tu aplicación nunca maneja credenciales en bruto; solo trabajas con IDs de cuenta opacos. La rotación de tokens, la detección de expiración y los flujos de reautenticación se gestionan por completo en la capa de infraestructura.
Todos los datos en tránsito utilizan TLS 1.3. Las credenciales almacenadas están cifradas en reposo con AES-256. El contenido del correo electrónico recuperado a través de la API de correo electrónico unificada se procesa en memoria y no se conserva más allá de lo que su integración solicita explícitamente.
Unipile está certificado SOC 2 Tipo II (octubre de 2025). Auditores independientes han verificado la seguridad, disponibilidad y confidencialidad de la plataforma. Los informes de auditoría están disponibles bajo solicitud para clientes empresariales que evalúen la API de correo electrónico multiproveedor para uso en producción.
Los acuerdos de procesamiento de datos están disponibles para todos los planes. Se ofrece la opción de residencia de datos en la UE para clientes con requisitos de localización de datos. El derecho a la eliminación es compatible a través de la API: la eliminación de una cuenta vinculada elimina todos los tokens y datos cacheados asociados.
Evaluación de seguridad de aplicaciones de Google Cloud. Valida los controles de seguridad para aplicaciones que acceden a datos de usuarios de Google, incluidos los alcances de OAuth de Gmail. Las aplicaciones creadas en Unipile heredan esta certificación.
El historial de tiempo de actividad e incidentes está disponible públicamente en status.unipile.com. Todos los cambios de API siguen una política de versionado con avisos de depreciación. No hay cambios disruptivos silenciosos: su integración está protegida por un contrato estable y documentado.
Manejo de casos extremos entre proveedores
Cada integración de correo electrónico de producción se encuentra con casos límite específicos del proveedor. Aquí se compara un enfoque de bricolaje con el uso de una API de correo electrónico unificada cuando las cosas se complican.
| Escenario | Enfoque de bricolaje | Enfoque Unipile |
|---|---|---|
| Límite de velocidad de Gmail 250 unidades de cuota por día nivel gratuito |
Seguimiento manual de cuotas por cuenta; las solicitudes fallan silenciosamente si no se monitorizan. | Manejado automáticamente Encolado incorporado, no se detectaron solicitudes fallidas en tu aplicación |
| Expiración del token OAuth | Implementar lógica de actualización separada por proveedor; la rotación de tokens difiere entre Google y Microsoft | Actualización automática Gestión de tokens sin interrupciones en todos los proveedores |
| Las conexiones IMAP se caen | Lógica de reconexión personalizada por configuración de servidor; los tiempos de espera varían entre las implementaciones de IMAP | Pool de conexiones administrado Conexiones persistentes mantenidas por la infraestructura de Unipile |
| Límites de tamaño de archivo adjunto Gmail 25MB, Outlook 150MB, IMAP varía |
Código de ramificación por proveedor; debe rastrear el límite de cada proveedor y actualizarlo cuando cambie | Validación unificada Validación de tamaño independiente del proveedor; errores devueltos en un esquema coherente |
| Cambios en la API del proveedor | Tu responsabilidad de guardia; Google y Microsoft aplican cambios disruptivos con poca antelación | Gestionado por el equipo de Unipile Cambios de río arriba absorbidos a nivel de infraestructura; tu integración se mantiene estable |
Límite de velocidad de Gmail
250 unidades de cuota por día nivel gratuitoSeguimiento manual de cuotas por cuenta; las solicitudes fallan silenciosamente si no se monitorizan.
La guía de pilares cubre todos los puntos finales de nuestro API de correo electrónico unificada en profundidad: flujos de autenticación, manejo de adjuntos, sincronización de carpetas, filtros de búsqueda y configuración de webhooks. Todo lo que necesitas para crear una integración de correo electrónico de producción.
Común casos prácticos
A API de correo electrónico unificada es infraestructura fundamental para una amplia gama de categorías de productos. Con una API de correo electrónico multi-proveedor, los equipos lanzan funcionalidades más rápido y atienden a más usuarios, independientemente del proveedor de buzón que utilicen. Estos son los patrones que se crean con más frecuencia con Unipile.
Extrae automáticamente todos los correos electrónicos de clientes en los registros de tu CRM. Los representantes de ventas ven el historial completo de conversaciones sin cambiar de pestaña ni reenviar manualmente.
Envía secuencias de seguimiento personalizadas desde los correos reales de tus usuarios, no desde un dominio de envío compartido, a través de cuentas de Gmail y Outlook simultáneamente.
Los reclutadores vinculan su correo electrónico de trabajo y los registros de su ATS de cada hilo de candidato automáticamente. Responda directamente desde la interfaz de usuario del ATS, enrutado a través de su cuenta real de Outlook o Gmail.
Crea una bandeja de entrada compartida o un centro de ayuda que consolide el correo electrónico de varias cuentas de equipo. Enruta, asigna y responde, todo a través de una única interfaz respaldada por una única API.
Alimente hilos de correo electrónico en un LLM para generar borradores de respuestas, resúmenes o elementos de acción. Unipile proporciona los datos normalizados del hilo; su capa de IA realiza el razonamiento.
Dispara flujos de trabajo sin código a partir de correos electrónicos nuevos de cualquier proveedor. Un webhook se activa para cada mensaje entrante: tu plataforma de automatización se encarga del resto sin consultas.
Todos estos patrones funcionan en Gmail, Outlook e IMAP con cero código específico del proveedor en tu aplicación. Unipile normaliza las diferencias para que la lógica de tu producto se mantenga limpia y tus usuarios puedan conectar la bandeja de entrada que prefieran. Para una guía completa de cada punto final, consulta la guía de API de correo electrónico unificada.
Preguntas frecuentes preguntas
Todo lo que los desarrolladores preguntan antes de integrar una API de correo electrónico multiproveedor.
id, tema, from, a, fechay cuerpo tenga la misma estructura independientemente del proveedor. Su lógica de análisis, modelos de base de datos y procesamiento posterior nunca necesitarán ramificarse según el tipo de proveedor.
Conecta cuentas de Gmail, Outlook y IMAP a través de una única API. Sin complicaciones de OAuth, sin mapeo de esquemas, sin infraestructura de sondeo que mantener. Comienza con una prueba gratuita de 7 días, no se requiere tarjeta de crédito.
ES 
EN 
FR 
DE 
IT 
BR 
NL 
PL 
TR