Integración de Google Workspace para el Sistema Telefónico 3CX

Introducción

3CX puede integrarse con Google para proporcionar las siguientes funcionalidades:

• Sincronizar Cuentas de Usuario desde Google Workspace.
• Sincronizar los contactos personales del Usuario con la agenda personal 3CX (un solo sentido).
• El estado del Perfil 3CX es cambiado basado en eventos del Calendario de Google. Por ejemplo, si usted está en una reunión su estado será puesto como ocupado.
• Crear y usar Google Buckets para Almacenamiento Remoto del Sistema Telefónico 3CX.
• Utilizar Google Speech para transcribir grabaciones y buzones de voz.
• Utilizar las cuentas de Google Workspace para enviar correos electrónicos.
• Habilitar Google SSO para permitir a los usuarios iniciar sesión en el Cliente Web utilizando sus credenciales de Google (debe configurarse por separado en el Proyecto Google creado).
• Habilitar Google ReCaptcha para protegerse de ataques automatizados y abusos.

Configuración de la Integración de Google

Paso 1: Rol de Superadministrador en Workspace

Para que la integración funcione, el usuario que inicie sesión debe tener el Rol de Súper Administrador en Workspace. Siga los pasos que se indican a continuación para otorgar el Rol de Superadministrador al usuario que utilizará para autenticar la Integración de Google en su PBX.

1. Inicie sesión en https://admin.google.com/.
2. Vaya a Directorio > Usuarios.

3. Edite el Usuario que desea elevar a Superadministrador y abra la sección funciones y privilegios de Admin.
4. Habilite el Rol de Superadministrador para el usuario que utilizará para autenticar la Integración de Google y haga clic en Guardar.

Paso 2: Roles a Nivel de Organización en la Consola de Google

Adicionalmente, en caso de que planee habilitar las siguientes funciones, necesita otorgar el rol de Administrador de Cuentas de Facturación IAM a su usuario en la Consola de Google.

• Usar Google Cloud para Almacenamiento Remoto del Sistema Telefónico 3CX.
• Utiliza la Transcripción para grabaciones y buzones de voz.

Para hacerlo, siga estos pasos:

1. Inicie sesión en https://console.cloud.google.com.
2. Asegúrese de que está operando a nivel de Organización. Puede seleccionar la organización haciendo clic en el menú desplegable de la parte superior de la página.
3. En el menú de navegación de la izquierda, vaya a IAM & Admin > IAM.
4. Haga clic en Permitir Acceso.
5. En el panel derecho abierto > Campo de Nuevos Directores agregue la dirección de correo electrónico del usuario que se autentica en la integración de Google.
6. En Asignar Roles, Agregue el rol Administrador de Cuentas de Facturación como se muestra en la captura de pantalla.
7. Guarde.

Paso 3: Desactivación de la Ejecución de la Creación de Claves de Cuenta de Servicio - Si Procede

Dependiendo de la fecha de creación de su cuenta de Google, es posible que la política de organización ‘disableServiceAccountKeyCreation’ se aplique de forma predeterminada y prohíba la Creación de Claves para su cuenta.

En este caso, es posible que aparezca un error indicando que no se permite la creación de claves durante la integración de Google con su PBX.

Para solucionar este problema, es posible que deba detener la aplicación de esta política mediante los pasos que se indican a continuación:

Nota: Para administrar las Políticas de Organización en su cuenta de Google, debe acceder a la Consola de Google con un usuario que tenga el rol de Administrador de Políticas de Organización.

1. En la Consola de Google, vaya a IAM y Admin > Políticas de la Organización.
2. Busque iam.disableServiceAccountKeyCreation si utiliza la versión anterior de la restricción o iam.managed.disableServiceAccountKeyCreation si utiliza la nueva versión de la restricción.
3. Abra Desactivar creación de clave de cuenta de servicio y haga clic en Administrar Política.
4. En Origen de la Política seleccione Anular la política principal.
5. En Reglas agregue una regla con Cumplimiento = Desactivado.
6. Haga clic en Establecer Política.

Paso 4: Integrar el PBX con Google

1. En su Consola de Administración, vaya a Integraciones > Google y haga clic en Configurar.

