Microsoft Outlook

Automatiza correos, eventos de calendario y programación inteligente con Microsoft Outlook.

La integración de Microsoft Outlook te permite gestionar completamente tu comunicación y agenda dentro de Dapta. Combina la automatización de Correo Electrónico con una gestión avanzada de Calendario, incluyendo la operación inteligente Get Availability para programación automatizada.

🚀 Capacidades Clave

📧 Correo Electrónico (Email)

Enviar Correos: Automatiza el envío de correos HTML enriquecidos a múltiples destinatarios.
Gestión de Adjuntos: (Próximamente) Manejo automático de archivos adjuntos.

📅 Calendario

Programación Inteligente: Localiza espacios libres basándose en tu horario laboral usando la operación Get Availability.
Gestionar Eventos: Crea, actualiza, lista y elimina reuniones sin esfuerzo.
Zona Horaria Inteligente: Maneja automáticamente conversiones complejas de zona horaria global.
Reuniones Online: Genera enlaces de Microsoft Teams con un solo interruptor.

⚙️ Requisitos Previos

Para usar esta integración, necesitas:

Una cuenta de Microsoft 365 (Business o Personal).
Opcional: Un Buzón de Outlook activo (solo requerido si planeas usar las operaciones de Enviar Correo).

🔐 Autenticación

Dapta utiliza autenticación segura OAuth 2.0 para conectarse a tu cuenta de Microsoft. Nunca vemos ni almacenamos tu contraseña.

Permisos Requeridos

Al conectar, se te pedirá conceder los siguientes permisos:

Calendars.ReadWrite: Para gestionar tus eventos y verificar disponibilidad.
Mail.Send: Para enviar correos automatizados en tu nombre.
User.Read: Para identificar tu perfil y configuración de zona horaria.

Pasos de Conexión

Opción 1: Conexión Rápida (Recomendada)

Añade el nodo de Microsoft Outlook a tu lienzo de flujo.
Ubica el desplegable Credential en el panel de configuración.
Haz clic en el botón + (Más) junto al desplegable.
Sigue los pasos de inicio de sesión de Microsoft para autorizar el acceso.
Tu credencial se guardará y seleccionará automáticamente.

Opción 2: Menú de Configuración

Navega a la Página de Credenciales en tu panel de Dapta.
Haz clic en Add Credential y selecciona Microsoft Outlook.
Haz clic en Connect e inicia sesión con tu cuenta de Microsoft 365.
Revisa los permisos solicitados y haz clic en Yes/Accept.

🛠️ Operaciones de Calendario

1. Get Availability

Esta función escanea tu calendario y devuelve una lista de espacios "libres", respetando estrictamente tu horario laboral y reuniones existentes.

Parámetros

Calendar ID (Texto, Opcional) El ID del calendario a revisar. Por defecto usa tu calendario principal.
From Date (Fecha, Requerido) Fecha de inicio de la búsqueda (Formato: YYYY-MM-DD, ej. 2024-01-01).
To Date (Fecha, Requerido) Fecha de fin de la búsqueda (Formato: YYYY-MM-DD).
Start Time (Texto, Opcional) Hora de inicio de jornada laboral (ej. 09:00). Por defecto: 08:00.
End Time (Texto, Opcional) Hora de fin de jornada laboral (ej. 17:00).
Slot Duration (Número, Opcional) Duración de cada espacio en minutos (ej. 30).
Buffer Time (Número, Opcional) Minutos de margen para dejar libres entre reuniones (ej. 15).
Exclude Weekends (Booleano, Opcional) Si es true, los sábados y domingos se excluyen de la disponibilidad.
Timezone (Texto, Opcional) La zona horaria para el cálculo (ej. America/New_York).

Ejemplo de Respuesta

{
  "success": true,
  "date_range": { "from": "2024-01-01", "to": "2024-01-02" },
  "slots": {
    "2024-01-01": [
      { "start": "09:00", "end": "09:30" },
      { "start": "09:30", "end": "10:00" }
    ]
  },
  "summary": { "total_slots": 5, "first_available": "2024-01-01T09:00:00" }
}

2. List Calendars

Recupera una lista de todos los calendarios asociados a tu cuenta.

Ejemplo de Respuesta

{
  "value": [
    {
      "id": "AAMkAGI...",
      "name": "Calendar",
      "color": "auto",
      "changeKey": "..."
    }
  ]
}

3. Get Calendar

Recupera información detallada sobre un calendario específico.

Parámetros

Calendar ID (Texto, Requerido) El identificador único del calendario.

Ejemplo de Respuesta

{
  "success": true,
  "calendar": {
    "id": "AAMkAGI...",
    "name": "Trabajo",
    "canEdit": true
  }
}

4. List Events

Busca reuniones próximas dentro de un rango de fechas específico.

Parámetros

From Date (Fecha, Requerido) Inicio del rango de fechas.
To Date (Fecha, Requerido) Fin del rango de fechas.
Timezone (Texto, Opcional) Si se proporciona, convierte todas las horas de eventos a esta zona en la salida.

Ejemplo de Respuesta

{
  "success": true,
  "events": [
    {
      "id": "AAMkAGI...",
      "subject": "Sincronización de Equipo",
      "start": { "dateTime": "2024-01-01T10:00:00", "timeZone": "UTC" },
      "end": { "dateTime": "2024-01-01T11:00:00", "timeZone": "UTC" }
    }
  ]
}

