Credenciales de Google y Sincronización
Sustituido en la v7.15+: esta función de Sincronización con Google Calendar ha sido completamente sustituida por el nuevo framework de Sincronización de Calendario en SuiteCRM 7.15 y versiones posteriores. Si está actualizando desde una versión anterior, su configuración se migrará automáticamente. Esta documentación se conserva únicamente como referencia para los usuarios de las versiones 7.11-7.14.
Esta mejora se encuentra en fase Beta; ¡ayúdenos aportando sus comentarios! Solo está disponible en las versiones 7.11 y posteriores de SuiteCRM.
Descripción General
SuiteCRM tiene la capacidad de sincronizar las reuniones de un usuario con su Google Calendar. Se trata de una sincronización bidireccional, y los cambios realizados en cualquiera de los dos extremos de la sincronización provocan actualizaciones en el otro.
No existe ningún intermediario en este proceso. Sus datos no pasan por terceros. Solo intervienen su instancia de SuiteCRM y los servidores de Google.
Requisitos
Credenciales de API válidas
Para sincronizar las reuniones de SuiteCRM de un usuario con su Google Calendar, el sistema debe tener credenciales válidas guardadas.
Estas credenciales se crean en la Consola de Desarrolladores de Google, se descargan como un archivo JSON y se importan a SuiteCRM. Más adelante en esta página encontrará instrucciones sobre cómo hacerlo.
Acceso a Internet desde el servidor de SuiteCRM
El servidor de SuiteCRM también debe tener acceso a internet. Sin embargo, el servidor de SuiteCRM no necesita ser accesible públicamente. El usuario debe poder acceder tanto a Google como a SuiteCRM al mismo tiempo para autorizar el acceso al calendario. Una vez hecho esto, el proceso de sincronización se ejecuta según una programación sin necesidad de interacción del usuario. El usuario no necesita tener la sesión iniciada en SuiteCRM para que la sincronización funcione.
Al menos una cuenta de Google
Necesitará una cuenta de Google para crear las credenciales de API, y una cuenta con la que sincronizar. Pueden ser la misma cuenta si solo tiene un usuario. Las credenciales de API solo necesitan generarse una vez, desde una única cuenta. Estas credenciales pueden utilizarse para sincronizar a todos los usuarios una vez que autoricen el acceso a su cuenta. Estas cuentas pueden ser cuentas genéricas de @gmail.com, o cuentas de GSuite de cualquier nivel (Basic/Business/Enterprise).
Generación e Instalación de Credenciales de Google
Generación de Credenciales
Asegúrese de haber iniciado sesión en una cuenta de Google antes de continuar.
Vaya a Google Developers Console
Haga clic en el desplegable de la parte superior de la pantalla. |
|
Haga clic en el botón 'New Project'. |
|
Asigne al proyecto un nombre descriptivo, como 'SuiteCRM Google Sync', y haga clic en 'Create'. |
|
En la parte superior de la página, haga clic en el desplegable 'Select a project'… |
|
…y a continuación haga clic en el proyecto que acaba de crear. |
|
Ahora verá el proyecto en el desplegable, y un aviso de que no hay ninguna API habilitada. Haga clic en el enlace 'Library' del aviso. |
|
En la ventana de búsqueda, escriba "Calendar" y, a continuación, haga clic en el resultado 'Google Calendar API'. |
|
Haga clic en el botón 'Enable'. |
|
Ahora que hemos habilitado la API, creamos las credenciales. Haga clic en el botón 'Create credentials'. |
|
Configure las opciones de la sección 1 tal como se muestra. Haga clic en '¿Qué credenciales necesito?' para continuar. |
|
En la Sección 2, asígnele un nombre descriptivo. Deje 'JavaScript origins' en blanco. Tenga en cuenta que esta no necesita ser una URL pública. Solo necesita ser accesible para el usuario que habilita la sincronización del calendario. Se recomienda encarecidamente contar con un sitio con https habilitado para producción en un entorno de acceso público. |
|
De nuevo, cree un nombre descriptivo. Hay más opciones disponibles en 'More customization options', pero no son necesarias para que esto funcione. A continuación, haga clic en 'Continue'. |
|
Haga clic en el botón 'Download'. Guarde el archivo .json. Lo utilizaremos más adelante en SuiteCRM. Haga clic en 'Done' cuando termine. Esto es todo lo que necesitamos para que todos nuestros usuarios puedan sincronizar sus calendarios. |
|
Instalación de Credenciales
Inicie sesión en SuiteCRM como usuario administrador.
Vaya a 'Administration'.
A continuación, desplácese hasta la sección 'Google Suite'.
Haga clic en el elemento 'Google Calendar Settings'.
Observe que indica 'Unconfigured'. Esto significa que actualmente no hay ningún archivo JSON instalado. |
|
Esto le devolverá al menú 'Administration'. Vuelva a entrar en 'Google Calendar Settings'. |
|
Si en algún momento necesita instalar credenciales nuevas, simplemente súbalas. Sobrescribirán las anteriores.
Autorización del Acceso al Calendario
Esto debe realizarlo el usuario para habilitar la sincronización con su Google Calendar
Haga clic en el desplegable de su nombre en la parte superior derecha del sitio de SuiteCRM, y luego en 'Profile'. |
|
Vaya a la pestaña 'Advanced'. |
|
Debería ver el subencabezado 'Google Account Synchronization' en la parte inferior. Si no aparece, es que el servidor de SuiteCRM no tiene instaladas las Credenciales de Google. |
|
Si tiene la sesión iniciada en varias cuentas de Google, se le preguntará con qué cuenta de Google desea sincronizar. En caso contrario, se le llevará directamente a este cuadro de diálogo: |
|
Una vez que haga clic en 'Allow', volverá a la página de perfil del usuario. Haga clic de nuevo en la pestaña 'Advanced', y debería ver lo siguiente: |
|
Marque la casilla 'Enable Calendar Sync' y, a continuación, haga clic en el botón 'Save'.
¡Eso es todo! Por defecto, la sincronización se produce cada cuarto de hora. El Administrador puede cambiar esto en la configuración del Scheduler.
Problemas Conocidos
Si se modifica el valor de "google_calendar_sync_name", esto provocará que TODAS las reuniones se resincronicen. Esto se debe a que, si el valor cambia, Google detecta todas las reuniones existentes como elementos de calendario nuevos y únicos.
La mejor manera de evitar que esto ocurra es no editar/modificar el valor "google_calendar_sync_name" que se encuentra en su archivo config.php.
Deshabilitar la Sincronización con Google Calendar
Si desea deshabilitar por completo la sincronización con Google Calendar o volver a añadir su token desde cero, realice las siguientes acciones:
Deshabilite las tareas 'Google Sync Calendars' desde Admin/Scheduler. |
|
Elimine la línea del token de Google Cloud en |
|
Para restablecer la autorización de Google, el usuario puede restablecer su configuración personal. Puede resultar innecesario si el token ya se ha eliminado de la configuración de administración y la tarea del scheduler no está activa.