13. Integraciones

Las capturas de pantalla muestran la interfaz en turco de Prozence con datos ficticios de "Örnek Teknoloji A.Ş."; la interfaz en español tiene la misma disposición.

Este capítulo es para el Admin y el equipo de TI que conectan Prozence con los sistemas externos que usa la empresa: Google Workspace, Microsoft 365, Yandex 360, Zoho Mail, inicio de sesión único (SAML), CRM, canales de chat, Google Chat con Mensajes, sistemas de nómina y contabilidad, Microsoft Teams, API REST, SCIM, notificaciones de la aplicación móvil, Zoom y Apple / Google Wallet. Todas las conexiones son opcionales; Prozence funciona sin ninguna de ellas (acceso con código por correo, firma copiada y pegada).

Desde 0.99.13, la mayoría de las conexiones se configuran y se supervisan en la aplicación, en la pestaña Admin → Integraciones. El registro de la aplicación de Microsoft, los certificados de Wallet y algunas pantallas antiguas siguen en WordPress; los dos lugares usan el mismo ajuste. Los valores secretos (clave de API, secreto de cliente, clave de la cuenta de servicio, certificado) no vuelven a mostrarse en pantalla una vez guardados; solo se ven "Guardado …" y sus cuatro últimos dígitos. Todos los valores de ejemplo de este capítulo son ficticios (ornek.invalid) y las claves de las imágenes están enmascaradas.

Este capítulo es para Prozence Workplace 0.99.45 y versiones posteriores.

Para quién: Admin · TI · Administrador de WordPress · Auditor (solo la pestaña Estado)

Para las pantallas de WordPress de los conectores CRM, consulta 12. Administración del directorio de clientes. Para saber quién ve cada pestaña, consulta 10. Administración y configuración.

En este capítulo

• Integraciones: pestaña Estado
• Ver el estado de las conexiones (WordPress)
• Elegir la plataforma de correo
• Asistente de Google / Microsoft (en la aplicación)
• Asistente de conexión: conceder y probar permisos (WordPress)
• Google Workspace: conectar la cuenta de servicio
• Escribir la firma de Gmail de forma centralizada
• Inicio de sesión con Google
• Configurar la conexión CRM desde la aplicación
• Asignación de campos del CRM
• Reglas de asignación de propietario
• Registro de interacciones (notas del CRM)
• Lectura desde el CRM
• Cola de errores del CRM
• Directorio e inicio de sesión: comparar con el directorio en la aplicación
• Aplicación automática en la sincronización del directorio
• Sincronización del directorio (Google o Microsoft)
• Calendario: festivos, calendarios externos y Google Calendar
• Conexión con Microsoft 365 e inicio de sesión con Microsoft
• Inicio de sesión único (SAML)
• Firma de Outlook: regla de servidor de Exchange
• Conexión con Yandex 360 y escritura de la firma
• Conexión con Zoho Mail y escritura de la firma
• Canales de chat (Slack, Teams, Google Chat)
• Configuración de Mensajes (Google Chat)
• Webhook de eventos de personal
• Exportación al programa de nóminas
• Aplicación de Microsoft Teams
• Crear una clave de la API REST
• Gestionar las claves de API y el registro de solicitudes
• Aprovisionamiento automático de usuarios con SCIM
• Cuenta de revisión de las tiendas
• Configuración de las notificaciones móviles (Firebase y APNs)
• Conexión con Zoom
• Apple y Google Wallet

Integraciones: pestaña Estado

Para quién: Admin, Auditor (solo lectura) · Dónde: Admin → Empresa → Integraciones → Estado · Versión: 0.99.13 (fila de Google Workspace añadida en 0.99.25; notas y Abrir el asistente actualizados en 0.99.46)

Para qué sirve: Muestra desde la aplicación, sin entrar en WordPress, el estado de todas las conexiones: CRM, sincronización del directorio, permisos de Google y otras conexiones. Si hay algún problema, vas a la pestaña correspondiente con un solo clic.

Antes de empezar: La pestaña solo la ven el Admin y el Auditor. Los empleados y los admins de módulo no tienen Integraciones en el menú.

1. Haz clic en Admin en el menú de la izquierda.
2. En el grupo Empresa, haz clic en Integraciones. Arriba aparecen las subpestañas; Estado se abre por defecto.
3. Lee el cuadro Conexiones CRM. La insignia de cada CRM activado es Activo, Pendiente o Hay un problema; debajo se indican "Último envío correcto: …", "N registros detenidos", "N registros se reintentarán" y, si procede, "Último error (…): …". Los CRM desactivados se listan en una sola línea como "Desactivado: …". Para los ajustes, haz clic en Ajustes del CRM.
4. En el cuadro Sincronización del directorio, mira la hora de la última comparación y el número de usuarios del directorio y de personas en Prozence. Si hay propuestas pendientes, la insignia dice "N propuestas pendientes"; haz clic en Abrir sincronización. Si la sincronización no está configurada, la insignia es Desactivado y dice "Sin configurar: la clave JSON de la cuenta de servicio de Google Workspace se pega en el asistente de conexión de la pestaña Google / Microsoft o en WordPress; el registro de la aplicación de Microsoft 365 se configura en WordPress."; Abrir el asistente te lleva a la pestaña Google / Microsoft.
5. Si la cuenta de servicio de Google está cargada, en el cuadro Conexión con Google Workspace la fila Permisos de Google de las funciones activas muestra Funciona, Faltan N pasos, No probado o Sin configurar. Si falta algo, haz clic en Abrir el asistente.
6. En el cuadro Otras conexiones, mira la insignia de cada conexión (Funciona, Atención, Hay un problema, Desactivado). Con Abrir ajustes, Abrir canales o (si tienes permiso en WordPress) Abrir en WordPress, vas a la pantalla correspondiente. Si no tienes permiso en WordPress, bajo el cuadro aparece la nota "El registro de la aplicación de Microsoft y los certificados de Wallet se configuran en WordPress; pídeselo al administrador de WordPress. La clave JSON de la cuenta de servicio de Google se puede pegar en el asistente de conexión de la pestaña Google / Microsoft."

Filas del cuadro Otras conexiones:

Consejo: Cuando el Admin toca en la aplicación la fila "Envío al CRM detenido: …" de la lista Pendientes para ti, se abre directamente Integraciones → CRM.

Importante: El Auditor solo ve la pestaña Estado. El servidor no envía al Auditor campos de ajustes, nombres de personas, detalles de la cola ni claves; cualquier registro que haga el Auditor se rechaza con "Esta operación requiere permiso de Admin."

Ver el estado de las conexiones (WordPress)

Para quién: Usuario con permiso de Prozence en WordPress, TI · Dónde: WordPress → Prozence Workplace → Configuración → Conexiones opcionales · Versión: 0.25.0

Para qué sirve: Muestra en WordPress, en una sola lista, el estado de todas las conexiones externas y las prueba con Probar.

1. En WordPress, abre la pantalla Prozence Workplace → Configuración.
2. En la lista Conexiones opcionales, lee el estado de cada fila: Google Workspace (firmas, sincronización del directorio), Permisos de Google, HubSpot CRM y otros CRM, IA (lectura de tarjetas de visita, enriquecimiento), Notificaciones en el móvil (web push), Apple y Google Wallet, Microsoft 365 (inicio de sesión, sincronización del directorio), Caché de página y otras.
3. Para configurar o corregir una conexión, haz clic en Configurar en su fila; para probarla, haz clic en Probar.

Consejo: Para la lista completa de filas y mensajes, consulta 10. Administración y configuración. El Admin que no tiene cuenta de WordPress sigue la misma información desde la pestaña Estado.

Elegir la plataforma de correo

Para quién: Administrador de la aplicación · Dónde: Admin → Comunicación → Firma de correo → Distribución → Plataforma de correo · Versión: 0.87.0 (Yandex 360 0.99.55; Zoho Mail 0.99.56)

Para qué sirve: Eliges la plataforma que usa la empresa para el correo. Solo se muestran los ajustes de la plataforma elegida.

1. Abre Admin → Firma de correo y haz clic en la pestaña Distribución.
2. En el cuadro Plataforma de correo, elige una:
   • Google Workspace: escritura centralizada en Gmail, sincronización del directorio de Google, inicio de sesión con Google;
   • Microsoft 365: regla de servidor de Outlook (Exchange), inicio de sesión con Microsoft, sincronización del directorio de Entra ID;
   • Yandex 360: escritura centralizada en Yandex 360, sincronización del directorio de Yandex 360 (consulta Conexión con Yandex 360);
   • Zoho Mail: escritura centralizada de la firma en Zoho Mail (consulta Conexión con Zoho Mail);
   • Otra (manual): no hay escritura centralizada; los empleados copian la firma desde Mi tarjeta.
3. Haz clic en Guardar.

Consejo: En la primera configuración, la elección se determina sola a partir de la conexión existente; bajo el cuadro se indica cuándo y según qué se determinó. La misma elección también está en la parte superior de las pantallas Firmas de correo y Microsoft 365 de WordPress.

Importante: Los ajustes de las secciones ocultas no se borran; las tareas automáticas de la plataforma no elegida (p. ej. la escritura en Gmail, la comparación diaria del directorio) se detienen. El inicio de sesión con Google y con Microsoft no depende de esta elección; nadie se queda bloqueado.

Asistente de Google / Microsoft (en la aplicación)

Para quién: Admin; administrador de Google Workspace o de Microsoft 365 (para los pasos en las pantallas de Google y de Microsoft) · Dónde: Admin → Integraciones → Google / Microsoft · Versión: 0.99.25

Para qué sirve: Configura y prueba en una sola pantalla, en cuatro pasos, los permisos de Google que piden las funciones activas de Prozence (firma de Gmail, sincronización del directorio, añadir tarjetas por correo, reserva de salas y Google Calendar, registro de contactos por correo…). El estado de cada paso figura a su lado: Aceptar, Pendiente o Se sabrá al probar.

Antes de empezar:

• Necesitas un administrador que pueda crear proyectos en Google Cloud y conceder la "Delegación de todo el dominio" en la consola de administración de Google.
• La pestaña solo la ve el Admin.

Conectar Google Workspace:

1. En el paso 1 Cuenta de servicio, haz clic en Google Cloud → Cuentas de servicio ↗. En Google Cloud, crea una cuenta de servicio (Cuentas de servicio → Crear cuenta → Claves → Añadir clave → JSON).
2. Pega el contenido del archivo JSON descargado en el cuadro Pegar la clave JSON y haz clic en Guardar cuenta de servicio. En el paso aparece "Cargada: …" y el nombre del proyecto; el cuadro se vacía.
3. En el paso 2 Activar las API en Google Cloud, lee la fila Lo que hay que activar (p. ej. "API de Gmail") y haz clic en Activar las API ↗. En la página que se abre en Google Cloud, pulsa "Habilitar".
4. En el paso 3 Autorizar en la consola de administración, haz clic en Autorizar ↗ (N permisos). En la consola de administración de Google se abre la pantalla "Delegación de todo el dominio" con el ID de la cuenta de servicio y los permisos ya rellenos; solo pulsa "Autorizar". Si el buzón de correo compartido es una cuenta aparte, aparece un segundo botón.
5. En el paso 4 Probar, haz clic en Probar ahora. En la tabla, cada función activa muestra Funciona, Falta permiso, API desactivada, Error, Falta o No se pudo probar.
6. En las filas rojas, sigue el enlace Abrir ↗ (página de la API) o Autorizar ↗ y repite Probar ahora. Cuando todo funciona, la insignia superior pasa a Todo funciona.

Conectar Microsoft 365 (aparece si la conexión con Microsoft 365 está guardada):

1. 1 Registro de la aplicación en Entra (inquilino, cliente, secreto): el registro se hace en la pantalla Microsoft 365 de WordPress (consulta Conexión con Microsoft 365).
2. 2 Pegar el bloque de permisos en el manifiesto de la aplicación: haz clic en Copiar; en Entra → Registro de aplicaciones → Manifiesto, sustituye el bloque "requiredResourceAccess" por este y guarda.
3. 3 Consentimiento de administrador: haz clic en Conceder consentimiento de administrador ↗; el consentimiento se da en la página de Microsoft y el retorno exige una sesión de administrador de WordPress.
4. 4 Probar: haz clic en Probar ahora.

Resultado: El resultado de la prueba se guarda en el servidor y se comparte con el Asistente de conexión de WordPress. En los cuadros de Reservas (Google Calendar) y de Registro de contactos por correo, ahora aparece una sola línea de estado ("La conexión con Google Calendar funciona.", "Falta 1 paso para Google Calendar.", "No hay cuenta de servicio de Google.") y el botón Abrir el asistente en lugar del largo texto de configuración.

Errores frecuentes y avisos:

Consejo: Si más adelante activas una función nueva, repite solo los pasos 3 y 4; los permisos anteriores permanecen en la lista.

Importante:

• Si en Workspace está activada la aprobación de varias partes, la solicitud de "Autorizar" cae en la aprobación de un segundo superadministrador; cuando se aprueba, los permisos son efectivos en unos minutos.
• La clave JSON se guarda en el servidor y no vuelve a mostrarse en esta pantalla. Tras subirla, borra el archivo de tu ordenador; no lo compartas en capturas de pantalla ni por correo.
• La prueba solo lee; no se modifica ningún correo, calendario ni registro de usuario.

