Referência

Membro

Caminho /{member-id}

Representa um objeto de usuário como membro de uma comunidade ou de um grupo do Workplace.

Leitura

Retorna um objeto de usuário único que representa um usuário do Workplace. Isso pode ser acessado por meio da identificação do Workplace do membro ou do endereço de email usado pelo membro ao entrar no Workplace.

  • /{member_id}
  • /{email_address}

Permissões

Para ler informações sobre um membro, é preciso ter as permissões Ler todo o conteúdo ou Gerenciar contas.

Campos

Nome do campoDescriçãoTipo

id

Representa a identificação da conta de usuário da pessoa.

string

first_name

É o nome da pessoa.

string

last_name

É o sobrenome da pessoa.

string

email

É o endereço de email principal da pessoa, também usado como nome de usuário no Workplace.

string

title

É o cargo da pessoa no Workplace.

string

department

É o nome do departamento da pessoa no Workplace (se definido por meio da API de Gerenciamento de Contas).

string

employee_number

É o identificador numérico ou alfanumérico atribuído a uma pessoa, normalmente com base na ordem de contratação ou na associação com uma organização.

string

primary_phone

É o número de telefone principal da pessoa. Mapeia para a entrada phoneNumbers, que é marcada como primary na API de Gerenciamento de Contas.

string

primary_address

É o endereço principal da pessoa. Mapeia para a entrada addresses, que é marcada como primary na API de Gerenciamento de Contas.

string

picture

É a foto do perfil da pessoa.

url

link

É um link para o perfil da pessoa.

url

locale

É a localidade da pessoa.

string

name

É o nome completo da pessoa.

string

name_format

É o nome da pessoa formatado para lidar de maneira adequada com a ordenação em chinês, japonês ou coreano.

string

account_invite_time

É a hora do convite da conta no formato UTC.

datetime

account_claim_time

É a hora da obtenção da conta no formato UTC.

datetime

impersonate_token

É um token de acesso de membro que permite a uma integração fazer chamadas em nome de uma pessoa específica. Requer a permissão Passar-se por.

Essa permissão está obsoleta. Não crie novos recursos usando essa permissão. Ela não pode mais ser adicionada a integrações personalizadas.

string

about

O conteúdo do campo Bio no perfil do usuário.

string

frontline

São informações sobre o status de linha de frente do usuário.

object (veja o exemplo abaixo)

Publicação

Não é possível publicar usando esse nó.

Exclusão

Não é possível excluir usando esse nó.

Atualização

Não é possível atualizar usando esse nó. É possível atualizar ou desativar contas por meio da API de Gerenciamento de Contas.

Bordas

Nome da bordaDescrição

/events

Representa os eventos da pessoa. Por padrão, não inclui eventos que a pessoa recusou ou não respondeu.

/feed

Mostra o feed de publicações (incluindo atualizações de status) e os links publicados pela pessoa.

/conversations

Representa as mensagens do Workplace de uma pessoa ou de uma página de bot. Requer a permissão Ler todas as mensagens.

/managers

Indica o gerente ou os gerentes da pessoa.

/reports

Mostra os subordinados de uma pessoa.

/picture

São as fotos do perfil do membro.

/groups

São os grupos associados a um membro.

Exemplos

Como recuperar informações sobre um membro da comunidade


Obtenha o nome e o endereço de email de um determinado membro

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


Obtenha a identificação de um membro usando o endereço de email dele

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


Obtenha os eventos de um membro

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

Como recuperar informações sobre o gerente e os subordinados do usuário


Obtenha os subordinados de um determinado membro

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


Obtenha o gerente de um determinado membro

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

Como recuperar mensagens de um membro


Obtenha conversas de um membro, incluindo informações como mensagens, remetentes e anexos

Isso requer um token de integração personalizado com a permissão Ler todas as mensagens:

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


Obtenha as identificações de conversas de um membro por conversas

Isso requer um token de integração personalizado com a permissão Ler todas as mensagens:

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


Obtenha mensagens associadas a uma determinada identificação de conversa de um usuário específico

Isso requer um token de integração personalizado com a permissão Ler todas as mensagens:

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


Obtenha conversas de uma página de bot, incluindo mensagens e anexos

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

O alias /me redireciona para a página do bot ao usar um token de integração personalizado.


Obtenha a data e a hora em que um membro foi convidado e obteve a conta

Isso requer um token de integração personalizado com a permissão Gerenciar contas:

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

Esses campos só estarão presentes se o membro tiver obtido a conta ou recebido um convite.

Exclua uma mensagem específica na caixa de entrada de um membro usando um token de integração personalizado

Isso requer um token de integração personalizado com a permissão Excluir mensagens de bate-papo:

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

A exclusão só remove a mensagem da visualização do membro que foi especificado na solicitação. Para fazer a exclusão total, é preciso excluir a mensagem da visualização de cada membro.

Obtenha o status de linha de frente do usuário

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