Riferimento

Membro

Percorso /{member-id}

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

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

La lettura delle informazioni su un membro richiede le autorizzazioni Read all content o Manage accounts.

Campi

Nome del campoDescrizioneTipo

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 professionale della persona su Workplace.

string

department

Il nome del reparto della persona su Workplace, se impostato tramite l'API Account Management.

string

employee_number

Identificativo numerico o alfanumerico assegnato a una persona, di solito basato sull'ordine di assunzione o sull'associazione con un'organizzazione.

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

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

impersonate_token

Un token d'accesso del membro che consente un'integrazione per effettuare chiamate per conto di una persona specifica. Richiede l'autorizzazione Impersonate.

Impersonate è un'autorizzazione obsoleta. Non creare nuove funzionalità utilizzando questa autorizzazione. Questa autorizzazione non può più essere aggiunta alle integrazioni personalizzate.

string

about

Il contenuto del campo Biografia nel profilo dell'utente.

string

frontline

Le informazioni sullo stato di lavoro operativo dell'utente.

object (vedi l'esempio seguente)

Pubblicazione

Non puoi pubblicare utilizzando questo nodo.

Eliminazione

Non puoi eliminare utilizzando questo nodo.

Aggiornamento

Non puoi aggiornare utilizzando questo nodo. Gli account possono essere aggiornati o disattivati utilizzando l'API Account Management.

Segmenti

Nome del segmentoDescrizione

/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. È necessaria l'autorizzazione Read all messages

/managers

Il manager o i manager indicati di una persona.

/reports

I report indicati di una persona.

/picture

Le immagini del profilo del membro.

/groups

I gruppi associati a un membro.

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 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 di integrazione personalizzato con l'autorizzazione Read all messages:

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 di integrazione personalizzato con l'autorizzazione Read all messages:

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


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

È necessario un token di integrazione personalizzato con l'autorizzazione Read all messages:

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 di integrazione personalizzato.


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

È necessario un token di integrazione personalizzato con l'autorizzazione Manage 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 attivato il proprio account.

Per eliminare un messaggio specifico nella posta di un membro utilizzando un token di integrazione personalizzato:

È necessario un token di integrazione personalizzato con l'autorizzazione Delete chat messages.

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 lo stato di lavoro operativo dell'utente

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