Asistente de conexión: conceder y probar permisos (WordPress)

Para quién: TI, administrador de Google Workspace o de Microsoft 365 · Dónde: WordPress → Prozence Workplace → Asistente de conexión · Versión: 0.39.0

Para qué sirve: Define y prueba desde WordPress los permisos de Google Workspace y de Microsoft 365. Desde 0.99.25 lo mismo se hace también en la aplicación (consulta Asistente de Google / Microsoft (en la aplicación)); las dos pantallas usan el mismo resultado. Prozence solo pide los permisos de las funciones que activas; no lee el buzón de los empleados ni envía correos en su nombre.

Google Workspace:

1. Primero conecta la cuenta de servicio. El asistente se rellena después de este paso.
2. En la sección 1. Autoriza en la consola de administración, haz clic en Abrir en la consola de administración de Google (los campos vienen rellenos). En la pantalla de Google que se abre, pulsa Autorizar.
3. En la sección 2. Prueba los permisos, haz clic en Probar permisos. En la tabla se ve el estado de cada función: Funciona, Falta permiso, API desactivada, Falta, Error, No se pudo probar o Desactivado. En la fila API desactivada, el enlace Activar → abre la página correspondiente de Google Cloud.

Microsoft 365:

1. 1. Añade los permisos con un solo pegado: abre entra.microsoft.com → Registros de aplicaciones → tu aplicación de Prozence → Manifiesto. Toma el bloque del asistente con Copiar y pégalo en lugar de la sección requiredResourceAccess y guarda.
2. 2. Consentimiento de administrador: después de guardar el inquilino y el ID de la aplicación en la pantalla de Microsoft 365, haz clic en Conceder consentimiento de administrador. En la página de Microsoft, pulsa Aceptar con una cuenta de administrador global.
3. 3. Prueba los permisos: haz clic en Probar permisos.

Importante: La prueba solo lee (p. ej. los nombres de remitente de un empleado, el número de la etiqueta "Enviados", el primer usuario del directorio). Si en Microsoft usas también otros permisos (p. ej. Dynamics 365), añade a la lista existente solo las filas que faltan.

Google Workspace: conectar la cuenta de servicio

Para quién: TI, administrador de Google Workspace · Dónde: WordPress → Prozence Workplace → Firmas de correo → Conexión; en la aplicación, Admin → Integraciones → Google / Microsoft → paso 1 · Versión: 0.4.2 (en la aplicación 0.99.25)

Para qué sirve: La escritura centralizada de la firma en Gmail, la sincronización del directorio, Google Wallet, Google Calendar y el buzón de correo compartido usan la misma cuenta de servicio de Google.

1. En Google Cloud Console, elige o crea un proyecto. API y servicios → Biblioteca → API de Gmail → Habilitar. Si vas a usar la sincronización del directorio, habilita también la API de Admin SDK.
2. IAM y administración → Cuentas de servicio → Crear cuenta de servicio (p. ej. kartvizit-imza; no hace falta asignar rol). En la pestaña Claves de la cuenta, descarga el archivo de la clave con Añadir clave → JSON.
3. Pega el contenido del archivo en el cuadro Pegar la clave JSON de la pestaña Google / Microsoft de la aplicación, o en el cuadro Cuenta de servicio de la pantalla Firmas de correo de WordPress, y guarda.
4. Borra de tu ordenador el archivo JSON que descargaste.
5. Concede la delegación de todo el dominio con el asistente. Si prefieres hacerlo a mano, sigue los pasos de Configuración (una vez) de la pantalla: admin.google.com → Seguridad → Control de acceso y de datos → Controles de API → Delegación de todo el dominio → Añadir nueva; el ID de cliente es el ID numérico de la cuenta de servicio.

Consejo: El primer ámbito (gmail.settings.basic) solo accede a los ajustes de Gmail (firma, nombres de remitente); no puede leer ni enviar correo. El segundo ámbito (gmail.labels) solo ve los nombres y los recuentos de las etiquetas.

Importante: La clave no vuelve a mostrarse una vez guardada. Si la política de tu organización impide crear claves de cuentas de servicio (iam.disableServiceAccountKeyCreation), define una excepción para este proyecto.

Escribir la firma de Gmail de forma centralizada

Para quién: Administrador de la aplicación · Dónde: Admin → Comunicación → Firma de correo → Distribución → Gmail: escritura centralizada · Versión: 0.4.2 (en la aplicación 0.84.0)

Para qué sirve: La firma de cada empleado se escribe de forma centralizada en su propia cuenta de Gmail; el empleado no tiene que hacer nada.

Antes de empezar: Debe estar elegida la Plataforma de correo = Google Workspace y la cuenta de servicio debe estar conectada. Si no hay conexión, en el cuadro aparece el aviso "La conexión con Gmail no está configurada".

1. En la pestaña Distribución, abre el cuadro Gmail: escritura centralizada.
2. Si quieres, marca estas opciones y haz clic en Guardar:
   • Actualizar automáticamente la firma de Gmail cuando cambie: cuando se guarda a la persona o cambia un ajuste de la empresa (dirección, texto inferior, logotipo), se actualiza el Gmail de la persona cuya firma ha cambiado;
   • Leer cada noche el número de «Enviados» de Gmail de todos: para la proporción "cuántos clics en cuántos correos" de la analítica; solo se lee el contador de la etiqueta.
3. En la sección Acciones masivas, haz clic en Escribir la firma de todos y confirma. Se escribe la firma en el Gmail de todos los que están publicados.
4. Sigue el resultado en la lista Estado de la firma por persona (Escrita, No cabe (sin seguimiento), Error, No escrita). Para una sola persona, usa los botones Escribir en Gmail, Comprobar, Restaurar anterior de su fila.
5. Para avisar a los empleados de que su firma ha cambiado, haz clic en Enviar el correo informativo a todos; para presentarles la aplicación, en Enviar el correo de bienvenida a todos.

Consejo: Comprobar Gmail (todos) compara la firma de Gmail con la firma actual. En la primera escritura se guarda la firma anterior de Gmail de la persona; Restaurar anterior la devuelve.

Importante:

• Los correos informativos y de bienvenida no se envían solos; se envían con el botón.
• Gmail permite una sola firma de forma centralizada. La firma corta la eligen los empleados para sus respuestas (consulta 02. Firma de correo).
• Para el recuento de enviados, el segundo ámbito (gmail.labels) debe estar añadido en la consola de administración. Se recomienda avisar a los empleados de que se hace esta medición.
• Para el diseño de la firma, las plantillas y los banners, consulta 11. Gestión de marca, identidad y firma.

Inicio de sesión con Google

Para quién: TI, administrador de Google Workspace · Dónde: WordPress → Prozence Workplace → Espacio personal → Entrada · Versión: 0.6.0

Para qué sirve: Se añade a la pantalla de acceso el botón Iniciar sesión con Google. El empleado entra con su cuenta de Google de la empresa, sin esperar un código.

