Integraciones personalizadas
Información general
Las integraciones personalizadas de Workplace son servicios que usan la API Graph y la API de administración de cuentas para ampliar la funcionalidad de Workplace.
Si creas una aplicación de integración personalizada, puedes mantener sincronizada la información de los empleados con un servicio de identidades, automatizar las solicitudes de miembros de los grupos, realizar copias de seguridad de las publicaciones de los 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 chat y grupo que se puedan comunicar en grupos en Workplace y Work Chat.
Las integraciones personalizadas son adecuadas para el desarrollo interno de una organización (o para el desarrollo a medida para uso exclusivo de un único cliente de Workplace). Si tienes un objetivo diferente, por ejemplo, ofrecer una integración de SaaS o PaaS a varios clientes de Workplace, debes usar aplicaciones de terceros en su lugar.
Los identificadores de acceso generados para las integraciones personalizadas no están vinculados al usuario que ha generado el identificador. En consecuencia, los identificadores no caducan ni rotan cuando se eliminan o desactivan usuarios. Los identificadores de acceso son válidos hasta que un administrador de Workplace los hace rotar manualmente o se desactiva la integración personalizada.
Crear aplicaciones para Workplace
La API Graph y la API de administración de cuentas para Workplace son API disponibles de forma pública a las que puede llamar cualquier desarrollador que sepa cómo realizar llamadas a las API basadas en REST. El acceso a estas API está controlado por aplicaciones, con permisos específicos y protección mediante identificadores de acceso.
Solo los administradores del sistema de una comunidad de Workplace pueden crear aplicaciones y generar identificadores de acceso en esa comunidad.
Aplicaciones y páginas
Al crear una integración personalizada, se crean dos objetos:
- Una aplicación que tiene permisos específicos, según se define en la pantalla de edición de aplicaciones.
- Una página de tipo “Bot”, que solo es visible en tu comunidad de Workplace. El nombre de la página refleja el nombre de tu integración personalizada y la foto del perfil coincide con el icono elegido durante la creación.
Se genera un identificador de integración personalizada y se muestra al crear dicha integración. Este identificador se puede usar para leer y escribir publicaciones como tu página.
Crear integraciones personalizadas
A fin de crear una aplicación para Workplace, sigue estos pasos:
- En el panel para administradores, abre la pestaña Integraciones.
- Haz clic en el botón Crear aplicación.
- Elige un nombre y una descripción pertinentes para la aplicación.
- Añade una foto del perfil para la aplicación. Se usará siempre que la aplicación se represente visualmente; por ejemplo, si realiza una publicación en un grupo.
- Elige los permisos necesarios para la aplicación, según la funcionalidad de la integración que necesites.
- Copia y almacena de forma segura el identificador de acceso que se muestra. Lo necesitarás al realizar llamadas a la API.
Más información
A fin de obtener más información sobre la creación de aplicaciones para Workplace o descubrir los casos de uso de las integraciones personalizadas, consulta las guías que se indican a continuación.