Questo documento è stato aggiornato.
La traduzione in Italiano non è ancora completa.

Aggiornamento inglese: 8 ago 2025

Workplace from Meta sta per essere ritirato. Potrai continuare a usare Workplace fino al 31 agosto 2025. Visita il nostro Centro assistenza per maggiori informazioni.

Membro

Percorso `/{member-id}`

Rappresenta un oggetto User come membro di una community o di un gruppo di Workplace.

Percorso `/community/members`

Restituisce la lista di tutti gli account utente attuali. Richiede l'autorizzazione Gestione dei profili di lavoro.

Applicazione di filtri in base a `external_id`

Per filtrare gli utenti in base all'ID esterno, utilizza il parametro external_ids e passa una lista separata da virgole di ID esterni degli utenti desiderati.

Percorso `/community/organization_members`

Restituisce la lista degli utenti. Richiede l'autorizzazione Visualizzazione dei membri dei gruppi. Per impostazione predefinita, verranno mostrati gli account utente attivi. Invece, gli account utente disattivati possono essere mostrati utilizzando il parametro URL inactive=1.

Lettura

Restituisce un singolo oggetto User che rappresenta un utente di Workplace. È possibile accedervi tramite l'ID Workplace del membro o l'indirizzo e-mail utilizzato dal membro per l'accesso a Workplace.

/{member_id}
/{email_address}

Autorizzazioni

Per leggere le informazioni su un membro sono necessarie le autorizzazioni Visualizzazione del profilo di lavoro o Gestione degli account. Se un'integrazione sta utilizzando l'autorizzazione Gestione degli account ed è stata assegnata a gruppi specifici, non sarà in grado di accedere ad alcuni campi Member.

Campi

Nome del campo	Descrizione	Tipo
`id`	L'ID dell'account della persona.	`string`
`first_name`	Il nome della persona.	`string`
`last_name`	Il cognome della persona.	`string`
`email`	L'indirizzo e-mail principale della persona, utilizzato anche come nome utente su Workplace.	`string`
`title`	Il titolo della persona su Workplace, se impostato tramite l'API Account Management.	`string`
`organization`	L'organizzazione della persona su Workplace, se impostata tramite l'API Account Management.	`string`
`division`	La sezione della persona su Workplace, se impostata tramite l'API Account Management.	`string`
`department`	Il nome del reparto della persona su Workplace, se impostato tramite l'API Account Management.	`string`
`primary_phone`	Il numero di telefono principale indicato della persona. È mappato sulla voce `phoneNumbers` contrassegnata come `primary` sull'API Account Management.	`string`
`primary_address`	L'indirizzo principale indicato della persona. È mappato sulla voce `addresses` contrassegnata come `primary` sull'API Account Management.	`string`
`picture`	L'immagine del profilo della persona.	`url`
`link`	Link al profilo della persona.	`url`
`locale`	La lingua della persona.	`string`
`name`	Il nome e cognome della persona.	`string`
`name_format`	Il nome della persona formattato per gestire correttamente gli ordini in cinese, giapponese o coreano.	`string`
`updated_time`	L'orario dell'aggiornamento.	`datetime`
`account_invite_time`	L'ora dell'invito dell'account nel formato UTC.	`datetime`
`account_claim_time`	L'ora di attivazione dell'account nel formato UTC.	`datetime`
`account_deactivate_time`	L'ora di disattivazione dell'account nel formato UTC.	`datetime`
`external_id`	Un identificativo per il membro come definito dal cliente. Ogni membro PUÒ includere un valore non vuoto external_id impostato utilizzando l'API Account Management. Il valore dell'attributo external_id non sarà mai specificato da Workplace.	`string`
`start_date`	La data e l'ora di inserimento della persona nell'azienda, se impostate tramite l'API Account Management.	`datetime`
`about`	La biografia della persona.	`string`
`cost_center`	Identifica il nome di un centro di costo.	`string`
`impersonate_token`	Un token d'accesso del membro che consente un'integrazione per effettuare le chiamate per conto di una persona specifica. Impersonate è un'autorizzazione obsoleta. Non creare nuove funzionalità utilizzando questa autorizzazione, dal momento che è disponibile solo per le integrazioni personalizzate per cui è già in uso.	`string`
`claim_link`	Fornisce un link che può essere seguito da un utente per reclamare il proprio account Workplace (disponibile solo per gli utenti non reclamati).	`string`
`access_code`	Fornisce un codice di accesso che può essere seguito da un utente per reclamare il proprio account Workplace (disponibile solo per gli utenti non reclamati).	`string`
`work_locale`	La lingua dell'utente. Si tratta della lingua che Workplace utilizzerà per questo utente fino a quando non sarà disponibile un altro modo per determinare la lingua dell'utente (come un'impostazione della lingua del browser o del dispositivo)	`string` I valori validi sono la concatenazione del codice della lingua di due lettere ISO 639-1 con un trattino basso e il codice Paese di due lettere ISO 3166-1. Ad esempio, en_US indica la lingua inglese e il Paese Stati Uniti.
`frontline`	Le informazioni sullo stato di lavoro operativo dell'utente.	`object` (consulta l'esempio seguente)
`active`	L'attivazione dell'account utente, se presente.	`boolean`

