LinkedIn
Instagram
WhatsApp
Telegrama
Calendario de Google
Únase a la comunidad SlackAPI de correo electrónico para desarrolladores:
Construye con Gmail, Outlook e IMAP
Una referencia práctica para desarrolladores que crean integraciones de correo electrónico: compare Gmail API, Microsoft Graph e IMAP, y luego vea cómo una API de correo electrónico unificada para desarrolladores reduce semanas de código repetitivo en una sola llamada REST.
¿Qué es una API de correo electrónico para desarrolladores?
Antes de comparar proveedores y escribir código, aquí tienes la definición precisa que los motores de búsqueda y tus compañeros de equipo necesitan.
En API de correo electrónico para desarrolladores es una interfaz programática que permite a tu aplicación autenticarse como un usuario y luego leer, enviar o administrar los correos electrónicos de ese usuario directamente dentro de Gmail, Outlook o cualquier buzón de correo IMAP, sin tener que manejar nunca su contraseña. La API se autentica a través de OAuth 2.0 (o credenciales IMAP), devuelve respuestas JSON estructuradas y activa webhooks cuando llega un nuevo correo. Es categóricamente diferente de una API de correo transaccional (SendGrid, Mailgun), que envía correos de marketing o notificaciones. en nombre de tu marca - una API de correo electrónico para desarrolladores actúa en nombre de tu usuario, dentro de su buzón existente.
En la práctica: un servicio de asistencia SaaS utiliza una API de correo electrónico para extraer tickets de soporte directamente de la bandeja de entrada de Gmail de un cliente. Un CRM la utiliza para sincronizar cada hilo de correo electrónico que un representante de ventas intercambia con un prospecto. Un agente de IA la utiliza para leer, clasificar y redactar respuestas dentro de la cuenta de Outlook de un usuario. Estas son integraciones del lado de la sincronización, del lado del usuario de OAuth, no canalizaciones de envío masivo.
Por qué los desarrolladores necesitan una integración de API de correo electrónico
Estas son las cuatro categorías de productos donde una API de correo electrónico para desarrolladores ofrece valor comercial directo: leer y actuar sobre correos electrónicos de usuarios reales, no enviar correos masivos.
Los CRM, los sistemas de soporte y las herramientas de gestión de proyectos necesitan acceso en vivo al buzón de un usuario. Tu aplicación se autentica una vez vía OAuth, luego lee, enlaza y muestra correos electrónicos directamente en tu interfaz de usuario, sin copiar y pegar, ni reglas de reenvío. La integración de la API de correo electrónico se ejecuta en segundo plano, manteniendo tus datos actualizados.
Los agentes impulsados por LLM necesitan Leer y clasificar correos electrónicos reales para redactar respuestas, extraer entidades, activar flujos de trabajo o dirigir tickets. Una API de correo electrónico para desarrolladores brinda a su agente de IA acceso estructurado a JSON a la bandeja de entrada (asunto, cuerpo, archivos adjuntos, encabezados) sin necesidad de crear un cliente de correo personalizado.
Extraer correos de soporte directamente de buzones de clientes o bandejas de entrada compartidas, etiquételos por tema, asigne agentes y publique respuestas, todo de forma programática. La integración de la API de correo electrónico reemplaza el frágil sondeo SMTP con una interfaz REST adecuada y webhooks en tiempo real.
Registre cada correo electrónico que un representante de ventas envía o recibe en el contacto o trato correcto. Rastree el estado de apertura/respuesta a nivel de hilo. Mantenga su CRM sincronizado con historial de conversaciones reales sin pedir a los representantes que copien a una dirección mágica. Integración puramente de API de correo electrónico, del lado del usuario, basada en OAuth, en nombre de cada representante individual.
Esto NO es para correos electrónicos transaccionales. Si tu caso de uso es enviar restablecimientos de contraseña, confirmaciones de pedidos o boletines informativos desde tu propio dominio, ese es el mercado transaccional (SendGrid, Mailgun, Resend). La API de correo electrónico de Unipile para desarrolladores aborda el mercado de sincronización/lectura/escritura en nombre del usuario: infraestructura diferente, requisitos de cumplimiento diferentes, modelo de precios diferente.
Gmail API, Microsoft Graph y IMAP comparados
Cada integración de API de correo electrónico comienza con uno de tres proveedores nativos. Aquí se presenta lo que cada uno ofrece y dónde cada uno crea fricción para los desarrolladores.
| Característica | API de Gmail | Microsoft Graph | IMAP | Unipile (unificado) |
|---|---|---|---|---|
| Método de autenticación | OAuth 2.0 | OAuth 2.0 | Contraseña / XOAUTH2 | OAuth 2.0 (todo) |
| Ganchos web en tiempo real | Pub/Sub (Se necesita GCP) | Suscripciones de gráficos | No (sondeo inactivo) | Webhook unificado |
| Formato de respuesta | Gmail JSON (no estándar) | Gráfico JSON (OData) | RFC 2822 MIME en bruto | Esquema JSON unificado |
| Refresco de token | Manual (biblioteca google-auth-library) | Manual (MSAL) | N/A | Gestionado por Unipile |
| Límites de tarifa | 250 QU/usuario/s | 10k solicitudes/10 min | Varía según el servidor | Abstraído + reintentar |
| Enviar correo electrónico | Sí | Sí | Solo SMTP | Sí (todos los proveedores) |
| Archivos adjuntos | Requiere una llamada adicional | Máx 4 MB en línea | MIME completo | API Unificada de Adjuntos |
| Tiempo de configuración (estimado) | 1-2 semanas | 1-2 semanas | 3-5 días | Horas |
API de correo nativa vs. API de correo unificada: comparación de código real
Ver ambos enfoques uno al lado del otro, en código real, hace que el compromiso sea concreto. Seleccione un idioma a continuación para comparar la lectura de correos electrónicos de forma nativa frente a través de la API de correo electrónico unificada de Unipile.
// 1. Instalar y configurar cliente OAuth
const {google} = require('googleapis');
const autenticación = new google.auth.OAuth2(
CLIENT_ID, CLIENT_SECRET, REDIRECT_URI
);
// 2. Intercambiar código de autorización por tokens
const {tokens} = await autenticación.obtenerToken(código);
autenticación.establecerCredenciales(tokens);
// 3. Almacenar y actualizar tokens manualmente
// 4. Llamar a la API de Gmail
const gmail = google.gmail({
versión: 'v1', autenticación
});
const res = await
gmail.usuarios.mensajes.list({
userId: yo, resultadosMáximos: 10
});
// 5. Obtener mensaje completo por ID
const msj = await
gmail.usuarios.mensajes.consiga({
userId: yo,
id: res.data.mensajes[0].id,
formato 'completo'
});
// 6. Analiza la carga útil codificada en base64url tú mismo1. Un SDK, todos los proveedores
const unipile =
require('@unipile/node-sdk');
const client =
new unipile.UnipileClient(
API_URL, ACCESS_TOKEN
);
// 2. Tokens administrados por Unipile
// No es necesario un flujo de OAuth manual
// 3. Listar correos electrónicos
const correos electrónicos = await
cliente.email.listarTodo({
account_id: ID_DE_CUENTA,
límite: 10
});
// 4. Cuerpo ya decodificado
// JSON unificado - mismo esquema
para Gmail, Outlook, IMAP
consola.log(emails.elementos);import msal, solicitudes
# 1. Cliente confidencial de MSAL
aplicación = msal.ConfidentialClientApplication(
ID_DEL_CLIENTE,
autoridad=AUTORIDAD,
credencial_cliente=SECRETO_CLIENTE
)
# 2. Obtener el token en nombre del usuario
resultado = aplicación.adquirir_token_por_flujo_de_código_de_autorización(
flujo, respuesta_autenticacion
)
ficha = resultado ['token_de_acceso']
# 3. Gestionar la actualización del token y almacenarlo de forma segura
# 4. API de gráficos de llamadas
cabeceras = {'Authorization': f'Portador {token}'}
r = solicitudes.consiga(
'https://graph.microsoft.com/v1.0/me/messages',
cabeceras=cabeceras
)
# 5. Analizar la respuesta de la envoltura ODataimport solicita
Token # gestionado por Unipile
#: sin MSAL, sin configuración de OAuth
cabeceras = {
'X-API-KEY': TOKEN_DE_ACCESO,
'Aceptar': aplicación/json
}
# funciona tanto con Gmail como con Outlook
#: mismo punto final, mismo esquema
r = solicitudes.consiga(
'https://api7.unipile.com:13091'
'/api/v1/correos',
cabeceras=encabezados,
parámetros={
'id_cuenta': ID_DE_CUENTA,
'límite': 10
}
)
correos electrónicos = r.json()
# Ya analizado, sin OData# IMAP no dispone de una API REST
#: Es obligatorio utilizar imaplib o node-imap
#: No hay equivalente a cURL
Ejemplo de #: openssl s_client
# (solo para depuración; no para producción)
openssl s_client \
-conectar imap.gmail.com:993 \
silencioso
# A continuación, envía comandos IMAP sin procesar:
# A001 Nombre de usuario: user@gmail.com Contraseña:
# A002 SELECCIONAR BANDEJA DE ENTRADA
# A003 FETCH 1 RFC822
# A004 SALIR
# Recibes MIME RFC 2822 sin procesar
# Debe analizar los encabezados y descodificarlos
Partes # en base64, gestión de archivos multiparte
#: pon tus propios límites
# Además: sin webhooks, debe realizarse una consulta en modo inactivoAPI REST de #: funciona con cualquier
Proveedor de correo electrónico # a través de cURL
rizo \
-X OBTENER \
-H "X-API-KEY: $TOKEN" \
-H "Aceptar: application/json" \
"https://api7.unipile.com:13091
/api/v1/emails
?account_id=$ACCOUNT_ID
&límite=10"
Respuesta #: JSON limpio
# { "items": [ { "id": "...",
# "asunto": "Hola",
# "from": { "name": "Alice",
# "address": "..." },
# "body_plain": "...",
# "date": "2026-05-12T..." } ] }
#: mismo punto final para Gmail,
# Outlook y cuentas IMAPFundamentos de OAuth 2.0 para la integración de APIs de correo electrónico
Cada integración de API de correo de producción se basa en OAuth 2.0 para autenticarse como usuario sin almacenar su contraseña. Aquí está lo que necesita configurar para cada proveedor y cómo Unipile lo maneja por usted.
gmail.lectura, gmail.enviar. Los ámbitos sensibles requieren verificación de Google para producción.google-auth-library o un manejador personalizado.
Mail.Read, Mail.Enviar, Mail.ReadWrite.SDKs y herramientas para la integración de API de correo electrónico
Tanto si desarrollas de forma nativa como si utilizas una capa unificada, el SDK adecuado reduce el código repetitivo. A continuación se presenta el panorama actual de cada proveedor y de Unipile.
SDK oficial para la API unificada de correo electrónico de Unipile. Cubre lectura, envío de correos electrónicos, gestión de cuentas y webhooks para Gmail, Outlook e IMAP, en un solo paquete. Incluye definiciones de TypeScript.
@azure/msal-node (por separado). En buen estado. El formato de respuesta OData requiere un análisis adicional incluso en casos de uso sencillos.Precios amigables para desarrolladores: empieza gratis, escala transparentemente
"Las APIs de correo electrónico nativas "gratuitas" en realidad no lo son. La API de Gmail y Microsoft Graph cuestan cero dólares por llamada a la API, pero cada una exige semanas de ingeniería: ciclos de verificación de OAuth, lógica de actualización de tokens, infraestructura de webhooks, manejadores de reintentos, mapeo de errores. Un equipo de tamaño mediano suele tardar de 3 a 6 semanas antes de lanzar una sola función. La API unificada de correo electrónico de Unipile para desarrolladores reemplaza ese trabajo con una prueba gratuita de 7 días, sin necesidad de tarjeta de crédito.
En resumen: las llamadas a la API son gratuitas, la ingeniería no. Crear una integración de correo electrónico de nivel de producción sobre APIs nativas (flujos de autenticación, actualización de tokens, manejo de errores, infraestructura de webhooks, abstracción de múltiples proveedores) comúnmente cuesta de 3 a 8 semanas de tiempo de un desarrollador senior por proveedor, además del mantenimiento continuo cada vez que Google o Microsoft envía un cambio que rompe la funcionalidad. Unipile tiene precios por cuenta vinculada al mes con niveles transparentes. Ver Guía gratuita de la API de correo electrónico Para el desglose completo.
Seguridad y cumplimiento para integraciones de API de correo electrónico
Cuando tu aplicación maneja correos electrónicos de usuarios, el cumplimiento no es opcional. Unipile está construido para los dos marcos que importan para los productos dirigidos a desarrolladores que manejan datos europeos y empresariales.
Unipile es Certificación SOC 2 Tipo II. La auditoría cubre los criterios de servicio de confianza de Seguridad, Disponibilidad y Confidencialidad. Esto significa que auditores independientes han verificado los controles de Unipile durante un período sostenido, no solo en un momento determinado. Requerido por la mayoría de los compradores empresariales y cuestionarios de seguridad SaaS.
Unipile procesa datos de correo electrónico como un procesador de datos En virtud del artículo 28 del RGPD. Los acuerdos de procesamiento de datos (APD) están disponibles para todos los planes de pago. Los datos de correo electrónico del usuario se procesan solo durante la sesión autenticada y dentro del alcance otorgado por el consentimiento OAuth del usuario. No hay almacenamiento en paralelo, ni datos vendidos a terceros.
Errores comunes en la integración de la API de correo electrónico (y cómo solucionarlos)
Todo desarrollador que crea su primera integración de API de correo electrónico se topa con las mismas cuatro paredes. Aquí están y cómo manejar cada una correctamente.
La cuota de 250 unidades por usuario por segundo de Gmail suena generosa hasta que te das cuenta de que listar 10 mensajes cuesta entre 5 y 10 unidades cada uno y obtener cuerpos completos añade cuota por byte. Microsoft Graph limita a 10,000 solicitudes por 10 minutos por aplicación por inquilino. Al alcanzar el límite se devuelve 429 - Demasiadas solicitudes. Sin lógica de reintento, tu bucle de sincronización falla silenciosamente.
Los tokens de acceso de Google expiran después de 3.600 segundos. Los tokens de Microsoft después de 60-90 minutos. Si tu token de actualización es revocado (el usuario cambia la contraseña, revoca el acceso a la aplicación o el token no se ha utilizado en 6 meses para Google), toda su sincronización se detiene silenciosamente. No se muestra ningún error a menos que supervise la respuesta de la llamada de actualización.
Las suscripciones de Microsoft Graph expiran después de un máximo de 4.230 minutos (aproximadamente 3 días para correo). Olvidar renovarlos significa que no habrá más notificaciones push - tu aplicación recurre a sondeos o se pierde eventos por completo. Las suscripciones de Pub/Sub de Gmail son más persistentes, pero requieren una suscripción de GCP para seguir siendo válidas y que el tema exista.
Las API de correo electrónico son eventualmente consistentes. Si tu proceso de sincronización falla a mitad de ejecución, es posible que correos duplicados, saltarse una página de resultados o perder eliminaciones. Gmail utiliza historyId para la sincronización incremental; Microsoft Graph utiliza deltaToken. Ambos requieren una gestión cuidadosa del cursor entre reinicios. IMAP no tiene estado de sincronización nativo: debes mantener tu propio seguimiento de UID.
API de correo electrónico para desarrolladores - preguntas frecuentes
Respuestas a las preguntas que los desarrolladores hacen con más frecuencia al crear su primera integración API de correo electrónico en Gmail, Outlook e IMAP.
npm install @unipile/node-sdk. Luego crea un cliente con tu URL de API y token de acceso, y llama client.email.listAll() leer correos electrónicos o client.email.enviar() para enviar a través de Gmail, Outlook e IMAP con una única ruta de código. Para Gmail nativo, usa googleapis paquete npm. Para Microsoft Graph, usa @microsoft/microsoft-graph-client.
ES 
EN 
FR 
DE 
IT 
BR 
NL 
PL 
TR