2. Accederá a la siguiente página de integración. Seleccione todas las funciones que desee utilizar y haga clic en Conectar.

3. Cuando se le solicite que acceda a su Cuenta de Google, identifíquese utilizando el usuario al que ha asignado todas las funciones y permisos relevantes en los pasos anteriores.
4. Si se le pregunta, seleccione Todos para permitir a 3CX acceder a los recursos requeridos y haga clic en Continuar.

5. Durante el proceso de autenticación (Sólo si es la primera vez que inicia sesión con un nuevo usuario), en caso de que reciba el mensaje sobre la aceptación de las condiciones del servicio, siga estos pasos. Si no recibe este mensaje, puede saltar al punto 9 a continuación.

6. Vaya a https://console.developers.google.com/terms/appsadmin.
7. Debería haber recibido una solicitud de aceptación de las condiciones del servicio.

8. Haga clic en Aceptar y repita el proceso de autenticación en el paso 4.2 anterior.
9. Una vez completada la autenticación, aparecerá la siguiente página.

10. Copie el ID de Cliente generado y haga clic en el enlace para Abrir la Delegación en Todo el Dominio en el Panel de Administración.
11. Haga clic en Agregar Nuevo en Clientes API, proporcione el ID de Cliente que copió anteriormente y rellene todos los valores de los alcances OAuth listados en la pantalla anterior (cópielos directamente de la página).
12. Una vez hecho esto, haga clic en Autorizar.

13. Haga clic en el Botón Atrás en la pantalla anterior y será redirigido a la Consola de Administración del PBX donde la integración de Google Workspace se mostrará como configurada proporcionándole el ID de Proyecto generado en el proceso anterior.

Activación de la Sincronización

Luego de finalizar la Integración de Google con el PBX se puede continuar con la sincronización de los usuarios desde Google a 3CX:

1. En la Consola de Administración 3CX, vaya a Usuarios y haga clic en Google.
2. Habilite Sincronizar Usuarios de Google para sincronizar usuarios de Google a 3CX. La sincronización es unidireccional (de Google a 3CX) y ocurre inmediatamente cuando se guarda la configuración y luego una vez al día, durante la noche.
3. Puede establecer un número de extensión inicial que se asignará a los usuarios importados de Google. De lo contrario, utilizará la primera extensión disponible.
4. No es necesario sincronizar a todos los usuarios. Puede excluir a determinados usuarios o especificar sólo un conjunto en particular de usuarios para sincronizar. Haga clic en el botón Agregar para configurarlo.

Seleccionar Opciones de Sincronización

Después de activar la sincronización de usuarios, puede seleccionar qué desea sincronizar para los usuarios de Google importados:

1. Habilite SSO para permitir a los usuarios iniciar sesión en el cliente web utilizando sus credenciales de Google (debe configurarse por separado. Consulte cómo hacerlo aquí).
2. Sincronice las Fotos de Usuario de Google a 3CX como un Avatar de usuario habilitando Sincronizar foto de usuario.
3. Puede habilitar la opción de Sincronizar Contactos Personales, la cual sincronizará los Contactos del Usuario de Google a la Agenda Personal 3CX. Esta es una sincronización unidireccional. Los contactos necesitan ser administrados y actualizados desde Google.
4. Habilite Usar eventos de calendario como presencia para actualizar automáticamente el estado de usuarios 3CX basado en sus reuniones programadas en el Calendario de Google. Por lo tanto, si usted se encuentra en una reunión programada, su teléfono no sonará. Al final de la Entrada del Calendario de Google, 3CX cambia el perfil de vuelta al estado anterior. Si se selecciona un perfil 3CX Viaje de Negocios / Almuerzo, los cambios de información de calendario son ignorados.

El mapeo de Tipos de Reunión del Calendario de Google a los Perfiles 3CX son los siguientes:

• Evento > No Molestar (DND).
• Tiempo de Concentración > No Molestar (DND).
• Fuera de la Oficina > Ausente.

Características Adicionales

Google Cloud para Almacenamiento Remoto