5. Get Event

Recupera detalles de un solo evento usando su ID.

Parámetros

Event ID (Texto, Requerido) El identificador único del evento.

Ejemplo de Respuesta

{
  "success": true,
  "event": {
    "id": "AAMkAGI...",
    "subject": "Almuerzo",
    "location": { "displayName": "Cafetería" }
  }
}

6. Create Event

Programa una nueva reunión en tu calendario.

Parámetros

Title (Texto, Requerido) El asunto del evento.
Start Date/Time (Fecha, Requerido) Cuándo inicia el evento. Debe estar en formato ISO 8601 (ej. 2024-12-31T14:30:00).
End Date/Time (Fecha, Requerido) Cuándo termina el evento. Debe estar en formato ISO 8601 (ej. 2024-12-31T15:30:00).
Attendees (Lista, Opcional) Correos electrónicos separados por coma (ej. [email protected], [email protected]).
Online Meeting (Booleano, Opcional) Si es true, añade automáticamente un enlace de Microsoft Teams al evento.
Description (Texto, Opcional) Detalles o agenda para el cuerpo del evento.
Location (Texto, Opcional) Ubicación física o nombre de sala.
Reminder Minutes (Número, Opcional) Minutos antes del evento para mostrar una notificación.
Timezone (Texto, Opcional) Zona horaria específica para las horas de inicio/fin proporcionadas.

Ejemplo de Respuesta

{
  "success": true,
  "event": {
    "id": "AAMkAGI...",
    "subject": "Lanzamiento de Proyecto",
    "webLink": "https://outlook.office365.com/..."
  }
}

7. Update Event

Modifica detalles de un evento existente.

Parámetros

Event ID (Texto, Requerido) El identificador único del evento a actualizar.
Title (Texto, Opcional) Nuevo asunto para el evento.
Start Date/Time (Fecha, Opcional) Nueva hora de inicio (ISO 8601).
End Date/Time (Fecha, Opcional) Nueva hora de fin (ISO 8601).
Description (Texto, Opcional) Nueva descripción.
Location (Texto, Opcional) Nueva ubicación.

8. Delete Event

Elimina un evento del calendario.

Parámetros

Event ID (Texto, Requerido) El identificador único del evento a eliminar.

Ejemplo de Respuesta

{
  "success": true,
  "message": "Event deleted successfully",
  "event_id": "AAMkAGI..."
}

📧 Operaciones de Email

9. Send Email

Envía correos automatizados directamente desde tu cuenta de Outlook.

Parámetros

To (Lista, Requerido) Destinatarios (separados por coma).
Subject (Texto, Requerido) Asunto del correo.
Body Format (Selección, Requerido) Elige entre Text o HTML.
Body / HTML (Texto, Requerido) El contenido del mensaje.
CC / BCC (Lista, Opcional) Copias opcionales.

Ejemplo de Respuesta

{
  "success": true,
  "message": "Email sent successfully"
}

🚧 Límites de Uso y Cuotas

Microsoft impone límites de uso en la API para prevenir abusos.

Envío de Correos: Los límites varían según el tipo de cuenta (ej. ~10,000 destinatarios/día para cuentas Business).
Límites de Velocidad: Solicitudes excesivas en poco tiempo pueden resultar en 429 Too Many Requests.
Consejo: Si estás enviando correos en un bucle, añade un nodo Wait (Espera) de 1-2 segundos dentro del bucle para asegurar una entrega fluida.

❓ Solución de Problemas

Problema

Causa

Solución

"Invalid Timezone"

Error tipográfico

Usa nombres IANA estándar como America/Bogota o Europe/Madrid.

"Time Range Too Big"

Límite de API

Mantén el rango de List Events bajo 31 días para mejor rendimiento.

"Access Denied"

Permisos

Reconecta tu credencial y asegúrate de aceptar todos los permisos solicitados.

Horas incorrectas

UTC vs Local

Revisa el parámetro Timezone. Si está vacío, Dapta suele usar UTC por defecto.

AnteriorMicrosoft Excel SiguienteHubSpot

Última actualización hace 2 meses

hashtag🚀 Capacidades Clave

hashtag📧 Correo Electrónico (Email)

hashtag📅 Calendario

hashtag⚙️ Requisitos Previos

hashtag🔐 Autenticación

hashtagPermisos Requeridos

hashtagPasos de Conexión

hashtag🛠️ Operaciones de Calendario

hashtag1. Get Availability

hashtag2. List Calendars

hashtag3. Get Calendar

hashtag4. List Events

hashtag5. Get Event

hashtag6. Create Event

hashtag7. Update Event

hashtag8. Delete Event

hashtag📧 Operaciones de Email

hashtag9. Send Email

hashtag🚧 Límites de Uso y Cuotas

hashtag❓ Solución de Problemas

🚀 Capacidades Clave

📧 Correo Electrónico (Email)

📅 Calendario

⚙️ Requisitos Previos

🔐 Autenticación

Permisos Requeridos

Pasos de Conexión

🛠️ Operaciones de Calendario

1. Get Availability

2. List Calendars

3. Get Calendar

4. List Events

5. Get Event

6. Create Event

7. Update Event

8. Delete Event

📧 Operaciones de Email

9. Send Email

🚧 Límites de Uso y Cuotas

❓ Solución de Problemas