Pubblicazione

Consultare l'API Account Management (Graph)

Eliminazione

Consultare l'API Account Management (Graph)

Aggiornamento

Consultare l'API Account Management (Graph)

Segmenti

Nome del segmento	Descrizione
`/events`	Eventi per questa persona. Per impostazione predefinita, non include gli eventi che la persona ha rifiutato o a cui non ha risposto.
`/feed`	Il feed di post (inclusi gli aggiornamenti di stato) e link pubblicati da questa persona.
`/conversations`	I messaggi su Workplace di una persona o della pagina del bot. Richiede l'autorizzazione Visualizzazione di tutti i messaggi per la visualizzazione delle conversazioni di una persona.
`/managers`	Il manager o i manager indicati di una persona.
`/reports`	I report indicati di una persona.
`/photos`	Le immagini del profilo del membro.
`/groups`	I gruppi associati a un membro.
`/phones`	I numeri di telefono associati a un membro.
`/skills`	Le competenze del membro.
`/badges`	I badge assegnati all'utente.
`/logout`	Consente la disconnessione di un utente da Workplace. Solo per la richiesta `POST`.
`/remove_profile_information`	Rimuove le informazioni del profilo per un utente disattivato. Solo per la richiesta `POST`.

Esempi

Recupero delle informazioni su un membro della community

Per ottenere il nome e l'indirizzo e-mail di un determinato membro:

GET /{member_id}?fields=email,name HTTP/1.1
Host: graph.facebook.com

Per ottenere l'ID di un membro dal suo indirizzo e-mail:

GET /{email_address} HTTP/1.1
Host: graph.facebook.com

Per mostrare i membri dell'azienda in base all'ID esterno degli utenti:

GET /community/members?external_ids=12356,abc123 HTTP/1.1
Host: graph.facebook.com

Per mostrare i membri dell'azienda, compresi gli account disattivati:

GET /community/organization_members?inactive=1 HTTP/1.1
Host: graph.facebook.com

Per ottenere gli eventi di un membro:

GET graph.facebook.com
      /{member-id}/events

Recupero delle informazioni sul manager e sui report dell'utente

Per ottenere i report di un determinato membro:

GET /{member_id}/reports HTTP/1.1
Host: graph.facebook.com

Per ottenere il manager di un determinato membro:

GET /{member_id}/managers HTTP/1.1
Host: graph.facebook.com

Recupero dei messaggi di un membro

Per ottenere le conversazioni di un membro, compresi messaggi, mittente e allegati:

È necessario un token dell'integrazione personalizzata con l'autorizzazione Visualizzazione di tutti i messaggi:

GET graph.facebook.com
      /{member-id}/conversations?fields=messages{message,attachments,from}

Per ottenere gli ID delle conversazioni per un membro per conversazione:

È necessario un token dell'integrazione personalizzata con l'autorizzazione Visualizzazione di tutti i messaggi:

GET graph.facebook.com
      /{member-id}/conversations

Per ottenere i messaggi per un determinato ID della conversazione per un utente specifico:

È necessario un token dell'integrazione personalizzata con l'autorizzazione Visualizzazione di tutti i messaggi:

GET graph.facebook.com
      /{thread-id}/messages?user={user-id}

Per ottenere le conversazioni per una pagina del bot, compresi messaggi e allegati:

GET graph.facebook.com
      /me/conversations?fields=messages{message,attachments}

L'alias /me reindirizza alla pagina del bot quando si utilizza il token dell'integrazione personalizzata.

Per eliminare un messaggio specifico nella posta di un membro utilizzando un token dell'integrazione personalizzata:

È necessario un token dell'integrazione personalizzata con l'autorizzazione Eliminazione dei messaggi delle chat.

DELETE graph.facebook.com
      /{message-id}?user={user-id}

L'eliminazione di un messaggio elimina solo il messaggio dalla visualizzazione del membro specificato nella richiesta. Per eliminare completamente un messaggio, è necessario eliminare la visualizzazione di quel messaggio da parte di ciascun membro.

Per ottenere la data e l'ora in cui un membro è stato invitato e ha reclamato il proprio account:

È necessario un token dell'integrazione personalizzata con l'autorizzazione Gestione degli account:

GET graph.facebook.com
      /{member-id}?fields=account_invite_time,account_claim_time

Questi campi sono presenti solo se il membro è stato invitato o ha reclamato il proprio account.

Per ottenere la data e l'ora in cui l'account di un membro è stato disattivato:

È necessario un token dell'integrazione personalizzata con l'autorizzazione Gestione degli account:

GET graph.facebook.com
      /{member-id}?fields=account_deactivate_time

Questi campi sono presenti solo se l'account del membro è stato disattivato.

Per disconnettere un utente da Workplace:

