title: "Adendum 16 — Office 365 — Integración con Word + Excel" date: "2026-09-01" author: "GoWeBa Platform Team" tags: ["office365", "word", "excel", "microsoft", "graph-api", "productivity"]
Adendum 16 — Office 365 — Integración con Word + Excel
Descripción general
GoWeBa ahora integra Microsoft Word y Microsoft Excel directamente en tu plataforma. Crea, edita y gestiona tus documentos de Office desde tu CRM — sin salir de GoWeBa.
Modelo de Reventa CSP: GoWeBa proporciona licencias de Microsoft 365 a través de su programa Cloud Solution Provider (CSP), con facturación unificada integrada en tus planes de suscripción.
Arquitectura
GoWeBa User
│
▼ (OAuth2 Authorization Code)
┌──────────────────┐
│ M365 Connection │ ← /api/v1/office365/connect
└────────┬─────────┘
│
▼
┌──────────────────┐
│ Microsoft Graph │ ← Microsoft REST API
│ API │
└────────┬─────────┘
│
▼
┌──────────────────┐
│ OneDrive / SPO │ ← File Storage
└──────────────────┘
Funcionalidades de Word
Operaciones disponibles
| Endpoint | Descripción |
|---|---|
POST /word/create | Crear un nuevo documento de Word |
GET /word/list | Listar todos los documentos de Word |
GET /word/:fileId/content | Descargar el contenido del documento |
PUT /word/:fileId/content | Actualizar el contenido del documento |
DELETE /word/:fileId | Eliminar un documento |
POST /word/:fileId/convert-pdf | Convertir Word a PDF |
Casos de uso
- Cotizaciones y propuestas — Genera un documento de Word prellenado con los datos del negocio
- Contratos — Crea y edita contratos vinculados a tus contactos
- Reportes — Exporta los datos de tu CRM a un documento de Word con formato
- Conversión a PDF — Transforma tus documentos a PDF al instante para su entrega
Funcionalidades de Excel
Operaciones disponibles
| Endpoint | Descripción |
|---|---|
POST /excel/create | Crear un nuevo libro de Excel |
GET /excel/list | Listar todos los libros de Excel |
GET /excel/:fileId/worksheets | Listar hojas de cálculo en un libro |
GET /excel/:fileId/worksheets/:sheetName/range | Leer un rango de celdas |
PATCH /excel/:fileId/worksheets/:sheetName/range | Escribir en un rango de celdas |
DELETE /excel/:fileId | Eliminar un libro |
Casos de uso
- Dashboards — Exporta tus KPIs a un archivo de Excel compartible
- Importación/Exportación de datos — Sincroniza tus contactos y negocios con Excel
- Presupuestos — Gestiona tus presupuestos directamente desde la plataforma
- Analítica — Crea hojas de cálculo con los datos de tu pipeline
Conexión y autenticación
Flujo OAuth2
- El usuario hace clic en "Connect Office 365" en GoWeBa
- Redirección a la página de inicio de sesión de Microsoft
- El usuario autoriza el acceso a sus archivos
- Redirección automática de regreso a GoWeBa con tokens seguros
- Los tokens se cifran en reposo (AES-256) en la base de datos
Seguridad
- Autenticación delegada: cada usuario conecta su propia cuenta de Microsoft
- Tokens cifrados: access_token y refresh_token almacenados con cifrado AES-256
- Renovación automática: los tokens vencidos se renuevan de forma transparente
- Revocación: desconéctate en cualquier momento a través de
/api/v1/office365/disconnect
Seguimiento de archivos
Archivos rastreados
GoWeBa mantiene un registro de los archivos vinculados a tu organización:
| Endpoint | Descripción |
|---|---|
GET /tracked-files | Listar archivos rastreados |
POST /tracked-files/:fileId/track | Rastrear un archivo |
DELETE /tracked-files/:fileId/untrack | Dejar de rastrear un archivo |
Esto crea un vínculo bidireccional entre tus documentos de Office y las entidades del CRM (contactos, negocios, organizaciones).
Requisitos previos en Azure
Nota para administradores: el registro de la aplicación en Azure AD debe tener habilitados los siguientes permisos de Microsoft Graph:
Files.ReadWrite(delegado)User.Read(delegado)Los usuarios deben contar con una licencia de Microsoft 365 Business Basic (o superior) para acceder a OneDrive for Business.
Próximos pasos
- Plantillas de Word preconfiguradas para cotizaciones y contratos
- Sincronización automática Excel ↔ Pipeline del CRM
- Colaboración en tiempo real en documentos compartidos