Miembro

Objeto /{member-id} de la ruta

Representa un objeto de usuario como miembro de una comunidad o un grupo de Workplace.

Ruta /community/members

Devuelve una lista de todas las cuentas de usuario actuales. Requiere el permiso Administrar perfiles laborales.

Filtración en función de external_id

Para filtrar usuarios en función del identificador externo, usa el parámetro external_ids y pasa una lista separada por comas con los identificadores externos de los usuarios deseados.

Ruta /community/organization_members

Devuelve una lista de usuarios. Requiere el permiso Leer miembros de grupo. De forma predeterminada, se enumerarán las cuentas de usuario activas. Para mostrar las cuentas de usuario desactivadas, usa el parámetro de URL inactive=1 en su lugar.

Lectura

Devuelve un único objeto de usuario que representa a un usuario de Workplace. Es accesible a través del identificador de Workplace del miembro o de la dirección de correo electrónico que utiliza el miembro para iniciar sesión en Workplace.

• /{member_id}
• /{email_address}

Permisos

Para leer la información sobre un miembro, es necesario el permiso Leer el perfil laboral o el permiso Administrar cuentas. Si una integración usa el permiso Administrar cuentas y se centra en grupos específicos, no podrá acceder a algunos campos de Miembro.

Campos

Publicación

Consulta API de administración de cuentas (Graph).

Eliminación

Consulta API de administración de cuentas (Graph).

Actualización

Consulta API de administración de cuentas (Graph).

Perímetros

Ejemplos

Recuperar información sobre un miembro de la comunidad

Obtener el nombre y la dirección de correo electrónico de un miembro determinado

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

Obtener el identificador de un miembro a partir de su dirección de correo electrónico

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

Publicar los miembros de una empresa en función del identificador externo de los usuarios

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

Publicar los miembros de una empresa, incluidas las cuentas desactivadas

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

Obtener los eventos de un miembro:

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

Recuperar información sobre el administrador y los informes del usuario

Obtener los informes de un miembro determinado

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

Obtener el administrador de un miembro determinado

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

Recuperar mensajes de un miembro

Obtener conversaciones de un miembro, incluidos los mensajes, el remitente y los archivos adjuntos

Requiere un identificador de integración personalizado con el permiso Leer todos los mensajes:

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

Obtener identificadores de conversación de un miembro por el hilo

Requiere un identificador de integración personalizado con el permiso Leer todos los mensajes:

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

Obtener mensajes de un identificador de hilo determinado para un usuario específico

Requiere un identificador de integración personalizado con el permiso Leer todos los mensajes:

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

Obtener conversaciones de una página de bot, incluidos los mensajes y los archivos adjuntos

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

Eliminar un mensaje específico en la bandeja de entrada de un miembro mediante un identificador de integración personalizado

Requiere un identificador de integración personalizado con el permiso Eliminar mensajes de chat:

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

Obtener la fecha y hora en que un miembro ha recibido una invitación y ha reclamado su cuenta

Requiere un identificador de integración personalizado con el permiso Administrar cuentas:

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

Obtener la fecha y hora en que se ha desactivado la cuenta de un miembro:

Requiere un identificador de integración personalizado con el permiso Administrar cuentas:

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

Cerrar la sesión de un usuario en Workplace

Requiere un identificador de acceso con el permiso Cerrar sesión:

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

Establecer una foto de perfil

Requiere un identificador de acceso con el permiso Administrar perfiles laborales. Admite una URL de archivo y la subida de archivos dentro de la solicitud.

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

Añadir el teléfono de un miembro

Requiere un identificador de acceso con el permiso Administrar perfiles laborales.

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

Obtener las aptitudes de un miembro

Requiere un identificador de acceso con el permiso Leer el perfil laboral.

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

Añadir una aptitud

Requiere un identificador de acceso con el permiso Administrar perfil laboral.

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

Eliminar una aptitud

Requiere un identificador de acceso con el permiso Administrar perfil laboral.

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

Obtener las insignias de un miembro

Requiere un identificador de acceso con el permiso Leer el perfil laboral.

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

Otorgar una insignia integrada a un usuario

Requiere un identificador de acceso con el permiso Administrar insignias. Consulta la documentación sobre la comunidad para saber cómo obtener una lista con las insignias disponibles y sus identificadores.

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

Otorgar una insignia personalizada a un usuario

Requiere un identificador de acceso con el permiso Administrar insignias. Consulta la documentación sobre la comunidad para obtener información sobre las insignias disponibles y sus identificadores. Ten en cuenta que el carácter # de la URL debe tener codificación URL.

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

Desactivar un miembro

Requiere un identificador de acceso con el permiso Crear cuentas de usuario.

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

Eliminar un miembro

Requiere un identificador de acceso con el permiso Crear cuentas de usuario.

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

Obtener el estado de primera línea del usuario

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