Richiede il token d'accesso con l'autorizzazione Disconnessione:

POST graph.facebook.com
      /{member-id}/logout

Per impostare un'immagine del profilo:

Richiede il token d'accesso con l'autorizzazione Gestione dei profili di lavoro. Supporta sia l'URL di un file sia il caricamento del file all'interno della richiesta.

POST graph.facebook.com
      /{member-id}/profile_pictures?
      image_url={...}&
      caption={...}

POST graph.facebook.com
      /{member-id}/profile_pictures?
      caption={...}
Content-Type: multipart/form-data;
Content-Disposition: form-data; name="image_data"; filename="/profile_picture.png

Per aggiungere il cellulare di un membro:

Richiede il token d'accesso con l'autorizzazione Gestione dei profili di lavoro.

POST graph.facebook.com
      /{member-id}/phones?
      type={...}&
      primary={...}&
      number={...}

Per ottenere le competenze del membro:

Richiede il token d'accesso con l'autorizzazione Visualizzazione del profilo di lavoro.

GET graph.facebook.com
      /{member-id}/skills

Per aggiungere una competenza:

Richiede il token d'accesso con l'autorizzazione Gestione del profilo di lavoro.

POST graph.facebook.com
      /{member-id}/skills?name={...}

Per rimuovere una competenza:

Richiede il token d'accesso con l'autorizzazione Gestione del profilo di lavoro.

DELETE graph.facebook.com
      /{member-id}/skills?name={...}

Per ottenere i badge del membro:

Richiede il token d'accesso con l'autorizzazione Visualizzazione del profilo di lavoro.

GET graph.facebook.com
      /{member-id}/badges?fields=id,name,description,icon,category

Per assegnare un badge integrato a un utente:

Richiede il token d'accesso con l'autorizzazione Gestione dei badge. Consulta la documentazione sulla community per le liste dei badge disponibili e dei relativi ID.

POST graph.facebook.com
      /{member-id}/badges?badge=workplace_champion

Per assegnare un badge personalizzato a un utente:

Richiede il token d'accesso con l'autorizzazione Gestione dei badge. Consulta la documentazione sulla community per le liste dei badge disponibili e dei relativi ID. # nell'URL deve essere con codifica URL.

POST graph.facebook.com
      /{member-id}/badges?badge=workplace_custom#{badge_id}

Per disattivare un membro:

Richiede il token d'accesso con l'autorizzazione Provisioning degli account utente.

POST graph.facebook.com
      /{member-id}?active=false

Per eliminare un membro:

Richiede il token d'accesso con l'autorizzazione Provisioning degli account utente.

DELETE graph.facebook.com
      /{member-id}

È possibile eliminare solo i membri non reclamati.

Per ottenere lo stato di lavoro operativo dell'utente:

GET graph.facebook.com
      /{user-id}?fields=frontline
      
    {
      "frontline": {
        "is_frontline": true
      },
    "id": "100038142594104"
    }

Membro

Percorso /{member-id}

Percorso /community/members

Applicazione di filtri in base a external_id

Percorso /community/organization_members

Lettura

Autorizzazioni

Campi

Pubblicazione

Eliminazione

Aggiornamento

Segmenti

Esempi

Recupero delle informazioni su un membro della community

Per ottenere il nome e l'indirizzo e-mail di un determinato membro:

Per ottenere l'ID di un membro dal suo indirizzo e-mail:

Per mostrare i membri dell'azienda in base all'ID esterno degli utenti:

Per mostrare i membri dell'azienda, compresi gli account disattivati:

Per ottenere gli eventi di un membro:

Recupero delle informazioni sul manager e sui report dell'utente

Per ottenere i report di un determinato membro:

Per ottenere il manager di un determinato membro:

Recupero dei messaggi di un membro

Per ottenere le conversazioni di un membro, compresi messaggi, mittente e allegati:

Per ottenere gli ID delle conversazioni per un membro per conversazione:

Per ottenere i messaggi per un determinato ID della conversazione per un utente specifico:

Per ottenere le conversazioni per una pagina del bot, compresi messaggi e allegati:

Per eliminare un messaggio specifico nella posta di un membro utilizzando un token dell'integrazione personalizzata:

Per ottenere la data e l'ora in cui un membro è stato invitato e ha reclamato il proprio account:

Per ottenere la data e l'ora in cui l'account di un membro è stato disattivato:

Per disconnettere un utente da Workplace:

Per impostare un'immagine del profilo:

Per aggiungere il cellulare di un membro:

Per ottenere le competenze del membro:

Per aggiungere una competenza:

Per rimuovere una competenza:

Per ottenere i badge del membro:

Per assegnare un badge integrato a un utente:

Per assegnare un badge personalizzato a un utente:

Per disattivare un membro:

Per eliminare un membro:

Per ottenere lo stato di lavoro operativo dell'utente:

Percorso `/{member-id}`

Percorso `/community/members`

Applicazione di filtri in base a `external_id`

Percorso `/community/organization_members`