LinkedIn
Instagram
WhatsApp
Telegrama
Calendario de Google
Únase a la comunidad SlackDa acceso a tu SaaS a Bandejas de entrada de usuarios vía API de correo electrónico
Una API de correo electrónico para SaaS permite que tu producto lea, envíe y sincronice correos electrónicos directamente desde las cuentas de Gmail, Outlook o IMAP de tus usuarios, sin necesidad de contraseñas. Crea integraciones de CRM, herramientas de ventas, centros de ayuda y asistentes de IA sobre una base unificada de OAuth.
import { UnipileClient } from 'unipile-node-sdk';
const cliente = new UnipileClient('TU_DSN', 'TU_TOKEN');
// Enlazar la bandeja de entrada de un usuario
const enlazar = await cuenta.cliente.create({
tipo: 'google',
url_de_redireccionamiento: 'https://app.com/cb'
});
// Recupera los últimos 50 correos electrónicos
const { artículos } = await cliente.email.obtenerTodo({
account_id: 'id_de_cuenta_de_usuario',
límite: 50
});
// Enviar desde la dirección del usuario
await cliente.email.enviar({
account_id: 'id_de_cuenta_de_usuario',
a: [{ identificador: 'lead@co.com' }],
tema: 'Seguimiento',
body: 'Hola, solo para saber de ti...'
});
¿Qué es una API de correo electrónico para SaaS?
La mayoría de los desarrolladores, al escuchar "API de correo electrónico", piensan en herramientas como SendGrid o Mailgun: servicios para enviar correos electrónicos transaccionales (recibos, notificaciones, enlaces mágicos) desde su propio dominio. Ese es un mercado completamente diferente. Una API de correo electrónico para SaaS resuelve un problema fundamentalmente diferente: dar a su producto acceso programático a las cuentas de correo electrónico de sus usuarios.
En API de correo electrónico para SaaS es un conjunto de puntos finales HTTP que permite que tu producto se autentique con el proveedor de correo electrónico de un usuario (Gmail, Outlook o IMAP) a través de OAuth, y luego lea, envíe, sincronice y busque correos electrónicos en su nombre, todo a través de una única integración, sin almacenar contraseñas ni gestionar peculiaridades específicas del proveedor.
Envía correos electrónicos desde tu dominio a tus usuarios. Se utiliza para restablecimientos de contraseña, facturas, notificaciones y campañas de marketing. Tu producto controla la dirección del remitente.
Da acceso a tu SaaS a las bandejas de entrada de sus usuarios vía OAuth. Tu producto lee, envía y sincroniza correos electrónicos en nombre de cada usuario, desde su cuenta de Gmail, Outlook o IMAP.
¿Qué productos SaaS se construyen realmente con una API de correo electrónico?
Cualquier producto en el que los usuarios necesiten actuar sobre correos electrónicos, o en el que los correos electrónicos deban fluir hacia su modelo de datos, es un candidato para una API de sincronización de correo electrónico de usuario. Aquí están los cinco patrones más comunes con los que los desarrolladores envían con Unipile.
Captura automáticamente todos los correos electrónicos intercambiados entre un representante de ventas y un contacto. Sin registros manuales, sin puntos de contacto perdidos. Tu CRM se mantiene actualizado sin ninguna acción del usuario.
Ejecuta secuencias de alcance de varios pasos desde la dirección de Gmail u Outlook de cada representante, no desde un dominio de envío compartido. Las respuestas llegan a la bandeja de entrada real del representante y se detectan automáticamente.
Extrae correos electrónicos de soporte de varias bandejas de entrada de equipo a una cola de tickets unificada. Las respuestas enviadas desde tu interfaz de helpdesk salen a través de la cuenta vinculada del agente, preservando la entregabilidad.
Permita que su producto de IA acceda al historial completo de correos electrónicos de un usuario. Resuma hilos, redacte respuestas, extraiga elementos de acción o clasifique clientes potenciales, todo basado en los datos reales de la bandeja de entrada del usuario.
Permita que los usuarios conecten su bandeja de entrada para activar automatizaciones: cree tareas a partir de correos electrónicos, extraiga datos de facturas, dirija archivos adjuntos a almacenamiento o conecte el correo electrónico con Slack, Notion o su propio motor de flujo de trabajo.
Conecta las bandejas de entrada de los reclutadores con tu ATS. Asocia automáticamente los correos electrónicos de los candidatos con las solicitudes de empleo, haz un seguimiento de las tasas de respuesta y permite que los reclutadores respondan directamente desde su cuenta vinculada sin salir de tu plataforma.
Qué debe soportar una API de correo electrónico de producción para SaaS
Crear una integración de correo electrónico fiable es más que llamar a un punto final REST. Aquí están las seis capacidades que cualquier integración seria de API de correo electrónico SaaS necesita cubrir, y dónde reside la complejidad oculta en cada una.
Cada usuario vincula su propia bandeja de entrada a través de un consentimiento de OAuth por separado. Tu SaaS actúa en nombre de cada usuario autenticado, no a través de una única cuenta de servicio compartida. Google y Microsoft requieren la verificación de la aplicación antes de que pueda emitir tokens OAuth a gran escala.
Sus usuarios tendrán bandejas de entrada de Gmail, Outlook (personal y Microsoft 365) y basadas en IMAP. Una API de correo electrónico robusta para SaaS normaliza estos tres proveedores en un formato de respuesta unificado y único así tu lógica de producto se mantiene agnóstica al proveedor.
La sondeo cada pocos minutos es frágil y lento. SaaS de producción requiere notificaciones de webhook cuando llegan nuevos correos electrónicos o cambia el estado del mensaje. Gmail usa Pub/Sub, Microsoft Graph usa suscripciones: su capa de API debe abstraer ambos en un formato de evento unificado.
Los clientes de correo electrónico agrupan los mensajes en hilos. Tu API de correo electrónico debe exponer un identificador de hilo consistente entre proveedores para que puedas responder en un hilo, colapsar conversaciones y detectar si una secuencia saliente recibió una respuesta, sin tener que analizar tú mismo las cabeceras Message-ID en bruto.
Leer archivos adjuntos significa decodificar partes MIME, manejar imágenes en línea y descargar blobs binarios a través de APIs específicas del proveedor. El endpoint debe permitirte recuperar adjuntos por ID sin volver a descargar el cuerpo completo del mensaje en cada solicitud.
Los datos de correo electrónico son sensibles. Tu integración necesita cifrado de tokens en reposo, permisos OAuth con ámbito (solicita solo lo que necesitas), registros de auditoría y una ruta de eliminación de datos documentada para satisfacer las solicitudes de "derecho al olvido" del RGPD y las auditorías SOC 2 Tipo II.
Los costos ocultos de crear tu propia integración de API de correo electrónico
Las bibliotecas de la API de Gmail, Microsoft Graph e IMAP son todas gratuitas y están bien documentadas. Entonces, ¿por qué la mayoría de los equipos de SaaS subestiman el costo de desarrollo entre 3 y 5 veces? Porque la complejidad no reside en la integración inicial, sino en todo lo que viene después.
Las aplicaciones que soliciten alcances de Gmail más allá del perfil básico deben pasar Evaluación de seguridad Tier 2 de CASA de Google antes de poder dar servicio a más de 100 usuarios de prueba. El proceso cuenta con la participación de un laboratorio de seguridad externo, dura entre 4 y 8 semanas y cuesta entre 40 000 y 75 000 T, dependiendo del alcance.
Microsoft requiere verificación del editor para aplicaciones que solicitan ámbitos de Graph API de mayor privilegio. Sin él, cada usuario ve un banner de advertencia rojo durante la pantalla de consentimiento de OAuth, lo que reduce drásticamente la conversión en los flujos de incorporación de SaaS B2B.
Existen cientos de implementaciones de servidores IMAP en uso. Cada una tiene sus peculiaridades: nombres de carpetas no estándar, soporte IDLE defectuoso, casos extremos de certificados TLS, comportamiento de tiempo de espera de conexión y flujos de autenticación por servidor. Cada cliente empresarial que consigas puede presentar un nuevo caso extremo que bloquea a su equipo.
Los tokens de OAuth expiran. Los tokens de actualización pueden ser revocados por el usuario o por la política del proveedor. A escala, gestión del ciclo de vida de tokens para miles de cuentas vinculadas a través de tres proveedores requiere un trabajo en segundo plano confiable, alertas de fallos y un flujo de UX de re-autenticación elegante.
Google y Microsoft deprecian y actualizan las superficies de API. Se eliminó la autenticación básica de Gmail. Microsoft deprecó los puntos de conexión heredados de Exchange. Mantenerse al día con los registros de cambios de tres proveedores es una carga de mantenimiento continua que recae enteramente en tu equipo de ingeniería.
Los datos de correo electrónico están dentro del alcance del RGPD y SOC 2 Tipo II. Se requieren flujos de datos documentados, cifrado en reposo y en tránsito, políticas de almacenamiento de tokens y un proceso de eliminación verificable. Construir esto desde cero para una auditoría de SaaS puede llevar semanas. y requiere una revisión legal.
Creación interna vs. API de agregación de correo electrónico para SaaS
Así es como se compara la creación de su propia integración de correo electrónico de tres proveedores con el uso de una API de correo electrónico unificada para SaaS en todas las dimensiones que importan a escala de producción.
| Capacidad | Crear internamente | API de Correo Electrónico Unipile |
|---|---|---|
| Integración de OAuth de Gmail | Manual - CASA Nivel 2 requerido |
Incluido - Certificación CASA Nivel 2 |
| Outlook / Microsoft 365 OAuth | Manual - se requiere verificación del editor |
Incluido - editor verificado |
| Soporte IMAP | Constrúyete a ti mismo - casos de borde a escala |
Completamente abstraído - todas las particularidades del servidor manejadas |
| Formato de respuesta unificado | 3 modelos de datos independientes que hay que normalizar |
Esquema único para todos los proveedores |
| Ganchos web en tiempo real | Pub/Sub + Suscripciones de gráficos - configuración separada por proveedor |
Un único punto de conexión de webhook para todos los proveedores |
| Renovación de token OAuth | Tu tarea en segundo plano: es necesario gestionar los errores |
Gestionado automáticamente |
| Modelo de hilos y conversaciones | Específico del proveedor - se necesita normalización personalizada |
Identificadores de hilo uniformes en todos los proveedores |
| API de archivos adjuntos | Análisis de MIME - construir por separado por proveedor |
Recuperar por ID de archivo adjunto - independiente del proveedor |
| Supresión de datos conforme al RGPD | Tu responsabilidad - rastro de auditoría personalizado |
Ruta de eliminación documentada - Preparado para GDPR |
| Cobertura SOC 2 Tipo II | Define tus propios controles |
Certificación SOC 2 Tipo II |
| Hora para la primera sincronización de correo electrónico | 4-6 meses (los tres proveedores) |
Menos de 1 día |
| Mantenimiento continuo | Tu equipo realiza un seguimiento de todos los cambios en la API de los proveedores |
Gestionado por Unipile - cero mantenimiento del proveedor |
Cómo Unipile ofrece una API de correo electrónico para SaaS en una sola integración
Unipile es una API de correo electrónico unificada para SaaS construida específicamente para el mercado de sincronización de usuarios. Un conjunto de puntos finales cubre Gmail, Outlook e IMAP, con OAuth, webhooks, encadenamiento, archivos adjuntos y cumplimiento gestionados por usted. Así es como se ve cada integración de proveedor internamente.
Usos de Unipile Google OAuth 2.0 para solicitar los alcances mínimos necesarios. La plataforma tiene la certificación CASA Tier 2, por lo que tu aplicación hereda el estado verificado sin pasar por tu propia evaluación.
Unipile se conecta a través del API Graph de Microsoft mediante la plataforma de identidad de Microsoft. Esto abarca tanto las cuentas personales de Outlook como los entornos corporativos de Microsoft 365 a través de un único flujo OAuth.
Para usuarios en Yahoo, Fastmail, servidores corporativos personalizados o cualquier otro proveedor, Unipile se conecta a través de IMAP. Todas las peculiaridades específicas del servidor, los casos extremos de TLS y las diferencias en los nombres de las carpetas se abstraen de tu código.
account_id. Guárdalo contra tu registro de usuario. Todas las llamadas de correo electrónico posteriores hacen referencia a esta ID, sin tokens ni secretos en tu base de datos.GET /correos electrónicos listar mensajes, POST /correos enviar, y GET /emails/:id/adjuntos para archivos. Mismos puntos de conexión para los tres proveedores.Sincronizar correos electrónicos de usuarios en tu SaaS: ejemplo de código completo
Tres idiomas, un patrón. Conecta la bandeja de entrada de un usuario, recupera sus correos electrónicos y envía desde su dirección, todo a través de la API unificada de correo electrónico de Unipile. El mismo código funciona para cuentas vinculadas de Gmail, Outlook e IMAP.
import { UnipileClient } from 'unipile-node-sdk';
const cliente = new UnipileClient('TU_DSN', 'TU_TOKEN');
// Paso 1: Generar un enlace de OAuth alojado para tu usuario
const authLink = await cuenta.cliente.create({
tipo: 'google', // o 'microsoft' o 'imap'
url_de_redireccionamiento: 'https://yourapp.com/callback'
});
// Redirige a tu usuario a authLink.url para completar el consentimiento de OAuth
// Paso 2: Enumerar los 50 correos electrónicos más recientes para una cuenta vinculada
const { elementos: correos } = await cliente.email.obtenerTodo({
account_id: 'ID_DE_CUENTA',
límite: 50
});
correos electrónicos.para cada uno(correo => {
consola.log(email.asunto, email.de_asistente.identificador);
});
// Paso 3: Enviar desde la dirección propia del usuario
await cliente.email.enviar({
account_id: 'ID_DE_CUENTA',
a: [{ identificador: 'lead@company.com', nombre_a_mostrar: 'Prospecto' }],
tema: 'En seguimiento a nuestra llamada',
body: 'Hola, solo quería saber cómo estabas.
'
});
// Paso 4: Registrar un webhook para eventos de correo electrónico nuevos en tiempo real
await client.webhook.create({
url: 'https://tuapp.com/webhooks/email',
eventos: ['email.recibido', 'correo electrónico enviado']
});import solicita
BASE = "https://api9.unipile.com:13234/api/v1"
TOKEN = "TU_TOKEN"
CABECERAS = {"Clave API X": TOKEN, "Tipo-Contenido": "application/json"}
# Paso 1: Crea un enlace de autenticación alojado para tu usuario
resp = requests.Correo electrónico:(f"{BASE}/hosted/accounts/link", json={
"tipo": "Google",
"url_redirección": "https://tuapp.com/callback"
}, encabezados=HEADERS)
auth_url = resp.json()["url"]
# Paso 2: Recuperar los 50 correos electrónicos más recientes
correos_electrónicos = requests.consiga(f"{BASE}/correos", parámetros={
"account_id": "ID_CUENTA",
"límite": 50
}, encabezados=ENCABEZADOS).json()["artículos"]
para email en correos electrónicos
print(correo electrónico"Asunto", correo electrónico["asistente_remitente"]["identificador"])
# Paso 3: Enviar desde la propia dirección del usuario
solicitudes.Correo electrónico:(f"{BASE}/correos", json={
"account_id": "ID_CUENTA",
"a": [{"identificador": "lead@company.com"}],
"Asunto": "Seguimiento",
"cuerpo": "Hola, solo quería saber cómo estabas.
"
}, encabezados=HEADERS)# Paso 1: Crear un enlace de autenticación alojado
rizo -X POST
"https://api9.unipile.com:13234/api/v1/hosted/accounts/link" \
-H "X-API-KEY: TU_TOKEN" \
-H "Content-Type: application/json" \
-d '{"type":"google","redirect_url":"https://yourapp.com/callback"}'
# Paso 2: Haz una lista de los 50 correos electrónicos más recientes
rizo -G
"https://api9.unipile.com:13234/api/v1/correos" \
-H "X-API-KEY: TU_TOKEN" \
--codificar-datos-url "id_cuenta=ID_CUENTA" \
--codificar-datos-url "límite=50"
# Paso 3: Enviar desde la propia dirección del usuario
rizo -X POST
"https://api9.unipile.com:13234/api/v1/correos" \
-H "X-API-KEY: TU_TOKEN" \
-H "Content-Type: application/json" \
-d '{"account_id":"ACCOUNT_ID","to":[{"identifier":"lead@company.com"}],"subject":"Seguimiento","body":"Hola...
"}'Unipile genera la URL de OAuth. Tu usuario hace clic, da su consentimiento y es redirigido de vuelta a tu aplicación. Tú nunca manejas tokens de OAuth directamente.
GET /correos electrónicos y POST /correos funciona idénticamente para Gmail, Outlook e IMAP. Cambia la account_id - todo lo demás permanece igual.
Registra una única URL. Unipile normaliza las notificaciones de Pub/Sub de Gmail, los eventos de cambio de Microsoft Graph y las señales IMAP IDLE en una única carga útil de evento unificada.
Preguntas frecuentes
Preguntas comunes de fundadores y ingenieros de SaaS que evalúan una API de correo electrónico para la sincronización de la bandeja de entrada del usuario.
ES 
EN 
FR 
DE 
IT 
BR 
NL 
PL 
TR