Integrazioni personalizzate
Panoramica
Le integrazioni personalizzate su Workplace sono servizi che utilizzano l'API Graph e l'API Account Management per estendere la funzionalità di Workplace.
Creando un'app di integrazione personalizzata, puoi mantenere sincronizzate le informazioni sui dipendenti con un servizio di identità, automatizzare i membri dei gruppi, eseguire backup dei post nei gruppi o automatizzare la pubblicazione in gruppi specifici in base all'attività in un altro servizio.
Inoltre, puoi utilizzare le integrazioni personalizzate per creare bot del gruppo e per la chat in grado di comunicare in gruppi su Workplace e in Work Chat.
Le integrazioni personalizzate sono adatte per lo sviluppo interno per la tua organizzazione (o per lo sviluppo su misura per l'uso esclusivo di un singolo cliente di Workplace). Se hai uno scopo diverso, ad esempio, offrire un'integrazione SaaS o PaaS a più clienti di Workplace, dovresti invece utilizzare app di terzi.
I token d'accesso generati per le integrazioni personalizzate non sono collegati all'utente che ha generato il token. Di conseguenza, i token non scadono né ruotano quando gli utenti vengono rimossi o disattivati. I token d'accesso rimangono validi finché non vengono ruotati manualmente da un amministratore di Workplace o l'integrazione personalizzata non viene disabilitata.
Creazione di app per Workplace
L'API Graph e l'API Account Management per Workplace sono API disponibili apertamente che possono essere chiamate da qualsiasi sviluppatore sappia come chiamare le API basate su REST. L'accesso a tali API viene controllato dalle app, con autorizzazioni specifiche e protetto da token d'accesso.
Solo gli amministratori di sistema di una community di Workplace possono creare app e generare token d'accesso in quella specifica community.
App e pagine
Quando crei un'integrazione personalizzata, vengono creati due oggetti:
- Un'app con autorizzazioni specifiche, come definito nella schermata Modifica app.
- Una pagina di tipo "bot", visibile esclusivamente nella tua community Workplace. Il nome della pagina riflette il nome della tua integrazione personalizzata e la sua immagine del profilo corrisponde all'icona che hai scelto al momento della creazione dell'integrazione personalizzata.
In fase di creazione dell'integrazione personalizzata, viene creato e visualizzato un token dell'integrazione personalizzata, che può essere utilizzato per leggere e scrivere post per conto della tua pagina.
Creazione di integrazioni personalizzate
Per creare un'app per Workplace, segui questi passaggi:
- Nel Pannello di amministrazione, apri la tab Integrazioni.
- Clicca sul pulsante Crea app.
- Scegli un nome e una descrizione pertinenti per l'app.
- Aggiungi un'immagine del profilo per l'app, che sarà utilizzata per ogni sua rappresentazione grafica, ad esempio se pubblica un post in un gruppo.
- Scegli le autorizzazioni necessarie per l'app, in base alla funzionalità di integrazione richiesta.
- Copia e memorizza in modo sicuro il token d'accesso che ti viene mostrato. Ne avrai bisogno per effettuare chiamate API.
Scopri di più
Per maggiori informazioni sulla creazione di app per Workplace o sui casi d'uso per le integrazioni personalizzate, leggi le seguenti guide.