Membro

Caminho /{member-id}

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

Caminho /community/members

Retorna uma lista de todas as contas de usuário atuais. Requer a permissão Gerenciar perfil profissional.

Filtro com base no external_id

Para filtrar usuários com base na identificação externa, use o parâmetro external_ids e transmita uma lista separada por vírgulas com as identificações externas dos usuários desejados.

Caminho /community/organization_members

Retorna a lista de usuários. Requer a permissão Ler os membros do grupo. Por padrão, as contas de usuário ativas serão exibidas. Para listar as contas de usuário desativadas, use o parâmetro de URL inactive=1.

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 a permissão Ler perfil profissional ou Gerenciar contas. Se uma integração estiver usando a permissão Gerenciar contas e tiver grupos específicos como escopo, não será possível acessar alguns campos do membro.

Campos

Publicação

Consulte Account Management API (Graph).

Exclusão

Consulte Account Management API (Graph).

Atualização

Consulte Account Management API (Graph).

Bordas

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 o ID de um membro usando o endereço de email dele

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

Liste os membros da empresa com base na identificação externa dos usuários

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

Liste os membros da empresa, incluindo contas desativadas

GET /community/organization_members?inactive=1 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}

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}

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

Obtenha a data e a hora em que a conta de um membro foi desativada:

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

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

Desconecte um usuário do Workplace

Isso requer um token de acesso com a permissão Desconectar:

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

Defina uma foto do perfil

Isso requer um token de acesso com a permissão Gerenciar perfil profissional. Além disso, é compatível com a URL e com o carregamento de arquivo na solicitação.

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

Adicione o telefone de um membro

Isso requer um token de acesso com a permissão Gerenciar perfil profissional.

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

Obtenha as competências de um membro

Isso requer um token de acesso com a permissão Ler perfil profissional.

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

Adicione uma competência

Isso requer um token de acesso com a permissão Gerenciar perfil profissional.

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

Remova uma competência

Isso requer um token de acesso com a permissão Gerenciar perfil profissional.

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

Obtenha os selos de um membro

Isso requer um token de acesso com a permissão Ler perfil profissional.

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

Conceda um selo integrado a um usuário

Isso requer um token de acesso com a permissão Gerenciar selos. Consulte a documentação da comunidade para ver os selos disponíveis e as identificações correspondentes.

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

Conceda um selo personalizado a um usuário

Isso requer um token de acesso com a permissão Gerenciar selos. Consulte a documentação da comunidade para ver os selos disponíveis e as identificações correspondentes. O símbolo # precisa ser codificado em URL.

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

Desative um membro

Isso requer um token de acesso com a permissão Provisionar contas de usuários.

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

Exclua um membro

Isso requer um token de acesso com a permissão Provisionar contas de usuários.

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

Obtenha o status de linha de frente do usuário

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