Integraciones personalizadas
Información general
Las integraciones personalizadas en Workplace son servicios que usan la API Graph y la API de administración de cuentas para ampliar la funcionalidad de Workplace.
Al desarrollar una app de integración personalizada, puedes hacer que la información de los empleados se mantenga sincronizada con un servicio de identidad, automatizar las solicitudes de los miembros del grupo, realizar copias de seguridad de publicaciones en grupos o automatizar la publicación en grupos específicos según la actividad de otro servicio.
También puedes usar las integraciones personalizadas para crear bots de grupo y chat que se pueden comunicar en grupos en Workplace y Work Chat.
Las integraciones personalizadas son adecuadas para el desarrollo interno en tu organización o para desarrollo a medida con uso exclusivo de un único cliente de Workplace. Si tienes un objetivo diferente, por ejemplo, ofrecer una integración con SaaS o PaaS a varios clientes de Workplace, debes usar apps de terceros en su lugar.
Los tokens de acceso generados para integraciones personalizadas no se vinculan con el usuario que los generó. En consecuencia, los tokens no caducan ni se rotan cuando los usuarios se eliminan o se desactivan. Los tokens de acceso siguen siendo válidos hasta que un administrador de Workplace los rota manualmente o hasta que se inhabilita la integración personalizada.
Crear apps para Workplace
La API Graph y la API de administración de cuentas para Workplace son API disponibles que puede usar cualquier desarrollador que sepa cómo hacer llamadas a API basadas en REST. El acceso a estas API está controlado por apps, y usa permisos específicos y protección de tokens de acceso.
Solo los administradores del sistema de una comunidad de Workplace pueden crear apps y generar tokens de acceso en esa comunidad.
Apps y páginas
Cuando creas una integración personalizada, se crean dos objetos:
- Una app, que tiene permisos específicos, según se define en la pantalla "Editar app".
- Una página del tipo "bot", que solo está visible para tu comunidad de Workplace. El nombre de la página refleja el nombre de tu integración personalizada y la imagen de perfil coincide con el icono que elegiste al crear tu integración.
Se genera un token de integración personalizada y se muestra cuando creas la integración. Este token se puede usar para leer y escribir publicaciones de tu página.
Crear integraciones personalizadas
Si quieres crear una app para Workplace, sigue estos pasos:
- En el panel para administradores, abre la pestaña Integraciones.
- Haz clic en el botón Crear app.
- Elige un nombre y una descripción relevantes para la app.
- Agrega una imagen de perfil para la app. Se usará siempre que la app se represente visualmente; por ejemplo, si se hace una publicación en un grupo.
- Elige los permisos obligatorios para la app, según la funcionalidad de integración que necesites.
- Copia y almacena de forma segura el token de acceso que se muestra. Lo necesitarás cuando hagas llamadas a la API.
Más información
A fin de obtener más información sobre cómo crear apps para Workplace o para conocer casos de uso de integraciones personalizadas, consulta las guías a continuación.