LinkedIn
Instagram
Telegrama
Calendario de Google
Únase a la comunidad SlackConectar y Sincronizar Outlook 365 Buzones por API
Integra potentes funciones de correo electrónico en tu aplicación con la API de correo electrónico de Outlook. Lee, envía, sincroniza y reacciona a correos electrónicos de Outlook y Microsoft 365 a través de una única interfaz REST respaldada por Microsoft Graph, sin tener que mantener los flujos de OAuth tú mismo.
const response = await fetch(
`https://${DSN}/api/v1/emails`,
{
cabeceras: {
'X-API-KEY': claveAPI,
'id_cuenta': outlookAccountId
}
}
);
const correos electrónicos = await respuesta.json();
// emails.items, arreglo de mensajes de Outlook
// funciona para Outlook, Gmail y IMAP
¿Qué es la API de correo electrónico de Outlook?
En API de correo electrónico de Outlook es una interfaz RESTful que brinda a los desarrolladores acceso programático a los datos del buzón de Outlook y Microsoft 365. Construido sobre Microsoft Graph, permite a tu aplicación leer, enviar, organizar y sincronizar correos electrónicos en cualquier cuenta de Outlook o Exchange Online, utilizando OAuth 2.0 para una autenticación segura delegada por el usuario. Los desarrolladores integran la API de correo electrónico de Outlook para crear clientes de correo electrónico, motores de sincronización de CRM, herramientas ATS y automatización de marketing sin exponer las credenciales del usuario.
¿Por qué integrar la API de correo electrónico de Outlook en tu aplicación?
Integrar la API de correo electrónico de Outlook en tu aplicación brinda a tus usuarios acceso directo al buzón de Microsoft 365 dentro de tu producto, sin necesidad de cambiar de pestaña ni de copiar y pegar manualmente. Aquí están las cuatro capacidades principales que los equipos desbloquean con mayor frecuencia.
API de Microsoft Outlook para su solución CRM
Sincronizar conversaciones de Outlook en embudos de ventas y registros de clientes
Sincronizar correo electrónico de Outlook con sistemas de seguimiento de candidatos
API de Microsoft Graph para plataformas de reclutamiento y software de RR. HH.
Outlook
Sincronizar la API de Outlook con Herramientas de Alcance
Potencia las plataformas de interacción de ventas multicanal con Microsoft Graph
Integrar la API de correo electrónico de Outlook en su software de prospección brinda a los equipos de ventas una única fuente de verdad para cada interacción con un prospecto. Las conversaciones se mantienen sincronizadas, los seguimientos se activan automáticamente y los datos de interacción se envían directamente a sus paneles.
Configuración de OAuth de Microsoft para la API de correo electrónico de Outlook
Documentación de Microsoft OAuthPor defecto, tu integración utiliza las credenciales OAuth de Unipile. Para obtener una experiencia totalmente marca blanca Cuando los usuarios finales conectan su buzón de Outlook o Microsoft 365, registra su propia aplicación en Microsoft Entra ID. Seguir la 7 pasos a continuación para crear el registro, configurar los permisos y conectarlo a la API de correo electrónico de Outlook en tu espacio de trabajo de Unipile.
Crear una cuenta de Microsoft Entra ID
Si aún no tienes uno, crea un Microsoft Entra ID cuenta (anteriormente Azure Active Directory). Este es el portal de administración donde registras la aplicación OAuth que impulsa tu integración con la API de correo de Outlook.
Registra una nueva aplicación en el portal de Azure
Iniciar sesión en portal.azure.com, abrir Microsoft Entra ID, y haz clic Nuevo registro.
- Ponle nombre a tu aplicación: este nombre aparece en la pantalla de consentimiento de OAuth de Microsoft que se muestra a sus usuarios finales.
- Tipos de cuenta admitidos: Selecciona "Cuentas en cualquier directorio organizativo (cualquier Microsoft Entra ID, multitenant) y cuentas personales de Microsoft" para poder conectar buzones de correo de Microsoft 365 para empresas y personales de Outlook.
Agregar URI de redirección
Abrir la Autenticación panel y clic Añadir URI en la sección Web. Agregar 2 URI de redireccionamiento usando tu DSN de Unipile (disponible en Cuadro de mandos de Unipile, esquina superior derecha):
https://{{YOUR_DSN_less_port}}/api/v1/hosted/microsoft_auth_request_callback/port{{YOUR_PORT}}
Configurar permisos de Microsoft Graph
Ir a Permisos de API > Agregar un permiso > Microsoft Graph, luego añade lo siguiente Permisos delegados para la API de correo electrónico de Outlook:
Para las funciones de calendario, agregue también Calendars.ReadWrite, Calendars.Read, Calendars.Read.Shared y Calendars.ReadWrite.Shared, luego habilítelas en la configuración de los ámbitos de su Panel de control de Unipile.
Crear un secreto de cliente
Abrir Certificados y secretos, haga clic Nuevo secreto del cliente. Dale una descripción al secreto y establece una fecha de expiración de 730 días (24 meses), luego haz clic en "Añadir".
Conecta tu aplicación al Dashboard de Unipile
Abrir la Cuadro de mandos de Unipile y navega a Configuración > Microsoft OAuth.
- Copia y pega el ID de la aplicación (cliente) de la página Resumen de Azure.
- Pega el valor secreto de la página Certificados y secretos.
- Clic Guardar.
Probar la conexión
Desde el Panel de Unipile, activa un nuevo enlace de cuenta de Microsoft para verificar que tus credenciales OAuth personalizadas funcionen de extremo a extremo. Deberías ver tu nombre de la aplicación y la marca dentro del aviso de consentimiento de Microsoft en lugar de los valores predeterminados de Unipile.
8
Conviértete en un editor verificado
Recomendado para producción - elimina la advertencia "no verificado" en la pantalla de consentimiento
Con la verificación del publicador, aparece una marca azul en el aviso de consentimiento de OAuth. Sin ella, las cuentas de Microsoft 365 empresariales pueden ver una advertencia de "publicador no verificado" que perjudica la conversión de registros.
Paso 1: únete a la Microsoft Partner Network
- Regístrate en partner.microsoft.com y elige el Programa de Socios de Microsoft AI Cloud.
- Si necesitas una cuenta de trabajo, Crear un nuevo inquilino primero.
Paso 2: verifica tu dominio
Crear un archivo llamado microsoft-identity-association.json y alojarlo en:
Paso 3: Vincule su ID de Cuenta Global de Socio (PGA)
- Encuentra tu ID de PGA a través de Centro de partners.
- En el Portal de Azure, ve a Registros de aplicaciones > Tu aplicación > Marca y propiedades, introduzca el ID de la PGA y guarde.
Para más detalles, consulta el Documentación de verificación de Microsoft Publisher.
9
Se requiere la aprobación del administrador"
Cuando los usuarios finales ven un bloque de consentimiento de su administrador de Microsoft 365
Si un usuario final ve "Se requiere la aprobación del administrador" al conectar su buzón de Outlook, el consentimiento requerido no se ha concedido a nivel de tenant. Dos caminos para resolverlo:
Método 1: solicitud de consentimiento del administrador dentro de Microsoft Entra
Un administrador de Microsoft 365 revisa y aprueba la solicitud de consentimiento de administrador pendiente. Ver el Documentación de Microsoft sobre la revisión de solicitudes de consentimiento de administrador.
Método 2: Inicio de sesión con OAuth como administrador con consentimiento en todo el tenant
- El administrador inicia el flujo de inicio de sesión OAuth desde tu aplicación.
- Durante la autorización de Microsoft, el administrador debe marcar "Consentimiento en nombre de su organización".
- Esto otorga consentimiento para todos los usuarios del tenant y evita solicitar la conexión a la API de correo electrónico de Outlook en el futuro.
Detalles completos en el Guía de solución de problemas de consentimiento de Microsoft.
Aumente la productividad con las funciones de la API de correo electrónico de Outlook
Mejora la productividad de tus usuarios aprovechando las funciones de la API de correo electrónico de Outlook, que permiten una gestión fluida del correo electrónico, flujos de trabajo automatizados y sincronización en tiempo real para que puedan centrarse en lo que realmente importa.
POST /api/v1/emails { "account_id": "acc_outlook_", "a": [{"identificador": "lead@acme.com"}], "Asunto": "Introducción rápida", "cuerpo": "Hola {{first_name}}..." }
Inbox
// Nuevo evento de correo electrónico entregado a tu endpoint { "evento": "correo.recibido", "account_id": "acc_outlook_", "id_correo": "em_8FdK2...", "de": "sarah@acme.com", "timestamp": "2026-05-18T09:42:11Z" }
Compara Outlook con Gmail e IMAP
| Característica |
Outlook |
Gmail |
IMAP |
|---|---|---|---|
| Conexión de cuentas | |||
| Autenticación alojada | |||
| Autenticación personalizada | |||
| OAuth | |||
| Credenciales | |||
| Enviar / Recibir | |||
| Enviar / Responder Correo electrónico | |||
| Lista de correos electrónicos | |||
| Crear Borrador de Correo Electrónico | |||
| Organice | |||
| Borrar correo electrónico | |||
| Mover correo electrónico | |||
| Lista de carpetas | |||
| Obtener carpeta | |||
| Webhooks | |||
| Nuevo correo electrónico | |||
| Seguimiento de aperturas y clics | |||
Crea tu integración de la API de correo electrónico de Outlook hoy mismo
Prueba gratuita incluida - no se requiere tarjeta de crédito. Vincula tu primera cuenta de Outlook en menos de 5 minutos.
Muestras de Código de la API de Correo Electrónico de Outlook: Node.js, Python y cURL
Los ejemplos a continuación llaman al endpoint unificado de la API de correo electrónico de Outlook de Unipile. Una clave de API, una URL base: funciona para Outlook, Gmail e IMAP sin cambiar su código. Reemplace TU_DSN y TU_CLAVE_API con los valores de tu Panel de Control de Unipile.
// Leer correos electrónicos de una cuenta de Outlook vinculada a través de la API de correo electrónico de Outlook de Unipile
const axios = require('axios');
const DSN = 'api1.unipile.com:13211';
const CLAVE_API = 'TU_CLAVE_API';
const ACC_ID = 'ID_DE_CUENTA_OUTLOOK'; // desde POST /cuentas después de OAuth
async function listarCorreosOutlook() {
const res = await axios.consiga(
`https://\${DSN}/api/v1/emails`,
{
cabeceras: {
'X-API-KEY': CLAVE_API,
'id_cuenta': ACC_ID
}
}
);
consola.log(res.data.items); // matriz de mensajes de Outlook
}
// Enviar un correo electrónico a través de la API de correo electrónico de Outlook
async function enviarCorreoOutlook() {
await axios.Correo electrónico:(
`https://\${DSN}/api/v1/emails`,
{
account_id: ACC_ID,
a: [{ nombre_mostrador: 'Alicia', identificador: 'alice@contoso.com' }],
tema: 'Hola desde la API de correo electrónico de Outlook',
cuerpo: 'Enviado a través de la API de correo electrónico de Unipile Outlook.
'
},
{ encabezados: { 'X-API-KEY': CLAVE_API } }
);
}#: Leer y enviar correos electrónicos a través de la API de correo electrónico de Unipile para Outlook
import solicita
DSN = "api1.unipile.com:13211"
CLAVE_API = "TU_CLAVE_API"
ACC_ID = "ID_DE_CUENTA_OUTLOOK"
ENCABEZADOS = {
"Clave API X": CLAVE_API,
"account_id": ACC_ID,
}
#: Lista de correos electrónicos de Outlook
def listar_correos():
r = solicitudes.consiga(
f"https://{DSN}/api/v1/correos",
cabeceras=ENCABEZADOS
)
r.lanzar_para_estado()
return r.json()["artículos"]
# Enviar a través de la API de correo electrónico de Outlook
def enviar_correo(dirección_destinatario, asunto, cuerpo):
r = solicitudes.Correo electrónico:(
f"https://{DSN}/api/v1/correos",
cabeceras={"Clave API X": API_KEY},
json={
"account_id": ACC_ID,
"a": [{"identificador": dirección_destino}],
"Asunto": asunto,
"cuerpo"cuerpo
}
)
r.lanzar_para_estado()
return r.json()#: Lista de correos electrónicos de la cuenta de Outlook vinculada
rizo -s -X GET \
"https://api1.unipile.com:13211/api/v1/correos" \
-H "X-API-KEY: TU_API_KEY" \
-H "id_cuenta: ID_DE_CUENTA_OUTLOOK" \
| jq '.items[] | {id, subject, from, date}'
#: Enviar correo electrónico a través de la API de correo electrónico de Outlook
rizo -s -X POST \
"https://api1.unipile.com:13211/api/v1/correos" \
-H "X-API-KEY: TU_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"account_id": "ID_DE_CUENTA_OUTLOOK",
"para": [{"identifier": "alice@contoso.com"}],
"asunto": "Hola desde la API de correo electrónico de Outlook",
"cuerpo"Enviado a través de Unipile.
"
}'Microsoft Graph nativa vs. API unificada de correo electrónico de Outlook (Unipile)
Descubra las claras ventajas de aprovechar la integración simplificada de la API de correo electrónico de Outlook de Unipile en comparación con la creación directa en Microsoft Graph. Utilice Hosted Auth para reforzar la seguridad a través de una gestión mejorada de credenciales, garantizar una integración fluida con Outlook y otras plataformas de correo electrónico, y reducir la sobrecarga del mantenimiento de flujos OAuth.
| Dimensión | API nativa de Microsoft Graph | API de correo electrónico de Outlook de Unipile |
|---|---|---|
| Alcance de la integración | Solo Outlook / Exchange Online | Outlook + Gmail + IMAP, mismo código |
| Configuración del flujo OAuth | Registro de aplicaciones de Azure + gestión de tokens por inquilino | Un enlace de autenticación alojado, página OAuth de marca blanca, cero código de token |
| Refresco de token | Tu código debe refrescarse cada 60 minutos (vida útil del token de acceso). | Unipile maneja las actualizaciones automáticamente para todas las cuentas vinculadas |
| Renovación de webhook | Las suscripciones caducan a los 4.230 minutos, debe renovarlas antes de que expiren | Unipile renueva automáticamente las suscripciones de Graph |
| Gestión de aceleración | Se debe implementar la lógica de reintento 429 y el retroceso exponencial manualmente | Reintento y gestión de límites de velocidad integrados |
| Tiempo de primer correo electrónico | 2-5 días (configuración Azure + OAuth + lógica de tokens + manejo de errores) | Menos de 2 horas (sigue esta guía) |
| Jubilación de Exchange Online | Se debe migrar de EWS a Graph antes de la fecha límite de octubre de 2026 | Unipile ya usa Graph, la migración es transparente |
| Ayuda | Documentación y foros de Microsoft | Soporte técnico en vivo + llamada bajo demanda con el fundador |
Autenticación alojada en un solo enlace vs. flujo OAuth completo
El Alojamiento de Autenticación de Unipile automatiza la detección de proveedores de correo electrónico y gestiona la autenticación. Esto reduce significativamente la complejidad de la configuración inicial, acelera los plazos de desarrollo y disminuye el mantenimiento. Guía de la API de correo electrónico de OAuth
Actualizaciones y mantenimiento constantes
Manténgase a la vanguardia con actualizaciones regulares y un mantenimiento diligente. La API de correo electrónico de Unipile para Outlook se mejora continuamente para rastrear los cambios en Microsoft Graph y ofrecer el máximo rendimiento, de modo que su integración funcione incluso cuando Microsoft actualiza su API. Guía de integración de MS Graph
Nuestro equipo de soporte lo guía a través de cada fase de la integración de la API de correo electrónico de Outlook, desde la iniciación hasta la posimplementación, sin costo adicional. API de correo electrónico para desarrolladores
Puntos comunes a evitar al programar con la API de correo electrónico de Outlook
La API de Microsoft Outlook es potente, pero tiene varias limitaciones no evidentes que pueden arruinar tu integración en producción. Estos son los 6 obstáculos más comunes y cómo evitarlos.
Seguridad y Cumplimiento para Integraciones de API de Correo Electrónico de Outlook
Garantiza la seguridad de tus datos con protocolos de seguridad avanzados. La API de correo electrónico Unipile Outlook garantiza que tus correos electrónicos e información sensible permanezcan protegidos, con certificación SOC 2 Tipo II y cumplimiento total de GDPR.
Preguntas frecuentes
Respuestas a las preguntas más comunes sobre la integración de la API de correo electrónico de Outlook, la API de Microsoft Outlook y la API de Outlook 365 con Unipile.
graph.microsoft.com/v1.0/me/messages, autenticado con un token de portador OAuth 2.0 de Azure AD. Unipile lo envuelve en una interfaz simple y agnóstica del proveedor que también funciona para Gmail e IMAP.Mail.ReadWrite, Mail.Enviar y Mail.Read permisos delegados, (3) implementar el flujo de código de autorización para obtener un token de acceso. Con Unipile, te saltas todo esto. Utiliza Hosted Auth para generar una página OAuth de un solo enlace para tus usuarios. Ver el completo Guía de la API de correo electrónico de OAuth y el Guía OAuth de Microsoft Graph.También le puede interesar
Recuperar correos electrónicos con la API de Unipile
Gestionar y recuperar correos electrónicos mediante programación es una habilidad fundamental. Ya sea para la automatización de negocios, atención al cliente, o con fines de marketing, la comprensión de cómo utilizar una API de correo electrónico para recuperar mensajes de correo electrónico puede agilizar las operaciones y mejorar la eficiencia. Esta guía le mostrará lo esencial...
Cómo obtener una API de correo electrónico para su software
Explore las ventajas de integrar una API, ya que representa una puerta de entrada para desbloquear numerosos beneficios en la incorporación sin problemas de múltiples servicios de correo electrónico en su aplicación.¿Qué es una API de correo electrónico?Una API de correo electrónico (interfaz de programación de aplicaciones) es un servicio que permite a los desarrolladores integrar...
Verificación de Google OAuth y Credenciales de la API de Gmail (2026)
Advertencia de aplicación no verificada de la API de Gmail La advertencia "Esta aplicación no está verificada", el límite de 100 usuarios y las exenciones Antes de que tu aplicación pase la verificación de la aplicación OAuth de Google, cada usuario que intente autorizarla verá una pantalla de advertencia. Google también aplica un límite estricto de 100 usuarios a las aplicaciones externas no verificadas. Aquí tienes...
ES 
EN 
FR 
DE 
IT 
BR 
NL 
PL 
TR