Configuración de Google Console
Antes de que el módulo Google Workspace pueda comunicarse con los servicios de Google, necesitas crear un proyecto de Google Cloud, habilitar las APIs requeridas y generar credenciales OAuth. Esta guía te lleva a través de cada paso.
Paso 1: Crear un Proyecto de Google Cloud
- Ve a la Google API Console.
- Haz clic en Select a project en la barra de navegación superior, luego haz clic en New Project.
- Ingresa un Nombre del Proyecto (por ejemplo, "Integración Concord CRM").
- Haz clic en Create y espera a que el proyecto sea aprovisionado.
- Asegúrate de que el nuevo proyecto esté seleccionado en el menú desplegable de proyectos.
Si ya tienes un proyecto de Google Cloud que deseas reutilizar, selecciónalo de la lista de proyectos en lugar de crear uno nuevo.
Paso 2: Habilitar las APIs Requeridas
Con tu proyecto seleccionado, habilita cada una de las siguientes APIs:
- Navega a APIs & Services → Library.
- Busca y habilita cada API individualmente:
- Google Drive API
- Google Docs API
- Google Sheets API
- Google Slides API
Para cada API:
- Haz clic en el nombre de la API en los resultados de búsqueda.
- Haz clic en Enable.
- Espera la confirmación antes de proceder a la siguiente.
Las cuatro APIs deben estar habilitadas para que el módulo funcione correctamente. Si falta alguna API, el servicio de Google correspondiente no será accesible desde el CRM.
Paso 3: Configurar la Pantalla de Consentimiento OAuth
- Navega a APIs & Services → OAuth consent screen.
- Selecciona el Tipo de Usuario:
- External -- Recomendado para la mayoría de las configuraciones. Permite que cualquier cuenta de Google autorice.
- Internal -- Solo disponible para cuentas de Google Workspace (de pago). Limita el acceso a usuarios dentro de tu organización.
- Haz clic en Create.
- Completa los campos requeridos:
- App Name -- Un nombre que los usuarios verán durante la autorización (por ejemplo, "Concord CRM").
- User Support Email -- Tu dirección de email de soporte.
- Developer Contact Information -- Tu dirección de email.
- Haz clic en Save and Continue a través de los pasos de Scopes y Test Users (no se necesitan cambios para la configuración básica).
- Haz clic en Back to Dashboard desde la pestaña de Resumen.
Estado de Publicación
| Estado | HTTPS Requerido | Notas |
|---|---|---|
| Testing | No | Limitado a 100 usuarios de prueba; muestra una advertencia de consentimiento adicional |
| Production | Sí | Disponible para todos los usuarios; tu sitio debe usar HTTPS |
Para la configuración y pruebas iniciales, mantén la app en modo Testing. Una vez que hayas verificado que todo funciona, cambia a Production para una experiencia de autorización fluida.
Paso 4: Crear Credenciales OAuth
- Navega a APIs & Services → Credentials.
- Haz clic en Create Credentials → OAuth client ID.
- Selecciona Web application como tipo de aplicación.
- Ingresa un Nombre para la credencial (por ejemplo, "Concord CRM OAuth").
- En Authorized redirect URIs, agrega lo siguiente:
https://yourdomain.com/google-workspace/callback
Reemplaza yourdomain.com con el dominio real donde está instalado tu Concord CRM.
- Haz clic en Create.
- Un diálogo mostrará tu Client ID y Client Secret. Copia ambos valores.
La URI de redirección debe coincidir exactamente con la URL de instalación de tu Concord CRM, incluyendo el protocolo (HTTPS) y la ruta. Una URI de redirección incorrecta causará que la autorización falle.
Paso 5: Conectar a Concord CRM
- Inicia sesión en tu Concord CRM como administrador.
- Navega a la configuración del módulo Google Workspace.
- Pega el Client ID y Client Secret del paso anterior.
- Haz clic en Save & Authorize.
- Aparecerá una pantalla de consentimiento de Google. Selecciona tu cuenta de Google y otorga los permisos solicitados.
- Serás redirigido de vuelta a Concord CRM. El estado de conexión debería mostrar Authorized.
Si tu app de Google Cloud está en modo Testing, verás una pantalla de advertencia adicional durante la autorización. Haz clic en Continue para proceder. Esta advertencia no aparece en modo Production.
Solución de Problemas
| Problema | Solución |
|---|---|
| "Error 400: redirect_uri_mismatch" | Verifica que la URI de redirección en Google Cloud coincida exactamente con la URL de tu CRM |
| La autorización falla silenciosamente | Asegúrate de que las cuatro APIs estén habilitadas en el proyecto de Google Cloud |
| "Access blocked: App not verified" | Cambia a modo Production o agrega tu cuenta como usuario de prueba |
| La conexión se pierde después de un tiempo | Vuelve a autorizar desde la configuración del módulo; verifica los ajustes de actualización de tokens |
Recomendaciones de Seguridad
- Restringe las credenciales OAuth a tu dominio específico usando URIs de redirección autorizadas.
- Usa HTTPS para tu instalación de Concord CRM para proteger los tokens OAuth en tránsito.
- Revisa el acceso a las APIs periódicamente en la Google Cloud Console para asegurar que no se otorguen permisos innecesarios.
- Rota las credenciales si sospechas que han sido comprometidas.
Si necesitas ayuda para configurar tu proyecto de Google Cloud, visita el Área de Tickets de Soporte de Themesic para obtener asistencia.