1. En Google Cloud Console, abre API y servicios → Credenciales → Crear ID de cliente de OAuth.
2. Como tipo de aplicación elige Aplicación web. En Orígenes autorizados de JavaScript, escribe la dirección de tu sitio (p. ej. https://ornek.invalid).
3. En la pantalla de consentimiento de OAuth, si eliges Interno, solo podrán usarlo las cuentas de la empresa.
4. Copia el ID de cliente que se genera (termina en …apps.googleusercontent.com).
5. En WordPress, abre la pantalla Espacio personal. Pégalo en el cuadro ID de cliente de Google.
6. En el cuadro Dominios permitidos, escribe los dominios de Google Workspace de la empresa separados por comas (p. ej. ornek.invalid).
7. Se recomienda dejar el Acceso con código por correo en Activado (respaldo para quienes no pueden acceder a Google).
8. Haz clic en Guardar ajustes.

Consejo: Solo se escribe el ID de cliente; no hace falta el secreto (client secret) y no se escribe aquí. El mismo ID de cliente se puede elegir en la configuración de Mensajes con Usarlo. Si el cuadro ID de cliente de Google está vacío, el botón no aparece.

Importante: No se aceptan las cuentas personales de Google (aunque se hayan abierto con una dirección de la empresa). En el acceso, la dirección de correo debe coincidir con la ficha de un empleado publicado.

Configurar la conexión CRM desde la aplicación

Para quién: Admin · Dónde: Admin → Integraciones → CRM · Versión: 0.99.13 (Service key de HubSpot 0.99.13; listas de usuarios y etiquetas de Pipedrive 0.99.13)

Para qué sirve: Los contactos añadidos con Añadir tarjeta, los que dejan sus datos en la tarjeta de visita y los que llegan por correo se envían a todos los CRM activos. Los ajustes de los ocho conectores están en una sola página de la aplicación: HubSpot, Pipedrive, Salesforce, Zoho CRM, Bitrix24, Odoo, Microsoft Dynamics 365, Webhook (Make, Zapier, n8n). Las pantallas Conexiones CRM y Escaneo de tarjeta de WordPress siguen funcionando; los dos lugares usan el mismo ajuste.

Antes de empezar:

• Prepara en el CRM una clave de API con permiso de lectura y escritura de contactos (o los datos de cliente que pida el conector). La vía recomendada en HubSpot: HubSpot → Development → Keys → Service keys → Create service key; ámbitos crm.objects.contacts.read y crm.objects.contacts.write (para el enriquecimiento de empresas, además crm.objects.companies.read y crm.objects.companies.write). La Service key se renueva cada 6 meses.
• Para Microsoft Dynamics 365, primero hay que configurar la conexión con Microsoft 365.

1. Abre la pestaña Integraciones → CRM. Arriba está la descripción de Conexiones CRM y, debajo, Registro de interacciones, Reglas de asignación de propietario, las tarjetas de los conectores y la Cola de errores.
2. Haz clic en la tarjeta del conector (p. ej. HubSpot); la tarjeta se abre. La tarjeta de un conector con problemas se abre sola.
3. Marca la casilla de activación del conector (p. ej. Enviar contactos a Pipedrive). En HubSpot no hay casilla aparte; funciona cuando se introduce la clave de acceso o el ID del formulario.
4. Rellena los campos de la clave y de la conexión (HubSpot: Clave de acceso (Service key), ID del portal, Región de datos, ID del formulario (GUID); en los demás conectores, los campos de la pantalla).
5. Elige los valores predeterminados: Propietario predeterminado (si el empleado que recogió la tarjeta no se encuentra en el CRM), Origen predeterminado, Nombre del formulario, Texto del registro de consentimiento.
6. Rellena la tabla Asignación de campos (consulta Asignación de campos del CRM).
7. Haz clic en Guardar y luego en Probar. Bajo la tarjeta queda el resultado "Última prueba (…): …". En Pipedrive, Probar lee también los usuarios y las etiquetas activos; Propietario predeterminado y Asignación de etiquetas se convierten en una lista desplegable.
8. Para enviar también los contactos añadidos antes, haz clic en Transferir registros existentes y acepta la pregunta de confirmación ("…: ¿poner en cola todos los registros del catálogo y enviarlos de 25 en 25?").

Conexión con un clic (HubSpot, Pipedrive, Zoho CRM, Salesforce; 0.99.90): En la tarjeta de los CRM cuya aplicación está activada en el centro de Prozence aparece el botón «Conectar con …». Haces clic en el botón, inicias sesión en la propia pantalla del CRM y confirmas el permiso; no tienes que copiar ninguna clave. Cuando se establece la conexión, la tarjeta muestra Conectado con un clic y el nombre de la cuenta conectada; los campos de clave de la tarjeta no se usan mientras tanto.

En Salesforce primero se instala el paquete (0.99.95): En la tarjeta de Salesforce aparecen dos pasos. El enlace Instalar el paquete ↗, bajo 1. Instala el paquete de Prozence en tu org de Salesforce, abre la página de instalación de Salesforce; confirma la instalación con la opción predeterminada ("Install for Admins Only"). Esto lo hace una sola vez el administrador de Salesforce. Después vuelve a Prozence y haz clic en Conectar con Salesforce, bajo 2. Conéctate.

Consejo: Las orgs sandbox no se conectan con un clic; conéctalas con los campos de la tarjeta (Dirección de My Domain y las credenciales de cliente).

Ajustes de HubSpot:

Campos secretos: Valores como la clave, el secreto de cliente y la dirección del webhook de Bitrix24 no llegan nunca al navegador. Si están guardados, encima del campo aparecen Guardado y los cuatro últimos dígitos; el cuadro dice "Escribe el valor nuevo para cambiarlo". Si lo dejas vacío, se conserva el anterior; para borrarlo, marca Quitar y guarda. La clave de firma del conector Webhook se muestra al Admin para la verificación del sistema receptor; se cambia con Actualizar.

Errores frecuentes y avisos:

Consejo: Tras un escaneo, el empleado no ve el error en bruto: aparece "Enviado al CRM (HubSpot)." o "El registro se ha guardado en el catálogo de la empresa; ahora no se ha podido enviar al CRM (HubSpot). Se reintentará solo." / "… Se ha avisado al responsable."

Importante:

• Las personas de servicios contratados (banco, asesor contable, proveedor…) no van a ningún CRM.
• En Salesforce, Zoho, Bitrix24, Odoo y Dynamics, los ID de propietario se escriben a mano; la lista desplegable solo existe en Pipedrive.
• Los conectores distintos de HubSpot no se pudieron mostrar con una cuenta real en el sitio de prueba; las pantallas están en estado "Desactivado".

Asignación de campos del CRM

Para quién: Admin · Dónde: Admin → Integraciones → CRM → tarjeta del conector → Asignación de campos · Versión: 0.99.34

Para qué sirve: Eliges en una sola tabla qué dato de Prozence se escribe en qué campo de contacto del CRM. En HubSpot, Pipedrive, Salesforce, Zoho, Bitrix24, Odoo y Dynamics 365 se usa la misma tabla. Las asignaciones de los antiguos cuadros de campos sueltos pasaron a la tabla tal cual.

1. Abre la tarjeta del conector y prueba la conexión con Guardar → Probar. Probar lee los campos de contacto editables del CRM.
2. En la tabla Asignación de campos, haz clic en el cuadro junto a un dato de Prozence.
3. Empieza a escribir el nombre del campo (p. ej. "feria"). En la lista de sugerencias, el nombre del campo aparece arriba y su nombre interno en el CRM, abajo.
4. Elige el campo correcto; el nombre interno se escribe en el cuadro. Si Probar aún no ha leído campos, escribe el nombre interno a mano (p. ej. en HubSpot nombre interno, en Salesforce nombre de API, en Bitrix24 UF_CRM_…).
5. Deja vacíos los datos que no quieras enviar.
6. Haz clic en Guardar.

Los 16 datos que se pueden asignar: Origen («¿Dónde se conocieron?»), Nota de origen, Nombre del formulario, Consentimiento comercial (Sí / No), Etiquetas (separadas por comas), Cargo, Sitio web, LinkedIn, Dirección, Empleado que recogió la tarjeta, Email del empleado que recogió la tarjeta, Feria / evento, Nivel de interés (feria), Empresa que registró (grupo), Fecha del primer registro, ID de registro de Prozence.

Formato del nombre del campo (el ejemplo del cuadro): HubSpot "nombre interno, p. ej. lead_kaynag_detay" · Pipedrive "clave del campo de 40 caracteres" · Salesforce "nombre de API, p. ej. Kaynak__c" · Zoho "nombre de API, p. ej. Kaynak" · Bitrix24 "UF_CRM_…" · Odoo "nombre del campo, p. ej. x_kaynak" · Dynamics "nombre lógico, p. ej. new_kaynak".

Errores frecuentes y avisos:

Consejo: Un campo que no existe en el CRM no estropea el envío: ese campo se omite y el contacto se guarda igualmente. El valor de un campo de lista de selección o de tipo fecha del CRM debe enviarse en el formato que acepta el CRM; si no, solo se omite ese campo.

Importante: La lista de campos de Microsoft Dynamics solo muestra los atributos de texto.

Reglas de asignación de propietario

Para quién: Admin · Dónde: Admin → Integraciones → CRM → Reglas de asignación de propietario · Versión: 0.99.34

Para qué sirve: Determinas con reglas el propietario en el CRM de un registro nuevo (p. ej. los registros con la etiqueta "Institución pública" van por turnos a Murat Çelik y Emre Doğan, y los registros con dirección en İzmir, a Can Öztürk). Si no hay reglas o ninguna coincide, el propietario es el empleado que recogió la tarjeta.

1. En el cuadro Reglas de asignación de propietario, haz clic en + Añadir regla. Se abre una fila nueva, numerada.
2. En la primera lista, elige la condición: Etiqueta, Feria / evento, Origen, Ciudad (en la dirección) o Todos los registros.
3. Elige o escribe el valor (etiqueta y evento, de la lista; origen y ciudad, como texto, p. ej. "İzmir").
4. En la lista + Añadir empleado, elige el empleado que será propietario. Si eliges a varios empleados, la fila dice "Se reparte por turnos."; los registros nuevos se reparten por turnos. Para quitar a un empleado, haz clic en la × que hay junto a su nombre.
5. Si hace falta, añade otras reglas. Las reglas se prueban de arriba abajo; cambia el orden con ↑ y quita las reglas que no necesites con Eliminar.
6. Marca la casilla Reglas activadas y haz clic en Guardar.

Errores frecuentes y avisos: "Regla N: elige una condición.", "Regla N (…): escribe o elige un valor.", "Regla N: no se encontró la etiqueta.", "Regla N: no se encontró el evento.", "Regla N (…): elige al menos un empleado."

Consejo: La regla se aplica una vez a un registro y se recuerda la persona elegida; en un reenvío o en un reintento de la cola, el propietario no cambia. Si el empleado elegido se va de la empresa, la regla se aplica de nuevo. En la nota de origen, "quien recogió la tarjeta" sigue siendo el empleado que realmente recogió la tarjeta.

Importante: Las reglas solo se aplican a los registros que se envían de nuevo; el propietario de un contacto que ya existe en el CRM no cambia. Los empleados que ya no están no aparecen en la lista.

Registro de interacciones (notas del CRM)

Para quién: Admin · Dónde: Admin → Integraciones → CRM → Registro de interacciones · Versión: 0.99.14 (la tarjeta enviada añadida a contactos 0.99.16)

Para qué sirve: Cada contacto con la persona (escaneo de tarjeta, «Enviar mi tarjeta», dejar datos…) se escribe como nota o actividad en el registro de la persona en cada CRM conectado. El equipo comercial ve en el CRM "cuándo, dónde y quién conoció a esta persona".

1. En el cuadro Registro de interacciones, marca los tipos de contacto que se escribirán en el CRM.
2. Si también quieres enviar las notas sobre clientes y los resúmenes de notas de voz, lee antes el aviso; el texto informativo de privacidad para clientes debe mencionar la transferencia al CRM.
3. Haz clic en Guardar. Bajo el cuadro, la línea "Se escribirá en: …" lista los CRM conectados que pueden escribir notas.

Registro que se escribe según el CRM: nota en HubSpot (asociada al contacto; solo con clave de acceso), tarea en Salesforce (Completada), nota en Pipedrive / Zoho / Odoo / Dynamics, comentario de la línea de tiempo en Bitrix24, evento etkilesim.yeni en Webhook.

Consejo: Si la persona aún no ha ido al CRM, la nota espera y se envía junto con la persona. Cada evento se escribe una vez por conector.

Importante:

• Si dice "No hay ningún CRM conectado que pueda escribir notas (HubSpot necesita una clave de acceso; la vía del formulario no puede escribir notas).", no se escribe ninguna nota.
• Si no se puede escribir una nota, entra en la cola de errores común como "nota de interacción". Si la clave de HubSpot no tiene permiso para escribir notas, aparece "La clave de HubSpot no tiene permiso para escribir notas (403); se necesitan los ámbitos de contactos (crm.objects.contacts.write)."
• Las notas pendientes de un tipo que desactives después no se envían.

Lectura desde el CRM

Para quién: Admin · Dónde: Admin → Integraciones → CRM → Lectura desde el CRM · Versión: 0.99.52

Para qué sirve: Cada hora lee en el CRM la etapa y el propietario de los contactos enviados desde Prozence al CRM. Cuando el equipo comercial convierte a un contacto en cliente en el CRM o lo pasa a otro comercial, ese dato llega al registro de Prozence como nota y etiqueta; el empleado que usa Prozence ve el estado sin abrir el CRM. La lectura no escribe nada en el CRM.

Antes de empezar: Debe haber al menos un CRM conectado (consulta Configurar la conexión CRM desde la aplicación). En HubSpot, para la lectura se necesita una clave de acceso (aplicación privada); si solo está conectado por la vía del formulario, la fila dice No se puede leer y "HubSpot está conectado por la vía del formulario; para la lectura se necesita una clave de acceso (aplicación privada)."

1. En el cuadro Lectura desde el CRM, marca Lectura activada.
2. Marca los CRM que se van a leer. En cada fila se indica el dato que se lee (p. ej. Etapa del ciclo de vida y propietario, Solo propietario).
3. Para asignar una etiqueta de Prozence según la etapa, haz clic en el encabezado … → Etiqueta de Prozence de la fila y elige una etiqueta para cada etapa. En la etapa en la que no quieras que cambie la etiqueta, deja — No cambiar etiquetas —. Para HubSpot hay una asignación predefinida: Cliente y Evangelista → Cliente; Lead, Lead calificado por marketing, Lead calificado para ventas y Oportunidad → Cliente potencial.
4. Deja las casillas Añadir una nota al registro del contacto cuando cambie la etapa y Añadir una nota al registro del contacto cuando cambie el propietario como prefieras.
5. Haz clic en Guardar. La primera lectura se hace en una hora; si no quieres esperar, haz clic en Leer ahora.

Resultado:

• La primera lectura solo guarda el estado inicial; no se escriben notas ni etiquetas.
• Si en una lectura posterior cambia la etapa o el propietario, en el registro de la persona queda una nota cuyo autor es el CRM (p. ej. "HubSpot — Etapa del ciclo de vida: Oportunidad → Cliente · Propietario: Zeynep Korkmaz → Murat Çelik · Etiqueta de Prozence: Cliente"). La nota es visible para todos los que pueden ver el registro (consulta 04. Directorio de clientes).
• Si la nueva etapa está asignada a una etiqueta, se quitan las demás etiquetas de la asignación y se añade esta; las etiquetas no asignadas (p. ej. Parque tecnológico) no se tocan.
• En cada fila de CRM figura "Última lectura: …, N registros leídos, N cambios"; si hay un error de lectura, aparece debajo en rojo.

Errores frecuentes y avisos: "Elige al menos un CRM.", "Con la lectura activada, elige al menos una cosa: nota o asignación etapa → etiqueta.", "La lectura está desactivada o no hay ningún CRM conectado que pueda leer.", "Se ha leído demasiado a menudo. Inténtalo de nuevo dentro de un minuto."

Consejo: En la lista de asignaciones también se acumulan las etapas que se ven en el CRM; las etapas de Salesforce, Zoho y Pipedrive llegan a la lista después de la primera lectura.

Importante:

• La lectura avanza cada hora, por turnos, con como máximo 100 registros por CRM (50 en Dynamics 365, Pipedrive y Bitrix24); en una empresa con muchos registros, volver a leer un registro puede tardar unas horas.
• La etiqueta que cambia la lectura no se devuelve al CRM (para que no haya un bucle). Se omite al contacto eliminado en el CRM.
• La nota conserva el nombre de la etapa del CRM en el idioma en que está escrito; no se traduce aunque el idioma de la aplicación sea el inglés.

Cola de errores del CRM

Para quién: Admin · Dónde: Admin → Integraciones → CRM → Cola de errores (N) · Versión: 0.27.0 (en la aplicación y aviso al Admin 0.99.13)

Para qué sirve: Lista los contactos y las notas de interacción que no se han podido enviar al CRM. Los errores temporales (conexión, 408, 429, 5xx) se reintentan solos; los errores permanentes (clave incorrecta, campo no autorizado u otros 4xx) quedan Detenido en el primer intento y se reintentan a mano.

1. Baja hasta el cuadro Cola de errores (N). Si no hay nada pendiente, dice "No hay envíos pendientes ni con error."
2. En cada fila se ven la persona, el CRM, (si procede) "nota de interacción", la insignia (Detenido o Próximo intento: …), el número de intentos y el mensaje de error.
3. Corrige la causa del problema (p. ej. la clave) en la tarjeta del conector.
4. Haz clic en Reintentar para un solo registro y en Reintentar todo ahora para todos (como máximo 50 registros de una vez).
5. Quita de la cola con Quitar el registro que no necesites.

Resultado: Cuando un registro se detiene en el intento automático, los Admin reciben como máximo una notificación al día en el teléfono: Envío al CRM detenido — "…: no se pueden enviar contactos al CRM; los registros permanecen en el catálogo de la empresa. Detalles: Admin → Integraciones → CRM." Mientras el problema continúe, en la lista Pendientes para ti de los Admin permanece la fila "Envío al CRM detenido: HubSpot (N personas esperan)"; desaparece con el primer envío correcto.

Importante: El registro que se quita de la cola no se vuelve a enviar solo; si hace falta, usa Transferir registros existentes.

Directorio e inicio de sesión: comparar con el directorio en la aplicación

Para quién: Admin · Dónde: Admin → Integraciones → Directorio e inicio de sesión · Versión: 0.99.13

Para qué sirve: Comparas desde la aplicación el directorio de Google Workspace, Microsoft 365 o Yandex 360 con los registros de empleados de Prozence: empleados nuevos, posibles bajas y diferencias de datos. No se escribe nada solo; se aplican las filas que elijas. Es la misma función que la pantalla Sincronización con Google de WordPress.

Antes de empezar: La sincronización debe estar configurada en WordPress (consulta Sincronización del directorio). Si no lo está, la pestaña dice "La sincronización no está configurada. La clave JSON de la cuenta de servicio de Google Workspace se pega en el asistente de conexión de la pestaña Google / Microsoft o en WordPress; el ajuste de sincronización y el registro de la aplicación de Microsoft 365 se hacen en WordPress." Estas vías también figuran en la sección Inicio de sesión y configuración de conexiones al pie de la pestaña; Abrir el asistente te lleva a la pestaña Google / Microsoft.

1. Abre la pestaña Directorio e inicio de sesión.
2. Haz clic en Comparar con el directorio. Aparece "Vista previa lista."; se abre el cuadro Cambios propuestos (N).
3. Las propuestas se listan en tres grupos:
   • Nuevos empleados (en el directorio, no en Prozence): se añaden como personas en borrador; tú las revisas y las publicas;
   • Posibles bajas: se marcan como "Baja"; la tarjeta deja de estar publicada y vuelve a la página de redirección del QR;
   • Diferencias de datos: se escriben en el sentido de la flecha; justo antes de escribir en el directorio se vuelve a leer el valor y, si ha cambiado, se omite.
4. Marca las filas que quieras aplicar (o Seleccionar todo este grupo).
5. Haz clic en Aplicar selección.
6. Para las direcciones que no deben tener tarjeta, como un buzón compartido o una cuenta de servicio, haz clic en Ignorar en la fila y confirma.
7. Para comprobar los permisos, haz clic en Probar permisos; para cada permiso aparece Funciona, No probado o Hay un problema.

Errores frecuentes y avisos:

Consejo: Si la comprobación diaria está activada (en WordPress), compara y envía un correo a los Admin cuando hay empleados nuevos o bajas; para que las aplique ella misma, consulta Aplicación automática en la sincronización del directorio. Las insignias de origen de la lista de Personal también se actualizan según la comparación (consulta 10. Administración y configuración).

Aplicación automática en la sincronización del directorio

Para quién: Admin · Dónde: Admin → Integraciones → Directorio e inicio de sesión → Aplicación automática · Versión: 0.99.52

Para qué sirve: Si quieres, la comprobación diaria añade sola a Prozence al empleado nuevo del directorio y marca como "Baja" al empleado desactivado en el directorio. Así no tienes que actualizar Prozence a mano en las altas y las bajas. Las diferencias de datos, como el cargo o el teléfono, nunca se escriben automáticamente; esas se siguen escribiendo con Aplicar selección.

Antes de empezar: La sincronización del directorio debe estar configurada (consulta Sincronización del directorio). La tarjeta no aparece mientras la sincronización no esté configurada.

1. En la pestaña Directorio e inicio de sesión, baja hasta el cuadro Aplicación automática.
2. En la lista Nuevos empleados, elige una opción:
   • Solo avisar (sin añadir automáticamente) (predeterminada);
   • Añadir automáticamente — borrador (usted revisa y publica);
   • Añadir automáticamente — publicado (tarjeta y app activas al instante).
3. Para dar de baja también a quienes se van, marca Desactivar automáticamente a quienes se van (suspendidos, deshabilitados o eliminados en el directorio). Al marcarla se activan dos ajustes:
   • Máximo por día (1–50, predeterminado 3): si el número de personas que parecen haberse ido supera esta cifra, no se desactiva automáticamente a ninguna; se envía a los Admin un correo para que lo aprueben.
   • Debe aparecer en dos comprobaciones diarias seguidas (para no desactivar por error en una suspensión temporal) (predeterminado: activado).
4. Haz clic en Guardar. Bajo el cuadro figura la última ejecución: "Última ejecución automática: …, N añadidos, N desactivados, N pendientes de aprobación".

Resultado:

• El empleado añadido automáticamente se crea con el nombre, el cargo y el teléfono móvil del directorio; si elegiste Borrador, lo revisas y lo publicas. Si elegiste Publicado, el anuncio de "Nuevas incorporaciones" también se prepara según tu ajuste.
• La tarjeta del empleado desactivado deja de estar publicada y se cierran sus sesiones. El sustituto y el traspaso de clientes los eliges en la ficha de la persona (consulta 10. Administración y configuración). Si fue un error, vuelve a publicar a la persona.
• Cada operación se escribe en el registro de sincronización como "Automático (comprobación diaria)". En el correo diario que llega a los Admin se listan los añadidos automáticamente, los marcados como "Baja" y los que esperan tu aprobación (con el motivo).

Importante:

• Los Admin de la aplicación no se desactivan automáticamente; quedan en la lista de aprobación.
• Si el directorio devuelve vacío o aparecen más de 50 empleados nuevos en un día, no se hace nada automáticamente.
• Aunque el correo informativo diario esté desactivado, si la aplicación automática está activada la comprobación diaria se ejecuta; el correo solo se envía cuando se ha hecho una operación automática.
• Si usas Entra ID u Okta, SCIM activa y desactiva al instante; la aplicación automática se ejecuta una vez al día.

Sincronización del directorio (Google o Microsoft)

Para quién: TI, administrador de la aplicación · Dónde: WordPress → Prozence Workplace → Sincronización con Google · Versión: 0.6.1 (Microsoft 0.30.0; Yandex 360 0.99.55)

Para qué sirve: Empareja por la dirección de correo los registros de empleados con los usuarios del directorio de la empresa: propone los empleados nuevos, las posibles bajas y las diferencias de datos. Ningún cambio se hace solo; tú eliges y aplicas. La comparación y la aprobación también se hacen en la aplicación (consulta Directorio e inicio de sesión).

Antes de empezar: Para Google hacen falta la cuenta de servicio y la API de Admin SDK; para Microsoft, la conexión con Microsoft 365; para Yandex 360, la conexión con Yandex 360.

1. Abre la pantalla Sincronización con Google. En la sección Ajustes, elige como Directorio Google Workspace, Microsoft 365 (Entra ID) o Yandex 360. También puedes elegir Yandex 360 en la aplicación con Sincronizar el personal desde el directorio de Yandex 360.
2. Para Google, en el cuadro Administrador de Workspace escribe el correo de un administrador de Workspace que pueda leer y actualizar usuarios (p. ej. bt.yonetici@ornek.invalid).
3. En la tabla Campos y sentido, elige el sentido de cada campo (Nombre y apellidos, Cargo, Teléfono móvil, Responsable, Departamento, Foto) (Nombre y apellidos solo se puede sincronizar en el sentido Google → Tarjeta de visita y Foto solo en el sentido Tarjeta de visita → Google):
   • Tarjeta de visita → Google: el valor de la tarjeta se escribe en el directorio;
   • Google → Tarjeta de visita: el valor del directorio pasa a la tarjeta;
   • Sin sincronización.
4. En el cuadro Direcciones ignoradas, escribe línea a línea las direcciones que no tendrán tarjeta de visita (buzones compartidos, cuentas de servicio).
5. Si quieres, marca Comparar cada día; si hay empleados nuevos o bajas, enviar un correo a los responsables. Haz clic en Guardar ajustes.
6. Haz clic en Comparar ahora. Las propuestas se listan en tres grupos: Nuevos empleados, Posibles bajas, Diferencias de datos.
7. Marca las filas que quieras aplicar y haz clic en Aplicar selección. Para una dirección que quieras excluir de forma permanente, usa Ignorar.

Consejo: El sustituto del empleado que se va lo puedes elegir después en el cuadro Salida de la ficha de la persona (consulta 10. Administración y configuración). Para activar y desactivar automáticamente desde Entra ID u Okta, consulta SCIM.

Importante:

• Si la vista previa tiene más de 30 minutos, vuelve a comparar antes de aplicar. Justo antes de escribir se vuelve a leer el valor; si ha cambiado, se omite.
• Si la aplicación automática no está activada, la comprobación diaria no cambia nada; solo avisa. Cada operación se escribe en el registro de la pantalla.
• Si el proveedor del directorio no coincide con la plataforma de correo, la comparación diaria no funciona; en la parte superior de la pantalla aparece un aviso.
• En Yandex 360 solo se pueden escribir Cargo y Departamento (se necesita el permiso directory:write_users); la relación de responsable y la foto no existen en Yandex 360. Si no hay permiso de lectura de departamentos, los departamentos no se comparan.

Calendario: festivos, calendarios externos y Google Calendar

Para quién: Administrador de la aplicación · Dónde: Admin → Empresa → Calendario y Tablón → Calendario · Versión: 0.11.0

Para qué sirve: Añade al calendario de la empresa los festivos oficiales y los calendarios externos públicos. Los empleados pueden añadir el calendario de la empresa a su propio Google Calendar o calendario de Outlook.

1. Abre la sección Calendario y Tablón y baja hasta el cuadro Calendario.
2. Marca la casilla Mostrar festivos oficiales y días especiales de Turquía en el calendario. En el cuadro Dirección del calendario de festivos (ICS, https) figura por defecto el calendario público de festivos de Turquía de Google; también puedes escribir otra dirección ICS. Si el cuadro está vacío, no se leen los festivos.
3. En la sección Calendarios externos, añade como máximo 5 calendarios ICS públicos: escribe un nombre en el cuadro de la izquierda (p. ej. "Calendario normativo") y la dirección https://…/takvim.ics en el de la derecha.
4. Haz clic en Guardar ajustes del calendario.

Añadir al propio calendario del empleado:

1. El empleado abre la pestaña Calendario del Tablón y toca Añadir a mi calendario.
2. Con Copiar copia su dirección personal.
3. En Google Calendar → Otros calendarios → Por URL → pega la dirección.

Consejo: Que los empleados vean sus propios calendarios de Google / Outlook en la pestaña Calendario de Prozence (Mi calendario, 0.99.33) y que la reserva de salas se escriba en Google Calendar funciona con los permisos concedidos con el asistente de Google / Microsoft.

Importante: Los eventos de los calendarios externos son visibles para todos los empleados y se actualizan cada 12 horas. Solo se aceptan direcciones https. La dirección de suscripción personal es propia de cada persona y no debe compartirse. Si la dirección se ha filtrado, el empleado la renueva con Renovar enlace (el anterior deja de funcionar).

Conexión con Microsoft 365 e inicio de sesión con Microsoft

Para quién: TI, administrador de Microsoft 365 · Dónde: WordPress → Prozence Workplace → Microsoft 365 · Versión: 0.30.0

Para qué sirve: Los empleados inician sesión con Iniciar sesión con Microsoft; los datos de los empleados se pueden sincronizar con Entra ID; la información de la firma llega con los pasos de Outlook. La aplicación de Microsoft Teams y el conector de Dynamics 365 también usan este registro de aplicación.

1. Registro de la aplicación en Entra ID:

1. entra.microsoft.com → Aplicaciones → Registros de aplicaciones → Nuevo registro. Tipo de cuenta: Solo cuentas de este directorio de la organización.
2. URI de redirección: plataforma Web, dirección https://ornek.invalid/kartvizit/giris/microsoft/ (con la dirección de tu propio sitio). La dirección correcta figura en la pantalla de Microsoft 365.
3. Certificados y secretos → Nuevo secreto de cliente. Copia el Valor que se genera; no vuelve a mostrarse.
4. Permisos de API → Microsoft Graph: Delegado openid, profile, email (para el inicio de sesión); Aplicación User.Read.All (para leer en la sincronización) o User.ReadWrite.All si también se va a escribir en Microsoft 365. Después, Conceder consentimiento de administrador. Vía fácil: el asistente de Google / Microsoft.
5. En la página de Información general, copia el ID de directorio (inquilino) y el ID de aplicación (cliente).

2. Conexión:

1. En WordPress, abre la pantalla Microsoft 365.
2. Rellena los cuadros Inquilino (ID del inquilino o nombre de dominio), ID de aplicación (cliente) y Secreto de cliente.
3. Para Iniciar sesión con Microsoft, marca Botón «Iniciar sesión con Microsoft» en la página de acceso.
4. Haz clic en Guardar.

Consejo: Si usas Dynamics 365, el mismo registro de aplicación se usa también en la conexión del CRM. Para la sincronización del directorio, elige Microsoft 365 (Entra ID) en la pantalla Sincronización con Google (consulta Sincronización del directorio).

Importante:

• Solo se aceptan las cuentas de este inquilino y los dominios permitidos (en la pantalla Espacio personal); se rechazan las cuentas personales y las de otras organizaciones.
• Renueva el secreto de cliente en Entra antes de que caduque y vuelve a escribirlo aquí; si caduca, el inicio de sesión con Microsoft, Teams y Dynamics dejan de funcionar.
• En Microsoft 365, la firma de Outlook no se puede escribir desde fuera; la firma se configura con una regla de servidor (consulta Firma de Outlook: regla de servidor de Exchange).

Inicio de sesión único (SAML)

Para quién: Admin; administrador de Okta, Microsoft Entra ID, Google Workspace, OneLogin, JumpCloud, AD FS o Keycloak · Dónde: Admin → Integraciones → Inicio de sesión único (SAML) · Versión: 0.99.53

Para qué sirve: Los empleados entran con un solo clic con el proveedor de identidad (IdP) de la empresa. En la pantalla de acceso tocan el botón «Iniciar sesión con …», inician sesión en la propia pantalla del proveedor de identidad (con su contraseña y su verificación en dos pasos) y vuelven a Prozence. La contraseña nunca llega a Prozence. También se puede entrar desde el icono de "Mis aplicaciones" de Okta o de Entra.

Antes de empezar:

• Debes tener permiso para crear aplicaciones en el proveedor de identidad.
• La dirección de correo que envía el proveedor de identidad debe ser uno de los dominios de correo permitidos (consulta 10. Administración y configuración) y debe coincidir con el registro de un empleado publicado y que no se haya ido en Prozence. Quien esté en el proveedor de identidad pero no tenga registro en Prozence no puede entrar; para crear empleados automáticamente, consulta Aprovisionamiento automático de usuarios con SCIM.

1. Aplicación en el proveedor de identidad:

1. Haz clic en Admin en el menú de la izquierda, en Integraciones del grupo Empresa y luego en la pestaña Inicio de sesión único (SAML).
2. Introduce los valores del cuadro 1. Cree la aplicación Prozence en el proveedor de identidad en una aplicación SAML 2.0 nueva del proveedor de identidad. Copiar, junto a cada fila, lleva el valor al portapapeles.
   • ID de entidad (Audience URI / SP Entity ID / Identifier): https://ornek.invalid/kartvizit/giris/saml/metadata/
   • URL de ACS (Single sign-on URL / Reply URL): https://ornek.invalid/kartvizit/giris/saml/acs/
   • URL de metadatos: Si el proveedor de identidad acepta una dirección de metadatos, puedes dar esta en lugar de los dos primeros valores.
   • URL de inicio de sesión (Sign-on URL, opcional): https://ornek.invalid/kartvizit/giris/saml/
3. Pon el formato de NameID en dirección de correo (EmailAddress). La respuesta o assertion debe estar firmada con SHA-256; deja desactivado el cifrado de la assertion.
4. En el proveedor de identidad, asigna a esta aplicación los empleados o los grupos que la van a usar.

2. Datos del proveedor de identidad:

1. Pega el XML de metadatos o la dirección de metadatos del proveedor de identidad en el cuadro Metadatos del proveedor de identidad (XML o URL de metadatos) y haz clic en Rellenar desde los metadatos. Se rellenan ID de entidad del proveedor de identidad (Issuer / Entity ID), URL de inicio de sesión único (SSO URL, HTTP-Redirect) y Certificado de firma (X.509, PEM). Este paso no guarda.
   • Si no hay metadatos, rellena a mano los tres campos. Pega el certificado tal como empieza, con -----BEGIN CERTIFICATE-----.
2. En el cuadro Nombre visible, escribe el nombre del proveedor de identidad (p. ej. Okta). En el botón de acceso aparece "Iniciar sesión con Okta"; si lo dejas vacío, "Iniciar sesión con cuenta corporativa (SSO)".
3. Si el proveedor de identidad no envía el correo en el NameID sino en un atributo, escribe el nombre del atributo (p. ej. email) en Atributo de correo. Si queda vacío, el correo se lee del NameID.
4. Haz clic en Guardar. Debajo aparecen el asunto del certificado guardado, su fecha de caducidad y su huella SHA-256. Si caduca en menos de 30 días, aparece la insignia naranja Caduca en 30 días; si ya ha caducado, la insignia roja Caducado.

3. Prueba y botón de acceso:

1. En el cuadro 3. Pruebe el inicio de sesión, haz clic en Probar inicio de sesión. Inicia sesión en la pantalla del proveedor de identidad; después se vuelve a esta pestaña. La prueba no inicia sesión a nombre de nadie y funciona también con el botón de acceso desactivado.
2. Si dice Última prueba correcta, comprueba las filas Correo recibido y Empleado coincidente. Al abrir Datos recibidos se listan el NameID y los atributos que ha enviado el proveedor de identidad. Si dice Última prueba fallida, debajo se indica el motivo (p. ej. certificado, Audience, correo no registrado).
3. Marca Mostrar el botón del proveedor de identidad en la pantalla de inicio de sesión y haz clic en Guardar. La insignia de la parte superior de la pestaña pasa a Botón de inicio de sesión activado; el botón aparece en la pantalla de acceso.

Consejo:

• En el acceso desde el icono de "Mis aplicaciones" de Okta o de Entra, el flujo de Prozence se inicia de nuevo por sí mismo; como la sesión en el proveedor de identidad ya está abierta, el empleado no escribe la contraseña por segunda vez.
• Cuando el proveedor de identidad renueve el certificado de firma, pega el antiguo y el nuevo juntos en el cuadro Certificado de firma (como máximo 3); cuando termine el cambio, borra el antiguo y guarda de nuevo.
• En la parte superior de la pestaña se ven la hora del Último inicio de sesión correcto, el número de accesos y, si lo hay, el último error. En el cuadro Otras conexiones de la pestaña Estado también hay una fila Inicio de sesión único (SAML).
• En la aplicación móvil de Prozence, este botón también se abre en el navegador del teléfono; al terminar el acceso se vuelve a la aplicación (consulta 20. App móvil de Prozence).

Importante:

• Con el botón activado, las demás vías de acceso (Google, Microsoft, código por correo y por SMS, invitación) siguen funcionando. En esta versión no existe la obligación de acceder solo con SAML.
• No se admiten assertions cifradas ni firmas SHA-1. No hay cierre de sesión único (Single Logout): salir de Prozence no cierra la sesión del proveedor de identidad.
• El acceso debe completarse en el navegador en el que se inició. Un acceso que se traslada a otro dispositivo o navegador da el error "El acceso no se inició en este navegador. Inténtalo de nuevo."
• En el sitio de prueba no se pudo mostrar con un inquilino real de Okta / Entra; los valores de la imagen son ficticios.

Firma de Outlook: regla de servidor de Exchange

Para quién: Administrador de la aplicación y administrador global de Microsoft 365 o administrador de Exchange · Dónde: Admin → Comunicación → Firma de correo → Distribución → Firma de Outlook (Microsoft 365): regla de servidor · Versión: 0.81.0 (destinatario interno / externo 0.86.0)

Para qué sirve: Microsoft 365 no permite escribir la firma desde fuera en el Outlook de la persona. En su lugar, la firma se configura como una regla en Exchange Online y se añade al enviar. Se añade a todos los correos que salen del Outlook de escritorio, web y teléfono.

Antes de empezar: Debe estar elegida la Plataforma de correo = Microsoft 365. En los perfiles de Microsoft 365 de los usuarios deben estar rellenos el nombre visible, el cargo y el teléfono móvil; la firma se genera con estos datos.

1. En la sección Según el destinatario, elige una opción:
   • Una regla: la misma firma para todos (predeterminado);
   • Dos reglas: firmas distintas para destinatarios internos y externos.
2. Si quieres, escribe en el cuadro Grupos de distribución sin banners (opcional) una dirección por línea de un grupo de distribución de Microsoft 365 o de un grupo de seguridad con correo habilitado (p. ej. yonetim@ornek.invalid) y haz clic en Guardar grupos. A los correos que envíen los miembros de esos grupos se les añade la firma sin banner.
3. Marca, si quieres, la casilla Añadir solo a correos enviados fuera de la empresa.
4. Abre Vista previa (con una persona de ejemplo) y comprueba la firma. En el cuadro figura la longitud de la firma (p. ej. "4949 / 5000 caracteres").
5. Haz clic en Descargar archivo de firma (.html) y en Descargar comandos de instalación (.ps1). Coloca todos los archivos en la misma carpeta.
6. El administrador global de Microsoft 365 o el administrador de Exchange ejecuta los comandos en esa carpeta en Windows PowerShell. La primera vez se instala el módulo ExchangeOnlineManagement. Para ver los comandos sin ejecutarlos, abre Mostrar comandos.
7. Pide a los empleados que quiten su propia firma en Outlook; si no, en el correo aparecerán dos firmas.

Consejo: Los botones "Guardar en contactos" y "Tarjeta de visita digital" redirigen a la tarjeta de la persona mediante la dirección de correo. En las cadenas de respuestas, la firma no se añade por segunda vez.

Importante:

• La regla de servidor es una única firma para toda la empresa. Las asignaciones de las plantillas por persona, departamento y empresa no se pueden aplicar en Outlook; la plantilla elegida se aplica a todos.
• En la firma de Outlook solo aparecen los banners cuyo destino es "Todo el mundo". Los banners dirigidos a un departamento o a una persona no aparecen.
• Si la firma supera los 5.000 caracteres, se acorta (p. ej. se quitan las direcciones de las oficinas). En esta vía no hay foto, enlaces personalizados, analítica de la firma ni nota de fuera de la oficina.
• Si usas Google Workspace, no hace falta; las firmas se escriben de forma centralizada en Gmail.

Conexión con Yandex 360 y escritura de la firma

Para quién: Admin; administrador de la organización de Yandex 360 · Dónde: Admin → Integraciones → Yandex 360; Admin → Comunicación → Firma de correo → Distribución · Versión: 0.99.55

Para qué sirve: Si tu empresa usa Yandex 360 para el correo, la firma de cada empleado se escribe de forma centralizada en su propia dirección de Yandex 360, sin que el empleado tenga que hacer nada. Con la misma conexión, la lista de personal se sincroniza con el directorio de Yandex 360 (vista previa y confirmación; consulta Sincronización del directorio). Para añadir tarjetas por correo, el buzón compartido se conecta aparte por IMAP (consulta 12. Administración del directorio de clientes).

Antes de empezar:

• Debes tener una cuenta de administrador en la organización de Yandex 360.
• Para escribir las firmas, la plataforma de correo debe estar en Yandex 360.

1. Aplicación OAuth y token:

1. En el menú de la izquierda, haz clic en Admin, en el grupo Empresa haz clic en Integraciones y después en la pestaña Yandex 360.
2. Con la cuenta de administrador de la organización, crea una aplicación nueva en oauth.yandex.com. Como plataforma elige "Servicios web"; como dirección de redirección puedes escribir https://oauth.yandex.com/verification_code.
3. En la sección de acceso a datos de la aplicación, elige los permisos del cuadro 1. Cree la aplicación OAuth de Yandex y obtenga un token y guarda:
   • directory:read_users: leer a los empleados (necesario);
   • directory:read_departments: leer los nombres de los departamentos (necesario);
   • ya360_admin:mail_read_user_settings: leer la firma (necesario);
   • ya360_admin:mail_write_user_settings: escribir la firma (necesario);
   • directory:write_users: escribir el cargo y el departamento en Yandex 360 (opcional).
4. Escribe el valor ClientID de la aplicación en el campo ClientID de la aplicación OAuth (opcional) y haz clic en Guardar. Aparece el enlace Obtener token ↗.
5. Abre Obtener token ↗ con la sesión del administrador de la organización iniciada y concede el permiso. Copia el token que aparece en la página.

2. Datos de conexión:

1. En el campo ID de la organización (org ID) escribe el número de tu organización (panel de administración de Yandex 360 → Perfil de la organización; p. ej. 4815162).
2. Pega el token en el campo Token OAuth.
3. Si quieres, marca:
   • Actualizar automáticamente la firma de Yandex 360 cuando cambie la firma: al guardar a una persona o al cambiar un ajuste de la empresa (dirección, pie de texto, logotipo), solo se actualiza la firma de Yandex de la persona cuya firma ha cambiado;
   • Sincronizar el personal desde el directorio de Yandex 360: la comparación del directorio se hace con Yandex 360 en lugar de con Google o Microsoft.
4. Haz clic en Guardar. La insignia de la parte superior de la pestaña pasa a Conectado.

3. Prueba:

1. En el cuadro 3. Pruebe la conexión, haz clic en Probar conexión. Cada permiso de lectura se prueba con una lectura inofensiva; no se escribe nada.
2. Si pone Última prueba correcta, comprueba el número de empleados de Yandex 360 y la insignia Funciona, Falta permiso o No probado de cada permiso. Los permisos de escritura no se pueden probar sin escribir; se ven en la primera escritura, por eso se quedan en No probado.

4. Escribir las firmas:

1. En Admin → Firma de correo → Distribución, elige Yandex 360 como Plataforma de correo y haz clic en Guardar. Se abre el cuadro Yandex 360: escritura central; arriba pone Organización de Yandex 360 conectada:.
2. En la sección Acciones masivas, haz clic en Escribir la firma de todos en Yandex y confirma. La firma de todas las personas publicadas se escribe en Yandex 360.
3. Sigue el resultado en la lista Estado de la firma por persona. Para una sola persona, usa los botones Escribir en Yandex, Comprobar y Restaurar anterior de su fila. Comprobar Yandex (todos) compara la firma que hay en Yandex con la firma actual.
4. Para avisar a los empleados, haz clic en Enviar el correo informativo a todos. El correo informativo explica dónde aparece la firma en Yandex Mail.

Consejo:

• La firma se escribe para la dirección propia de la persona y se establece como firma predeterminada. No se tocan las firmas de las demás direcciones del mismo buzón, el nombre del remitente ni la dirección de remitente predeterminada.
• En la primera escritura se guarda el ajuste de firma que la persona tenía en Yandex; Restaurar anterior lo vuelve a poner.
• En el cuadro Otras conexiones de la pestaña Estado hay una fila Yandex 360 (firma, directorio).

Importante:

• El token es como una contraseña: se guarda cifrado solo en el servidor y no vuelve a la pantalla; solo se ven sus cuatro últimos dígitos. El token es válido durante aproximadamente un año; cuando caduque, consigue uno nuevo y pégalo. Quitar el token detiene la escritura de firmas y la sincronización del directorio de Yandex.
• No se escribe firma en una cuenta de Yandex desactivada o de alguien que ya se ha ido de la empresa.
• Desde los sitios de prueba y de staging no se escriben firmas en Yandex; solo escribe el sitio real.
• Los correos informativos y de presentación no se envían solos; se envían con el botón.
• No se pudo mostrar en el sitio de prueba con una organización real de Yandex 360; los valores de las imágenes son ficticios.

Conexión con Zoho Mail y escritura de la firma

Para quién: Admin; administrador de la organización de Zoho Mail · Dónde: Admin → Integraciones → Zoho Mail; Admin → Comunicación → Firma de correo → Distribución · Versión: 0.99.56

Para qué sirve: Si tu empresa usa Zoho Mail para el correo, la firma de cada empleado se escribe de forma centralizada en Zoho Mail como firma de administrador llamada "Prozence" y se asigna a la dirección de trabajo de la persona. No se tocan las firmas que el empleado haya creado él mismo en Zoho. Para añadir tarjetas por correo, el buzón compartido se conecta por IMAP (consulta 12. Administración del directorio de clientes).

Antes de empezar:

• Debes tener una cuenta de administrador en la organización de Zoho Mail.
• Busca el ID de la organización (zoid) en la consola de administración de Zoho Mail, en Organización → Datos de la organización.
• Averigua tu centro de datos por el dominio de tu dirección de Zoho Mail (p. ej. mail.zoho.eu → Europa (zoho.eu)).
• Para escribir las firmas, la plataforma de correo debe estar en Zoho Mail.

1. Self Client:

1. En el menú de la izquierda, haz clic en Admin, en el grupo Empresa haz clic en Integraciones y después en la pestaña Zoho Mail.
2. En el cuadro 2. Introduzca los datos de conexión, elige el Centro de datos. El enlace Zoho API Console ↗ lleva a la consola de ese centro de datos.
3. Abre la Zoho API Console con la cuenta de administrador de la organización y crea un "Self Client".
4. Escribe los valores de la pestaña "Client Secret" en los campos ID de cliente (Client ID) y Clave secreta (Client Secret).
5. En la pestaña "Generate Code", escribe como ámbito ZohoMail.organization.accounts.ALL, elige una duración de 10 minutos, escribe una descripción y genera el código.

2. Conexión:

1. En el campo ID de organización (zoid) escribe el ID de la organización (p. ej. 74185296).
2. En unos minutos, pega el código que has generado en el campo Código (Generate Code).
3. Si quieres, marca Actualizar la firma de Zoho Mail automáticamente cuando cambie la firma. Al guardar a una persona o al cambiar un ajuste de la empresa (dirección, pie de texto, logotipo), solo se actualiza la firma de Zoho de la persona cuya firma ha cambiado.
4. Haz clic en Guardar. Prozence convierte el código en un token de renovación sin caducidad; la insignia de la parte superior de la pestaña pasa a Conectado.

3. Prueba:

1. En el cuadro 3. Pruebe la conexión, haz clic en Probar conexión. Se obtiene un token de acceso y se leen la lista de empleados y las firmas de administrador de un empleado; no se escribe nada.
2. Si pone Última prueba correcta, comprueba el número de usuarios de Zoho Mail y las insignias Funciona o No probado de las filas. El permiso de escritura no se puede probar sin escribir; se ve en la primera escritura, por eso se queda en No probado.

4. Escribir las firmas:

1. En Admin → Firma de correo → Distribución, elige Zoho Mail como Plataforma de correo y haz clic en Guardar. Se abre el cuadro Zoho Mail: escritura central; arriba pone Organización de Zoho Mail conectada:.
2. En la sección Acciones masivas, haz clic en Escribir la firma de todos en Zoho y confirma.
3. Sigue el resultado en la lista Estado de la firma por persona. Para una sola persona, usa los botones Escribir en Zoho y Comprobar de su fila. Comprobar Zoho (todos) compara la firma de Prozence que hay en Zoho con la firma actual.
4. Para avisar a los empleados, haz clic en Enviar el correo informativo a todos. El correo informativo explica dónde aparece la firma en Zoho Mail.

Consejo:

• La firma de Prozence se escribe de modo que se coloque encima de la cita. Como la firma se asigna a la dirección de trabajo de la persona, se usa en los correos escritos desde esa dirección; si no aparece sola en un correo nuevo, el empleado elige la firma de Prozence para su dirección de trabajo en Zoho Mail → Ajustes → Firma.
• Quitar de Zoho, en la fila de la persona, borra solo la firma de Prozence; las firmas propias del empleado se conservan.
• En el cuadro Otras conexiones de la pestaña Estado hay una fila Zoho Mail (firma).

Importante:

• La clave secreta y el token de renovación se guardan cifrados solo en el servidor y no vuelven a la pantalla; en pantalla solo se ven los cuatro últimos dígitos. El código es de un solo uso; el mismo código no se acepta por segunda vez. Quitar conexión detiene la escritura de firmas en Zoho; las firmas ya escritas se quedan en Zoho.
• Si cambian el centro de datos o el ID de cliente, el token de renovación anterior deja de valer; vuelve a conectar con un código nuevo.
• No se escribe firma en un buzón de Zoho Mail cerrado o bloqueado.
• Desde los sitios de prueba y de staging no se escriben firmas en Zoho; solo escribe el sitio real.
• En esta versión no hay sincronización del directorio con Zoho Mail.
• No se pudo mostrar en el sitio de prueba con una organización real de Zoho Mail; los valores de las imágenes son ficticios.

Canales de chat (Slack, Teams, Google Chat)

Para quién: Admin · Dónde: Admin → Integraciones → Canales de chat · Versión: 0.72.0 (en 0.99.13 pasó de Conexiones a Integraciones; la línea de dirección guardada, en 0.99.14)

Para qué sirve: Los eventos que elijas (anuncio para toda la empresa, comprobación de seguridad, aviso urgente de seguridad y salud laboral…) llegan también al canal de chat de la empresa. Es una notificación en un solo sentido; para la comunicación entre empleados, consulta Configuración de Mensajes (Google Chat).

Antes de empezar: En la aplicación de chat, crea un "webhook entrante" para el canal y copia su dirección:

• Slack: Aplicaciones → Incoming Webhooks → elige el canal. La dirección tiene la forma https://hooks.slack.com/services/….
• Microsoft Teams: en el canal, ••• → Flujos de trabajo → "Post to a channel when a webhook request is received". La dirección termina en …logic.azure.com o …powerplatform.com.
• Google Chat: abre el espacio → arriba, el nombre del espacio → Aplicaciones e integraciones → Webhooks → Añadir webhook → copia el enlace. La dirección tiene la forma https://chat.googleapis.com/v1/spaces/….

1. Abre la pestaña Integraciones → Canales de chat.
2. Marca la casilla Enviar a canales de chat.
3. Haz clic en + Añadir canal.
4. En la lista Tipo, elige Slack, Microsoft Teams, Google Chat o Webhook genérico.
5. Escribe el Nombre del canal (p. ej. "#general", "Toda la empresa") y la Dirección del webhook entrante.
6. Marca los Eventos a enviar:
   • Anuncios y políticas para toda la empresa;
   • Comprobación de seguridad iniciada (toda la empresa);
   • Comprobación de seguridad terminada (solo cifras);
   • Aviso de seguridad urgente (tipo y lugar);
   • Nuevo artículo público de la wiki;
   • Encuesta de pulso iniciada;
   • Nuevo empleado (nombre y fecha de inicio).
7. Deja marcada la casilla Este canal está activo. Haz clic en Guardar canales de chat. Aparece "Guardado. Prueba el canal con "Enviar mensaje de prueba"."
8. Con Enviar mensaje de prueba, bajo el canal, prueba la conexión.

Resultado: En la tarjeta del canal guardado se ven la línea "Dirección guardada: chat.googleapis.com/…" y los últimos cuatro caracteres de la dirección. Si aún no se ha hecho ninguna prueba, pone "(aún no se ha enviado ningún mensaje de prueba)". Después aparece "Último envío correcto: …" o "Último error: …".

Errores frecuentes y avisos:

Consejo: Puedes definir hasta 10 canales. Para detener un canal sin eliminarlo, desmarca Este canal está activo; para eliminarlo, haz clic en Quitar. Con el tipo Webhook genérico aparece la Clave de firma (para verificar en el sistema receptor); se cambia con Renovar la clave al guardar.

Importante:

• A los canales no se envían datos personales: se envían el título y el resumen del anuncio, el título de la comprobación y el tipo y lugar del aviso urgente de seguridad y salud laboral. El evento "Nuevo empleado" incluye el nombre del empleado; actívalo solo si quieres.
• Los anuncios y las comprobaciones específicos de un departamento no van al canal.
• La dirección del webhook se oculta en pantalla una vez guardada. Solo se aceptan https y los dominios oficiales de cada tipo.
• El Webhook genérico envía JSON a tu propio sistema; la cabecera X-Prozence-Imza es la firma HMAC-SHA256.

Configuración de Mensajes (Google Chat)

Para quién: Admin; administrador del proyecto de Google Cloud · Dónde: Admin → Integraciones → Mensajes · Versión: 0.99.15 (guía paso a paso, resumen de la configuración guardada y activado de forma predeterminada en 0.99.18; chats de reuniones en 0.99.19)

Para qué sirve: Los empleados se escriben entre sí y con toda la empresa sin salir de la aplicación; la infraestructura es el Google Chat de la empresa. Cada empleado conecta su cuenta de Google una vez; los mensajes salen con su propio nombre y también se ven en Google Chat. Prozence no almacena mensajes. Para saber cómo usa Mensajes el empleado, consulta 06. Tablón e intranet.

Antes de empezar:

• La empresa debe usar Google Workspace; no se pueden conectar cuentas personales de Gmail.
• Debes poder hacer cambios en el proyecto de Google Cloud donde está el cliente de inicio de sesión con Google.

Configuración de Google Cloud (una vez): Abre la sección Configuración de Google Cloud (una vez) — paso a paso, bajo la pestaña. Las pantallas de Google Cloud están en inglés; los nombres de los botones se escriben entre comillas, tal como aparecen en Google. El enlace Abrir ↗ de cada paso abre la página correcta del proyecto correcto en una pestaña nueva.

1. En Google Cloud, abre el proyecto donde está el cliente de inicio de sesión con Google (selector de proyecto de arriba a la izquierda).
2. Activa la API de Google Chat: en la página que se abre, pulsa el botón "Enable". Si aparece "Manage", ya está activada.
3. Define la aplicación de Chat: en la página "Configuration", copia con Copiar los valores de Nombre de la aplicación (App name), Dirección del icono (Avatar URL) y Descripción (Description) y pégalos. Deja "Interactive features" desactivado. Abajo del todo, "Save".
4. Audiencia: en la página "Audience", "User type" debe ser "Internal". Si pone "External", pulsa "Make internal".
5. Permisos: en la página "Data Access", "Add or remove scopes" → en el cuadro "Manually add scopes" pega las líneas de Permisos: (openid, email, …/auth/chat.spaces, …/auth/chat.messages, …/auth/chat.memberships.readonly) → "Add to table" → "Update" → "Save".
6. Dirección de retorno: en la página "Clients", abre el cliente de tipo "Web application"; "Authorized redirect URIs" → "+ Add URI" → pega la dirección de la línea Dirección de retorno: (con la forma https://ornek.invalid/kartvizit/mesaj/google/), incluida la / final → "Save".
7. Secreto del cliente: en la misma página, ⓘ → "Additional information" → "Client secrets" → "Add secret". Copia el valor que empieza por "GOCSPX-".
8. Vuelve a esta página (el formulario de abajo).
9. Prueba: actualiza la página → en la barra superior, Mensajes → Conectar con Google Chat → elige tu cuenta de empresa → "Allow".

Guardar en Prozence:

1. Deja marcada la casilla Mensajes activado (botón «Mensajes» en la barra superior).
2. Pega el ID de cliente en el campo ID de cliente OAuth. Si ya hay un cliente de inicio de sesión con Google definido, basta con hacer clic en Usar este.
3. Pega el valor que empieza por "GOCSPX-" en el campo Secreto del cliente.
4. En el campo Espacio de toda la empresa, abre en Google Chat el espacio general de la empresa y pega la dirección de la barra de direcciones. Si en los canales de chat hay un webhook de Google Chat, puedes hacer clic en Usar este (no se toma la clave del webhook, solo el ID del espacio).
5. En el campo Nombre que aparece en la lista, escribe el nombre del espacio (p. ej. "Toda la empresa").
6. Haz clic en Guardar. Aparece "Mensajes guardado. Los empleados verán el botón «Mensajes» cuando actualicen la página."; el estado pasa a Funciona.

Resultado: Si la configuración está guardada, en lugar del formulario aparece un resumen: Estado, ID de cliente OAuth, Secreto del cliente "Guardado (…últimos 4)", Espacio de toda la empresa, Chats de reuniones, Empleados conectados. Acciones: Editar (abre el formulario; Cancelar vuelve), Desactivar Mensajes / Activar Mensajes, Quitar todas las conexiones, Eliminar configuración.

Errores frecuentes y avisos:

Consejo: Para resolver problemas, mira la línea Último error de Google: de la pantalla: figuran la hora, el código HTTP, la operación y el mensaje de Google (no se escriben el nombre de la persona ni el contenido del mensaje).

Importante:

• Quitar todas las conexiones quita la conexión de Google Chat de todos los empleados; todos tendrán que volver a conectarse. Los mensajes de Google Chat no se borran.
• Si las invitaciones de chat internas de la empresa se aceptan a mano, en una conversación individual nueva el primer mensaje se escribe desde Google Chat. Si en la Consola de administración → Aplicaciones → Google Workspace → Google Chat → Invitaciones de chat activas la aceptación automática de las invitaciones internas, este paso no hace falta.

Webhook de eventos de personal

Para quién: Admin · Dónde: Admin → Integraciones → RR. HH. y contabilidad → Eventos de RR. HH. (webhook) · Versión: 0.99.31

Para qué sirve: En los eventos de recursos humanos que elijas (aprobación de una ausencia, pago de un gasto, empleado nuevo, baja, activo asignado…), se envía un JSON firmado a la dirección que indiques. Make, n8n o tu propio servidor pasan esos eventos a Logo, Mikro, Luca, Netsis o a tu asesoría de nóminas.

Antes de empezar: Prepara la dirección https:// que recibirá los eventos (p. ej. la dirección de webhook de un escenario de Make). El sistema receptor debe verificar la firma de Prozence.

1. Abre la pestaña RR. HH. y contabilidad.
2. Marca la casilla Enviar eventos de RR. HH. a la dirección.
3. En el campo Dirección (https), escribe la dirección del receptor.
4. En Eventos a enviar, desmarca los eventos que no quieras.
5. Si de verdad es necesario enviar al receptor el nombre de los tipos de ausencia que contienen datos de salud, marca la casilla Escribir en claro los tipos de permiso con datos de salud (…).
6. Haz clic en Guardar. En el primer guardado se genera la Clave de firma y aparece en el campo; introduce esa clave en el sistema receptor.
7. Haz clic en Enviar prueba. Al receptor llega el evento baglanti.deneme; se actualiza la línea Último envío correcto:.

Verificación de la firma (sistema receptor): X-Prozence-Imza = sha256= + HMAC-SHA256( X-Prozence-Zaman + "." + cuerpo sin procesar, clave de firma ). Rechaza las marcas de tiempo de más de 5 minutos; X-Prozence-Teslim permite distinguir la repetición del mismo evento.

Resultado: Un evento que no se puede enviar se reintenta hasta 6 veces, con intervalos de 5 min, 15 min, 1 h, 4 h y 12 h; con una respuesta 4xx pasa a Detenido. Los eventos pendientes y detenidos aparecen en la tabla Cola (Evento, Hora, Prueba, Estado); hay botones Reintentar todo ahora y Quitar detenidos. Cuando el envío se detiene, a los Admin les llega, como máximo una vez al día, la notificación Se ha detenido el envío del webhook de RR. HH.

Errores frecuentes y avisos: "La dirección debe empezar por https://.", "Escribe la dirección para poder enviar.", "Guarda primero la dirección." (Enviar prueba sin guardar).

Importante:

• En los eventos van el nombre, el correo, el número de empleado y el departamento del empleado. Asegúrate de que el sistema receptor figure en el texto informativo para los empleados.
• Una vez confirmado Quitar detenidos, esos eventos no se vuelven a enviar.
• No se hacen solicitudes a direcciones de la red interna.

Exportación al programa de nóminas

Para quién: Admin; además los responsables que ven el control horario y las personas autorizadas de RR. HH. (ausencias) desde la pantalla de registro de horas · Dónde: Admin → Integraciones → RR. HH. y contabilidad → Exportación al programa de nóminas · Versión: 0.99.31

Para qué sirve: Descarga el registro de horas del mes y las ausencias aprobadas con columnas adecuadas para la importación en Excel de tu programa de nóminas. Una fila por empleado: días trabajados, horas normales / extra / de festivos, días de ausencia por tipo, número de días de ausencia para la seguridad social (SGK) y su motivo, y días de cotización a la SGK.

1. En el cuadro Exportación al programa de nóminas, elige el mes (predeterminado: el mes pasado).
2. Elige el programa: General (todas las columnas), Logo (Bordro Plus / j-HR), Mikro (Nóminas / RR. HH.), Luca Bordro o Netsis (Logo Netsis HR). Debajo aparece la nota específica del programa.
3. Haz clic en Descargar Excel (dos hojas: Registro de horas, Ausencias) o en Descargar CSV (parte de horas). Aparece "N empleados exportados."

Consejo: El mismo archivo se obtiene también con el botón Exportar al programa de nóminas de la pantalla de registro de horas de la Jornada (consulta 29. Gestión de la jornada). La exportación de gastos está en Gasto → Contabilidad (consulta 18. Administración de gastos y contabilidad).

Importante:

• Códigos de días de ausencia para la SGK: 01 reposo (baja médica, maternidad), 15 absentismo, 20 permiso de viaje sin sueldo, 21 otro permiso sin sueldo, 12 varios motivos. En quienes se incorporan o se van durante el mes, corrige los días de cotización en el programa.
• El número de identidad (TC) no está en el archivo; la correspondencia se hace con el número de empleado.
• Los nombres de las columnas pueden cambiar según la versión del programa; en la pantalla de importación, asocia las columnas. Comprueba los días y las horas antes de la nómina.

Aplicación de Microsoft Teams

Para quién: Admin; administrador de Microsoft 365 / Teams · Dónde: Admin → Integraciones → Microsoft Teams · Versión: 0.99.35

Para qué sirve: Prozence se abre en Teams como aplicación personal: el empleado entra con su cuenta de Teams, sin iniciar sesión aparte; las notificaciones llegan también a la fuente de actividad de Teams; la pestaña Mis aprobaciones abre las aprobaciones pendientes.

Antes de empezar: La conexión con Microsoft 365 debe estar configurada. Si no lo está, en la pestaña aparecen la insignia "Microsoft 365 no conectado", el aviso "Configura primero la conexión con Microsoft 365 (inquilino, ID de cliente y clave secreta)." y el botón Ir a la pestaña Google / Microsoft.

1. En la sección Configuración (una vez), haz el paso 1 en el centro de administración de Entra: Registros de aplicaciones → la aplicación de Prozence → Exponer una API. Copia con Copiar los valores del URI del ID de aplicación (api://<tu dominio>/<ID de cliente>) y del Nombre del ámbito (access_as_user). Como Aplicaciones cliente autorizadas, añade los ID de Teams escritorio y móvil y de Teams web y marca el ámbito access_as_user.
2. En el paso 2, añade Permisos de API → Microsoft Graph → Permisos de la aplicación → TeamsActivity.Send; después, "Conceder consentimiento de administrador".
3. En el paso 3, haz clic en Descargar paquete de Teams (prozence-teams-<versión>.zip). En el centro de administración de Teams → Aplicaciones de Teams → Administrar aplicaciones → "Cargar", sube el paquete.
4. En el paso 4, en Directivas de configuración → Global (predeterminada para toda la organización) → Aplicaciones instaladas y aplicaciones ancladas, añade Prozence.
5. Arriba, marca la casilla Aplicación de Teams activada y haz clic en Guardar.
6. Haz clic en Probar ahora. Las filas aparecen con ✓ o ✗: Conexión con Microsoft 365, Aplicación de Teams, Marco de Teams (si la cabecera de seguridad del sitio bloquea Teams), Notificación de prueba (para ti) ("Enviada: mira la fuente de actividad en Teams.").

Resultado: Bajo el cuadro, la línea "Notificación de Teams: …" muestra el último envío correcto, el contador y los pendientes en la cola; si hay algún problema, pone "Último error (…): …". Cuando el empleado abre Prozence en Teams, entra automáticamente; al tocar la notificación, Prozence se abre en el registro correspondiente.

Errores frecuentes y avisos:

Importante:

• La notificación de Teams solo llega a la persona que tiene la aplicación instalada. Los botones Aprobar / Rechazar están en la pantalla de Prozence; dentro de Teams no hay una tarjeta aparte.
• Si la CSP del sitio restringe los orígenes de scripts, hay que añadir el dominio de scripts de Teams de Microsoft (res.cdn.office.net).
• El sitio de prueba no tiene un inquilino real de Microsoft 365; la pantalla de configuración se muestra con identificadores ficticios.

Creación de una clave de API REST

Para quién: Admin · Dónde: Admin → Integraciones → Claves de API → Nueva clave · Versión: 0.99.36 (permiso SCIM en 0.99.37)

Para qué sirve: Make, n8n, Zapier o tu propio software leen los datos de Prozence con estas claves; también pueden enviar anuncios y notificaciones. Los permisos de cada clave son independientes.

Antes de empezar: La API solo funciona con HTTPS. Si el sitio no usa HTTPS, aparece el aviso "El sitio no usa HTTPS: la API solo funciona con HTTPS."

1. Abre la pestaña Claves de API. Arriba aparecen la Dirección: (https://ornek.invalid/wp-json/prozence/v1/), un comando curl de ejemplo y la lista de puntos de acceso.
2. En la sección Nueva clave, en el campo Nombre escribe dónde se usará la clave (p. ej. "Make – nóminas").
3. En Permisos, marca solo las casillas necesarias.
4. Si quieres, elige la Fecha de fin (opcional).
5. Haz clic en Crear clave. Aparece "Clave creada. Cópiala ahora; no se volverá a mostrar."
6. Haz clic en Copiar, en la línea Clave:, y pega la clave en un lugar seguro (p. ej. en la conexión de Make).
7. Haz clic en Hecho, la guardé. La clave desaparece de la pantalla; en la lista solo queda su prefijo.

Puntos de acceso: GET calisanlar (sayfa, adet máx. 200, departman, ayrilanlar, degisen_sonra), GET calisanlar/{id}, GET departmanlar, GET izinler (bas, bit máx. 366 días, durum, calisan), GET puantaj (ay=YYYY-AA), POST duyurular, POST bildirimler (máx. 500 destinatarios; 2000 destinatarios al día por clave). La clave se envía con la cabecera Authorization: Bearer … o X-Prozence-Anahtar.

Errores frecuentes y avisos:

Importante:

• La clave se muestra solo en el momento de crearla; en el servidor solo se guarda su resumen (hash). Si la pierdes, crea una nueva.
• No envíes la clave en la dirección (en la cadena de consulta); la solicitud se rechaza ("No envíes la clave en la dirección; usa la cabecera Authorization: Bearer.").
• No compartas la clave en capturas de pantalla, por correo ni en el chat.

Gestión de claves de API y registro de solicitudes

Para quién: Admin · Dónde: Admin → Integraciones → Claves de API → Claves y Solicitudes recientes · Versión: 0.99.36

Para qué sirve: Supervisas el estado y el uso de las claves, y cierras o eliminas las que no hacen falta.

1. En la lista Claves, lee de cada clave el nombre, la insignia (Abierto, Desactivado, No válido), el prefijo, los permisos, quién la creó, la fecha de fin y el último uso ("Último uso: … · N" o "Aún no se ha usado").
2. Para detener una clave temporalmente, haz clic en Cerrar; para volver a abrirla, haz clic en Abrir.
3. Para eliminarla, haz clic en Eliminar; el botón pasa a ¿Eliminar? Sí, eliminar, haz clic de nuevo.
4. En la tabla Solicitudes recientes, sigue las últimas 30 solicitudes (Hora, Llave, Solicitud, Resultado). Las solicitudes con error aparecen en rojo.

Respuestas que puede recibir el sistema conectado:

Importante: Si la persona que creó la clave se va o se le quita el rol de Admin, la clave pasa a No válido: "Caducada o la persona que la creó ya no es Admin: las solicitudes se rechazan. Crea una clave nueva." Por eso crea las claves de integración con una cuenta de Admin permanente. En el registro, la dirección IP se guarda solo como resumen (hash).

Aprovisionamiento automático de usuarios con SCIM

Para quién: Admin; administrador de Microsoft Entra ID u Okta · Dónde: Admin → Integraciones → Claves de API → Aprovisionamiento de usuarios (SCIM 2.0) · Versión: 0.99.37

Para qué sirve: Microsoft Entra ID u Okta crean, actualizan y cierran empleados en Prozence automáticamente: nombre, correo, cargo, departamento, número de empleado, móvil, responsable. El empleado cuya cuenta se cierra pasa a "baja" (se cierran sus sesiones, su tarjeta deja de estar publicada; el registro no se elimina). Prozence no escribe nada en Entra / Okta.

1. En el cuadro Aprovisionamiento de usuarios (SCIM 2.0), haz clic en Copiar, en la línea URL del inquilino (Tenant URL): (con la forma https://ornek.invalid/wp-json/prozence/scim/v2).
2. Arriba, crea una clave con el permiso Aprovisionamiento de usuarios (SCIM) (consulta Creación de una clave de API REST). Esta clave se introduce en Entra / Okta como "Token secreto" (Secret Token / API Token).
3. Entra: Aplicaciones empresariales → Nueva aplicación → Cree su propia aplicación (fuera de la galería) → Aprovisionamiento → Automático. Introduce la URL del inquilino y la clave y pulsa "Probar conexión". En la asignación, desactiva Grupos; el departamento procede del campo "department" del usuario.
4. Okta: Applications → Create App Integration → SWA / SCIM 2.0 → Provisioning → Integration. SCIM connector base URL = URL del inquilino, Unique identifier = userName, autenticación: HTTP Header (Bearer).
5. Elige en la lista Empleado nuevo que llega y haz clic en Guardar.

Asignación: userName / correo de trabajo → correo · displayName o nombre + apellido → nombre · title → cargo · teléfono móvil → móvil · department → departamento · employeeNumber → número de empleado · manager → responsable (por su correo). Cuando se desactiva la cuenta (active=false) o se elimina, el empleado pasa a "baja"; si se vuelve a activar, la baja se revierte.

Consejo: En la primera configuración, prueba con un solo usuario usando "Probar conexión" y "Aprovisionamiento a petición" de Entra. Las solicitudes SCIM también se anotan en el registro de Solicitudes recientes. El límite por hora para SCIM es de 5000 solicitudes.

Importante:

• No se admiten grupos ni operaciones masivas; la foto no llega por SCIM (la sincronización del directorio sigue funcionando).
• No se abre un segundo registro con el mismo correo (409 "uniqueness").
• Para detener SCIM, haz clic en Cerrar o Eliminar en la clave; el aprovisionamiento de Entra recibe 401 y se detiene.
• No se pudo mostrar en el sitio de prueba con un inquilino real de Entra / Okta.

Cuenta de revisión de la tienda

Para quién: Admin · Dónde: Admin → Integraciones → Cuenta de revisión de la tienda · Versión: 0.99.38 (la opción "¿Qué debe ver en la app?", en 0.99.41)

Para qué sirve: Los revisores de Apple App Store / TestFlight y de Google Play entran en la aplicación móvil de Prozence con este empleado ficticio. No hace falta un buzón para esa dirección: el código no se envía por correo, sino que se usa un código fijo de 8 dígitos generado en pantalla. La cuenta no aparece en el directorio, en Equipo ni en las listas.

Antes de empezar: El inicio de sesión con código por correo debe estar activado. Si está desactivado, aparece el aviso "El inicio de sesión con código por correo está desactivado: la cuenta de revisión tampoco puede iniciar sesión. …"

1. Abre la pestaña Cuenta de revisión de la tienda. La insignia es Desactivado.
2. En el formulario Abrir la cuenta, comprueba la Dirección de correo (predeterminada apple-inceleme@<tu dominio>). No puede ser la dirección de un empleado real.
3. En el campo Días de validez (1–90), escribe la duración (predeterminada 30).
4. Haz clic en Abrir la cuenta y generar un código. La insignia pasa a Abierto; dentro del recuadro aparece la línea Código:.
5. Copia el código con Copiar y escríbelo en el campo de "datos de acceso para la revisión" de TestFlight / Play Console: como nombre de usuario, la dirección de correo; como contraseña, el código.
6. Haz clic en Vale, lo he guardado; el código desaparece de la pantalla.
7. En la sección ¿Qué debe ver en la app?, elige la vista. La elección se guarda al instante.
8. Cuando termine la revisión, haz clic en Cerrar la cuenta.

Resultado: En la página de inicio de sesión, el revisor escribe la dirección de correo, toca Enviar un código a mi correo y escribe este código en lugar del que llegaría por correo. En la vista Solo tarjeta de visita, en una pantalla en inglés ve su propia tarjeta de visita digital, su código QR, los botones Open my card, Add to contacts, Share y la explicación sobre Prozence; el idioma se cambia con el botón turco. Bajo el recuadro aparecen "Fin: …", "Último código: … · …", "Último inicio de sesión: … · total N" y "Intentos fallidos: N / 10".

Errores frecuentes y avisos:

Consejo: Abre la sección ¿Qué se le da al revisor?; allí se indica qué escribir en los campos de App Store Connect y Play Console.

Importante:

• El código es fijo (no es de un solo uso). Al generar un código nuevo, el anterior deja de valer al instante y el contador de intentos fallidos vuelve a cero. Cuando termine la revisión, cierra la cuenta.
• Con la Vista completa de empleado activada, en pantalla aparece un aviso: el revisor puede ver los datos de contacto de trabajo de los empleados. Cuando llegue la aprobación, vuelve a Solo tarjeta de visita. Al cerrar la cuenta, la vista vuelve automáticamente a Solo tarjeta de visita.
• No compartas el código en ningún sitio que no sea el formulario de la tienda.

Configuración de las notificaciones móviles (Firebase y APNs)

Para quién: Admin; titular de la cuenta de desarrollador que publica la aplicación móvil · Dónde: Admin → Integraciones → Notificaciones móviles · Versión: 0.99.39 (aplicación móvil 1.0.2)

Para qué sirve: Activa las notificaciones en el teléfono en la aplicación móvil de Prozence (Android e iPhone). Cuando el empleado pulsa Activar notificaciones en la aplicación, se registra su dispositivo; las aprobaciones, los anuncios, la jornada y todas las demás notificaciones llegan también al teléfono. Las notificaciones de la aplicación de pantalla de inicio del navegador (web push) son aparte y no necesitan esta configuración.

Antes de empezar:

• Para Android se necesita el archivo de clave (JSON) de la cuenta de servicio del proyecto de Firebase: Firebase → ⚙ Configuración del proyecto → Cuentas de servicio → "Generar nueva clave privada".
• Para iPhone se necesitan, en la cuenta de Apple Developer, la clave del Apple Push Notifications service (APNs) (archivo .p8), el Key ID y el Team ID: Certificates, Identifiers & Profiles → Keys → "+".
• Los archivos de clave son confidenciales: sube el archivo al servidor solo desde esta pantalla; no lo envíes por correo ni por chat.

Android — Firebase:

1. Abre la pestaña Notificaciones móviles. En la fila Android — Firebase, la insignia es Sin configurar.
2. Con el botón de selección de archivo, elige el archivo JSON de la cuenta de servicio que descargaste de Firebase.
3. Haz clic en Subir. La insignia pasa a Listo; debajo figuran el proyecto, la cuenta de servicio y la hora de la subida.

iPhone — Apple APNs:

1. En el campo Key ID, escribe el ID de clave de 10 caracteres de la página Apple Developer → Keys.
2. En el campo Team ID, escribe el ID de equipo de 10 caracteres de Apple Developer → Membership.
3. Cambia el valor del campo ID del paquete (Bundle ID) solo si tu empresa publica su propia compilación de la aplicación.
4. Con Archivo de clave .p8, elige el archivo de clave que descargaste de Apple.
5. Haz clic en Guardar. La insignia pasa a Listo.

Prueba:

1. Haz clic en Probar conexión. En las filas Android y iPhone aparece el resultado (si se puede obtener la clave de acceso de Google, si la clave de APNs firma).
2. En el teléfono, en la aplicación de Prozence, toca Mi perfil → Notificaciones → Activar notificaciones y después Enviar notificación de prueba.

Resultado: Arriba pone "Dispositivos registrados: Android N · iPhone N · N personas". Una persona puede registrar como máximo 5 teléfonos. Los tokens de dispositivo no válidos se eliminan automáticamente.

Errores frecuentes y avisos:

Importante:

• Las claves secretas no vuelven a la pantalla en ninguna respuesta. Para cambiarlas, sube el archivo nuevo.
• Quitar tiene dos pasos ("¿Seguro? Las notificaciones de Android se detienen" / "¿Seguro? Las notificaciones de iPhone se detienen"); al quitarlo, las notificaciones de esa plataforma se detienen.
• El contenido de la notificación no incluye la clave de conexión personal; al tocar la notificación se abre la página correspondiente de la aplicación.
• El sitio de prueba no tiene aplicación móvil ni clave real; la pantalla se muestra en el estado "Sin configurar". Para el lado del empleado, consulta 20. App móvil de Prozence.

Conexión con Zoom

Para quién: Administrador de la aplicación, administrador de la cuenta de Zoom · Dónde: Admin → Empresa → Marca e identidad → Plantillas del kit de identidad → Reunión → Conexión con Zoom · Versión: 0.90.0

Para qué sirve: Prozence sube por sí mismo los fondos de reunión al perfil de Zoom de los empleados. Cada empleado envía su propio fondo (nombre, cargo, QR) desde Mi kit de identidad con un solo toque; el conjunto común de fondos de la empresa se sube desde aquí a todos los empleados.

1. Entra en marketplace.zoom.us como administrador de tu cuenta de Zoom.
2. Develop → Build App → elige Server-to-Server OAuth App y ponle un nombre a la aplicación (p. ej. "Prozence").
3. En la página Information, rellena el nombre de la empresa y el correo de contacto.
4. En Scopes → Add Scopes, añade los tres ámbitos:
   • user:read:user:admin (buscar al usuario por correo);
   • user:write:virtual_background_files:admin (subir el fondo virtual);
   • user:delete:virtual_background_files:admin (borrar el fondo antiguo que subió Prozence).
5. En Activation → Activate your app, activa la aplicación.
6. Pega los valores de la página App Credentials en el cuadro Conexión con Zoom de Prozence: ID de cuenta (Account ID), ID de cliente (Client ID), Secreto de cliente (Client Secret).
7. Define las opciones:
   • Permitir que los empleados suban sus fondos personales a Zoom;
   • Actualizar automáticamente los fondos personales: si está activada, cuando cambian el nombre, el cargo o la plantilla del empleado, su fondo se renueva en Zoom como máximo una vez al día.
8. Haz clic en Guardar y después en Probar conexión. El estado, en lugar de No conectado, muestra que la conexión funciona.
9. Para subir el conjunto común, en la sección Subir el conjunto común a Zoom haz clic en Subir a todos los usuarios de Zoom.

Consejo: Del conjunto común se suben como máximo 5 imágenes (Zoom admite hasta 10 fondos virtuales por persona). La subida avanza a un ritmo de 20 personas por minuto; el progreso se ve en pantalla. Se listan los empleados a los que no se encuentra en Zoom por su correo.

Importante:

• El secreto de cliente no vuelve a mostrarse una vez guardado; solo se guarda en el servidor. Para quitar la conexión, usa Quitar conexión; los fondos que ya se subieron a Zoom no se borran.
• Hacer obligatorio el fondo virtual se hace desde el portal de administración de Zoom (indicación Hacer obligatorio el fondo virtual (portal de administración de Zoom)).
• Para las plantillas del kit de identidad, consulta 11. Gestión de marca, identidad y firma.

Apple Wallet y Google Wallet

Para quién: TI · Dónde: WordPress → Prozence Workplace → Wallet · Versión: 0.4.2 (tarjeta que se actualiza sola, 0.90.0)

Para qué sirve: Los empleados añaden su tarjeta de visita a la cartera del teléfono. La tarjeta se abre desde la pantalla de bloqueo y lleva el código QR de la tarjeta de visita. Cuando cambian el cargo, el teléfono o la foto, la tarjeta se actualiza sola; cuando el empleado se va, la tarjeta deja de ser válida.

Apple Wallet:

1. developer.apple.com → Certificates, IDs & Profiles → Identifiers → + → Pass Type IDs. Descripción "Prozence kartvizit"; el identificador, con el formato que sugiere la pantalla Wallet de WordPress: el dominio del sitio en orden inverso (p. ej. para ornek.invalid, pass.invalid.ornek.kartvizit). Si el sitio se abre por dirección IP o por localhost, no se genera la sugerencia; la pantalla muestra el ejemplo genérico: para ornek.com, pass.com.ornek.kartvizit.
2. Entra en el Pass Type ID creado y haz clic en Create Certificate. En el Mac, con Acceso a Llaveros → Asistente de Certificados → "Solicitar un certificado de una autoridad de certificación", genera la CSR y súbela. Haz doble clic en el certificado descargado para añadirlo a Acceso a Llaveros.
3. En Acceso a Llaveros, selecciona el certificado (junto con su clave), guárdalo con Exportar → .p12 y pon una contraseña.
4. En WordPress, abre la pantalla Wallet. Introduce el Pass Type ID, el ID de equipo (Team ID) (figura en developer.apple.com → Membership), el archivo del Certificado (.p12) y la Contraseña de .p12.
5. Haz clic en Guardar.

Google Wallet:

1. pay.google.com/business/console → Google Wallet API → abre una cuenta de emisor.
2. En "Usuarios", añade la cuenta de servicio de Google como "Desarrollador". En el proyecto de Google Cloud de la cuenta de servicio, activa la "Google Wallet API".
3. En el campo ID de emisor de Google Wallet, escribe el ID de emisor (Issuer ID, un número) y haz clic en Guardar.

Cuando la configuración está completa, los empleados ven en Mi tarjeta el botón Añadir a Apple Wallet (consulta 01. Tarjeta de visita digital y Kit de identidad). En la pantalla de Wallet puedes descargar una tarjeta de ejemplo en la sección Prueba, y ver en la sección Tarjeta que se actualiza sola el número de personas y dispositivos registrados y el resultado de la última notificación de actualización.

Consejo: La tarjeta que se actualiza sola exige HTTPS. Las tarjetas añadidas en versiones antiguas no llevan la dirección de actualización; las actualizaciones empiezan cuando el empleado vuelve a añadir la tarjeta una vez.

Importante:

• Si el certificado no se abre con la contraseña, no coincide con la clave o ha caducado, el botón de Apple Wallet no se muestra a los empleados. El estado figura en las pantallas de Wallet y Configuración; cuando faltan 30 días para el vencimiento del certificado, llega un aviso (consulta 16. Solución de problemas).
• El certificado y la contraseña no se muestran en ninguna respuesta, registro ni correo.