Sincronización con Google y Outlook Calendar
Conecta el calendario personal para sincronizar actividades CRM y eventos externos de acuerdo con una configuración elegida.
Que se logra
- Resultado: mantiene coordinada la agenda personal con las actividades CRM y permite consultar disponibilidad externa al planear trabajo.
- Caso de uso: una clínica asigna una llamada al asesor correcto consultando su disponibilidad y sincroniza los eventos futuros seleccionados.
- Se combina con: Crear y editar actividades, Invitados y enlace de reunión y Calendario de actividades.
Donde esta
- Ruta:
/[orgId]/my-profile/calendar-sync - Acceso en UI:
My Profile > Calendar Sync > Add Account - Componente(s):
CalendarSyncSettings.tsx,ConnectCalendarDialog.tsx,CalendarIntegrationCard.tsx,ActivityForm.tsx
Como funciona
- Abre
Calendar Syncy seleccionaAdd Account. - Elige
Google CalendaruOutlook Calendar. - Configura
Two-way sync,One-way syncoView only, visibilidad y tipos de actividad. - Completa la autorización con el proveedor.
- Administra conexiones activas, inactivas o con error desde la misma pantalla.
Campos y opciones
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
| Proveedor | selección | Sí | Google Calendar u Outlook Calendar. |
| Tipo de sincronización | selección | Sí | Bidireccional, unidireccional o solo vista. |
| Visibilidad | selección | Sí | Configura eventos externos y privados en CRM. |
| Tipos de actividad | selección múltiple | Sí | Define qué actividades CRM se sincronizan. |
| Al borrar evento externo | selección | Condicional | En Google bidireccional: completar, eliminar o no cambiar la actividad CRM. |
Reglas y validaciones
- Solo se sincronizan eventos futuros al conectar una cuenta.
- Una actividad pendiente solo se sincroniza si tiene responsable, integración activa y un tipo incluido en la configuración.
- Los fallos de sincronización no impiden guardar la actividad; se marca su estado de sincronización como fallido.
- Al desconectar se deja de sincronizar; una conexión inactiva se puede eliminar.
Backend
- Servicios:
organization-users-calendar-integrations,calendar-sync-processor,google-calendar-webhook,outlook-calendar-webhook,organization-users-calendar-integration-events(método: find/create/patch/remove) - Hooks relevantes solo si cambian el comportamiento visible: creación, edición, finalización y eliminación de actividades se propagan al calendario externo si aplica.
- Efectos: crea, actualiza, completa o elimina eventos externos y procesa cambios recibidos de Google u Outlook.
Relaciones
- Requiere: Perfil del usuario, miembro asignado y autorización OAuth del proveedor.
- Dispara / afecta: Actividades, invitados y enlaces de Google Meet.
Notas
View onlymuestra disponibilidad durante la creación sin sincronizar.