Configurando la Integración Google en su 3CX, si se le dan los permisos apropiados durante el proceso de configuración, 3CX creará automáticamente un Google bucket a su proyecto Google Cloud y configurará sus ajustes de Almacenamiento 3CX en consecuencia.

Entonces, solo tiene que ir a la Consola de Administración > Sistema > Almacenamiento y seleccionar los datos que desea almacenar en esta Ubicación remota de Google. Puede almacenar de forma remota sus Archivos de Chat, Faxes, Grabaciones, Buzones de Voz y Copias de Seguridad según sea necesario.

Google Speech para Transcripción

Si se seleccionan los permisos pertinentes, puede habilitar la transcripción de Google Speech mediante la Configuración de Google creada automáticamente por el proceso de Integración.

Una vez que finalice la Integración de Google y el almacenamiento esté configurado en 3CX, solo navegue a la Consola de Administración > Integraciones > Transcripción y habilite la transcripción usando Google Speech para su Idioma preferido.

Utilizar Google Workspace para Enviar Correos Electrónicos

Dados los permisos apropiados durante el proceso de integración, 3CX automáticamente configurará sus parámetros de correo electrónico del sistema para utilizar la cuenta integrada de Google Workspace para enviar correos electrónicos del sistema.

Google ReCaptcha

Una vez que configure la Integración Google con el permiso relevante durante el proceso de configuración, puede habilitar Google ReCaptcha desde la Consola de Administración > Integraciones > Google para que se ejecute en segundo plano protegiendo a 3CX de ataques automatizados y abuso.

Información Técnica y Preguntas Frecuentes

Sincronización en Tiempo Real vs. Sincronización Diaria

Los siguientes datos se sincronizan en tiempo real con los cambios en Google:

• Primer Nombre del Usuario.
• Apellido del Usuario.
• Foto del Usuario.
• Teléfono de Trabajo del Usuario.
• Nuevo usuario creado en Workpace.
• Suspender / Borrar Usuario en Workspace > Deshabilita Extensión 3CX.
• Desbloquear Usuario en Workspace > Habilita Extensión 3CX.
• Eventos de calendario.

Del resto de Datos que no tenemos en cuenta de los cambios en vivo, el PBX sincronizará una vez al día. La Sincronización Diaria es controlada por el parámetro GW_SYNC_TIME. Almacena la hora del día en un formato de 24 horas: HH:MM:SS, donde el PBX resincronizará todos los datos desde Google.

Estados de Sincronización del Calendario

La creación de una entrada en el Calendario de Google sincronizará la presencia del usuario de la siguiente manera:

• Evento > No Molestar (DND).
• Fuera de la Oficina > Ausente.
• Tiempo de Concentración > No Molestar (DND).

Sincronización de Datos de Usuarios y Contactos

Para los usuarios sincronizados se sincronizan los siguientes datos de Google:

• Primer Nombre del Usuario.
• Apellido del Usuario.
• Correo Electrónico.
• Teléfono (Trabajo) al Móvil del usuario en 3CX.
• Foto.

Para los usuarios sincronizados se sincronizan los siguientes datos de Google:

• Primer Nombre.
• Apellido.
• Foto.
• Empresa.
• Título.
• Móvil.
• Móvil2.
• Casa.
• Trabajo.
• Trabajo2.
• Correo Electrónico.
  

Para sincronizar correctamente esta información de contacto, debe etiquetarlos en Contactos de Google, como se muestra en la siguiente captura de pantalla.

Configuración Existente de Google Storage

En caso de que ya tenga habilitado Google Storage, durante el proceso de integración, el asistente le informará y no lo reconfigurará por usted.

Limitaciones y Problemas Conocidos

• Los contactos de la empresa no existen.
• Gmail tiene un tamaño máximo de archivo adjunto de 25Mb por mensaje.
• No hay manera de detectar cambios en los contactos personales.
• La creación de contactos desde el Cliente Web a Google estará disponible en la próxima versión.

Ver También

• Configurando el Inicio de Sesión Único Google SSO.
• Cómo Integrar su PBX con Microsoft 365. 

Última Actualización

Este documento se actualizó por última vez el 19 de Febrero de 2025
https://www.3cx.es/docs/manual/google-workspace/