API de envío de correo electrónico: Enviar desde el usuario Gmail, Outlook y IMAP Cuentas
La mayoría de las API de correo electrónico envían desde un dominio compartido que posees. La API de envío de correo electrónico de Unipile es diferente: envía desde las cuentas de Gmail, Outlook e IMAP de tus usuarios, con OAuth2 completo, sin almacenamiento de credenciales y un único punto final unificado para cada proveedor. Cuando tu SaaS necesita enviar correo electrónico mediante programación en nombre de personas reales, esta es la integración que lo hace funcionar.
Una API para enviar correos electrónicos que actúa en nombre de sus usuarios
La mayoría de las búsquedas de "API para enviar correos electrónicos" conducen a proveedores transaccionales. Este no es el caso. Unipile es una API de correo electrónico de cuentas de usuario: se conecta a las cuentas reales de Gmail u Outlook de sus usuarios y envía en su nombre, con su identidad y su capacidad de entrega.
Por qué los desarrolladores crean aplicaciones con una API de correo electrónico de cuenta de usuario
Cuando su producto necesita enviar correos electrónicos programáticamente desde personas reales (no una dirección noreply@), estos son los escenarios que impulsan la adopción.
Envía correos electrónicos de seguimiento desde la cuenta de Gmail u Outlook de cada vendedor. Tasas de respuesta más altas, identidad de remitente auténtica, no se requiere calentamiento de dominio. Los prospectos ven un nombre real, no un alias genérico.
Permita que los agentes de soporte respondan directamente desde su propio buzón de correo. Los clientes ven el nombre y la dirección de correo electrónico de una persona real, no un alias de soporte@. Crea confianza, aumenta la velocidad de resolución.
Llega a los candidatos con correos electrónicos personalizados desde la cuenta real del reclutador. Sin dominios fríos, sin riesgo de filtro de spam, sin período de calentamiento. El correo electrónico llega a la bandeja de entrada como un mensaje personal, porque lo es.
Enviar correo electrónico desde Gmail, Outlook e IMAP: Una API
La API de envío de correo de Unipile abstrae completamente la capa del proveedor. Ya sea que la cuenta de su usuario sea Gmail, Outlook, Microsoft 365, Exchange Online o cualquier buzón compatible con IMAP, la llamada a la API es idéntica. Usted escribe la integración una vez y cada proveedor simplemente funciona.
gmail.enviarhuella mínima de permisos Mail.Enviardelegado o a nivel de aplicación Cómo enviar correo electrónico a través de una API: Integración paso a paso
Desde la vinculación de cuentas hasta el envío de su primer correo electrónico mediante programación, aquí tiene el flujo completo. Esta guía cubre Gmail y Outlook; los pasos para IMAP son idénticos, solo el tipo de cuenta varía.
Regístrate en el panel de Unipile. Cada espacio de trabajo recibe una clave API. Todas las solicitudes se autentican con la X-API-KEY header. No requiere configuración OAuth de tu parte: Unipile se encarga de la autenticación del proveedor por ti.
Genera un enlace de autenticación alojado a través de la API. El usuario hace clic en él y pasa por la pantalla de consentimiento estándar de OAuth2 para su proveedor. Unipile almacena los tokens de forma segura y devuelve un account_id. Nunca tocas credenciales.
"tipo":"MICROSOFT". Para IMAP, usa "tipo":"IMAP". El mismo flujo alojado maneja a los tres proveedores.Después de que el usuario completa OAuth2, Unipile dispara un webhook a tu endpoint con el account_id. Almacénala en tu base de datos: será la clave que usarás en cada llamada a la API de envío de correos para ese usuario.
PUBLICAR a /api/v1/emails con el account_id. El correo electrónico sale de la bandeja de entrada real de Gmail o Outlook del usuario, igual que si lo hubieran enviado ellos mismos. El punto final es idéntico independientemente de si la cuenta vinculada es Gmail, Outlook o IMAP.
"cc", "CCO", "responder_a"y "adjuntos" al mismo payload.¿Listo para enviar correos electrónicos desde Gmail, Outlook e IMAP?
Tu clave de API está esperando. Empieza a construir en menos de 10 minutos.
Un punto final unificado para enviar correos electrónicos a través de todos los proveedores
La mayor fricción en las integraciones de múltiples proveedores es mantener rutas de código separadas para cada servicio de correo electrónico. Unipile elimina eso. Ya sea que la cuenta vinculada sea Gmail, Outlook o IMAP, siempre llamas al mismo endpoint con la misma carga útil. La capa de abstracción maneja los protocolos específicos del proveedor, las actualizaciones de tokens y las diferencias en los límites de velocidad entre bastidores.
No hay rutas de código separadas para Gmail vs Outlook. Una integración cubre los tres proveedores hoy y cualquier adición futura que Unipile agregue.
Los tokens de acceso de OAuth2 caducan. Unipile los actualiza de forma transparente. Tu código nunca maneja el ciclo de vida de los tokens; solo llama a la API y envía.
Cada usuario vincula su propia cuenta. Usted gestiona un account_id por usuario; Unipile se encarga del resto. Sin malabarismos de SDK por proveedor.
La API devuelve la misma estructura JSON independientemente del proveedor. Analiza un esquema, crea un manejador de errores, envía más rápido.
¿Necesitas enviar correos electrónicos en nombre de tus usuarios a escala? Lee la guía completa sobre cómo enviar correos electrónicos en nombre de sus usuarios, incluido el modelo de cumplimiento y consentimiento que Unipile utiliza para mantener todo auditable.
Todos los puntos de conexión de la API para enviar correos electrónicos, organizados
Todos los puntos de conexión disponibles para conectar cuentas, enviar y responder, administrar tu buzón y escuchar eventos en Gmail, Outlook e IMAP con una única integración.
Enviar y responder
4 puntos finales disponibles
Configuración de cuenta
3 puntos finales disponibles
Gestionar correos electrónicos
5 puntos finales disponibles
Webhooks
2 eventos disponibles
Cubre flujos de autenticación, configuración de webhooks, lectura y envío de correos electrónicos, archivos adjuntos y una comparación completa de proveedores, todo lo que necesitas para crear una integración de API de envío de correos electrónicos lista para producción.
Autenticación y seguridad para la integración de tu API de envío de correo electrónico
Manejar las credenciales de correo electrónico de los usuarios es una de las partes de mayor riesgo de cualquier integración SaaS. La arquitectura de Unipile está diseñada para que nunca almacenes ni transmitas tokens OAuth2 directamente; la superficie de riesgo se mantiene mínima y el cumplimiento se mantiene manejable.
Unipile genera la URL de consentimiento OAuth2, recopila el código de autorización y almacena los tokens de acceso y actualización en su propia bóveda encriptada. Tu backend solo ve un account_id. Sin tokens crudos, sin contraseñas, sin deriva de credenciales.
Los tokens de Gmail OAuth2 expiran después de 1 hora. Los tokens de Microsoft expiran después de 1 hora (acceso) o 90 días (actualización). Unipile los actualiza automáticamente antes de que expiren. Tus llamadas a la API de envío de correos nunca fallan debido a un token obsoleto.
Para una integración de solo envío, Unipile solicita solo los ámbitos necesarios: gmail.enviar para Gmail y Mail.Enviar para Outlook. Esto sigue el principio de menor privilegio y reduce la superficie de ataque para los datos de sus usuarios.
Cada webhook que Unipile envía a tu endpoint incluye una cabecera de firma que puedes verificar contra tu secreto de webhook. Esto asegura que las cargas útiles de eventos no puedan ser falsificadas por terceros que intenten activar acciones en tu sistema.
La infraestructura de Unipile cuenta con la certificación SOC 2 Tipo II. Los controles auditados cubren la gestión de acceso, el cifrado en reposo y en tránsito, la respuesta a incidentes y la disponibilidad. Esto facilita la superación de las revisiones de seguridad de proveedores cuando sus clientes SaaS le preguntan cómo maneja las credenciales de correo electrónico.
Aprende sobre la API de correo electrónico seguroUnipile tiene una evaluación de Nivel 2 de CASA, el estándar de seguridad requerido por Google para aplicaciones que acceden a alcances sensibles de la API de Gmail. La evaluación es realizada por un laboratorio autorizado y cubre el manejo de datos, controles de acceso y prácticas de desarrollo seguro. Es requerido para mantener el acceso de producción a los alcances de envío de Gmail.
Cobertura total de la API de correo electrónico en todos los proveedores
Una integración te da acceso a todas las operaciones principales de correo electrónico a través de proveedores de Gmail, Outlook e IMAP. El mismo endpoint, la misma estructura de carga útil, el mismo formato de respuesta independientemente de la cuenta que tu usuario haya conectado.
| Característica | Gmail | Outlook / M365 | IMAP / SMTP |
|---|---|---|---|
| Enviando | |||
| Enviar correo electrónico desde la cuenta de usuario | ✓ | ✓ | ✓ |
| Enviar con archivos adjuntos | ✓ | ✓ | ✓ |
| Responder en el hilo existente | ✓ | ✓ | ✓ |
| Destinatarios CC y CCO | ✓ | ✓ | ✓ |
| Contenido del cuerpo HTML | ✓ | ✓ | ✓ |
| Imágenes en línea (incrustación CID) | ✓ | ✓ | ✓ |
| Límite diario de envío (aprox.) | ~500 / día | ~10.000 / día | Dependiente del servidor |
| Lectura y sincronización | |||
| Listar y leer correos electrónicos | ✓ | ✓ | ✓ |
| Vista de hilo / conversación | ✓ | ✓ | ✓ |
| Webhooks en tiempo real (correo nuevo, leído, enviado) | ✓ | ✓ | ✓ |
| Sincronización delta incremental | ✓ | ✓ | ✓ |
| Gestión de etiquetas y carpetas | ✓Etiquetas | ✓Carpetas | ✓Carpetas |
| Autenticación y Seguridad | |||
| OAuth2 (almacenamiento sin contraseña) | ✓ | ✓ | Contraseña de aplicación |
| Renovación automática de tokens | ✓ | ✓ | ✓ |
| SOC 2 Tipo II / CASA Nivel 2 | ✓ | ✓ | ✓ |
Errores comunes al integrar una API de envío de correos electrónicos
La mayoría de los problemas que encuentran los desarrolladores al integrar una API de envío de correos electrónicos de cuentas de usuario entran en un pequeño conjunto de categorías. Estas son las que vale la pena conocer antes de empezar a construir.
Las cuentas personales de Gmail están limitadas a aproximadamente 500 correos electrónicos por día. Las cuentas de Outlook tienen límites más altos pero aún pueden experimentar estrangulamiento en condiciones de ráfaga. Superar estos límites da como resultado errores 429 o la suspensión temporal de la cuenta por parte del proveedor.
Los usuarios pueden revocar el acceso en cualquier momento desde la configuración de su cuenta de Google o Microsoft. Cuando esto sucede, Unipile devolverá un error en la próxima llamada a la API para esa cuenta. Si su aplicación no maneja esto correctamente, resultará en fallos silenciosos en la entrega de correos electrónicos.
cuenta.desconectada evento de webhook y solicitar al usuario que vuelva a vincular su cuenta.Incluso con un token OAuth2 válido, enviar correos electrónicos desde la cuenta de un usuario sin su conocimiento viola las políticas de uso de Google y Microsoft y las leyes de spam de la mayoría de las jurisdicciones. La pantalla de consentimiento de OAuth2 debe explicar claramente lo que hará su aplicación.
Si almacena los tokens de acceso usted mismo y estos se exponen en una filtración de datos, un atacante tiene acceso completo a todas las cuentas de correo electrónico vinculadas. Este es un riesgo crítico de seguridad y cumplimiento, especialmente bajo el RGPD.
account_id; Unipile guarda los tokens en su bóveda certificada SOC 2. Tu base de datos nunca toca un token OAuth2 sin procesar.SMTP requiere acceso directo al servidor, gestión de credenciales, configuración TLS y manejo de rebotes. Una API REST para enviar correos abstrae todo eso. Combinar ambos enfoques en la misma base de código agrega complejidad sin beneficio.
Preguntas frecuentes
Todo lo que necesitas saber sobre la API para enviar correos electrónicos.
account_id vía webhook. Luego haces POST a /api/v1/emails con ese account_id y el payload de tu mensaje. El correo se envía desde su dirección real de Gmail. No se requiere configuración de clave de API de Gmail de tu parte.Mail.Enviar permiso delegado. Unipile maneja el refresco de tokens automáticamente.https://www.googleapis.com/auth/gmail.send. Esto permite enviar correos electrónicos pero no otorga acceso para leer, modificar o eliminar mensajes. Al usar Unipile, no configuras este alcance tú mismo; el flujo de autenticación alojado se encarga de ello. Para un caso de uso de API de envío de correo electrónico puro, gmail.enviar es suficiente.POST /api/v1/correos el endpoint maneja cuentas de Gmail, Outlook y IMAP. El proveedor se determina por el account_id en la carga útil; no es necesario especificarlo. Escriba su lógica de envío una vez y funcionará independientemente del proveedor de correo electrónico que su usuario haya vinculado.¿Aún tiene preguntas? Nuestro equipo está aquí para ayudarle.
Conecta tu primera cuenta de Gmail, Outlook o IMAP y envía tu primer correo electrónico de forma programática en menos de 30 minutos. Sin almacenamiento de credenciales, sin configuración de OAuth2 de tu lado, sin SDK por proveedor. Un account_id, un endpoint REST, todos los proveedores.