Miembro

Ruta /{member-id}

Muestra un objeto de usuario como miembro de un grupo o de la comunidad de Workplace.

Ruta /community/members

Devuelve una lista de todas las cuentas de usuario actuales. Requiere un permiso Administrar perfil laboral.

Filtro basado en external_id.

Para filtrar usuarios según el identificador externo, utiliza el parámetro external_ids y pasa una lista separada por comas de los identificadores externos de los usuarios deseados.

Ruta /community/organization_members

Devuelve una lista de usuarios. Requiere un permiso Leer miembros de grupo. De manera predeterminada, se muestran en la lista las cuentas de usuario activas. Se pueden mostrar las cuentas de usuario desactivadas usando el parámetro de URL inactive=1.

Lectura

Devuelve un único objeto usuario que representa al usuario de Workplace. Puede accederse a través del identificador de Workplace del miembro o la dirección de correo electrónico que utilizó el miembro cuando inició sesión en Workplace.

• /{member_id}
• /{email_address}

Permisos

Leer la información de un miembro requiere el permiso Leer perfil laboral o el permiso Administrar cuentas. Si una integración usa el permiso Administrar cuentas y se especificó para un determinado grupo, no podrá acceder a ciertos campos de miembros.

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 determinado miembro

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 miembros empresariales según el identificador externo de los usuarios

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

Publicar los miembros empresariales, 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 del administrador y de los informes de un usuario

Obtener informes de un determinado miembro

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

Obtener el administrador de un determinado miembro

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

Recuperar mensajes para un miembro

Obtener conversaciones para un miembro, incluidos los mensajes, el emisor y los adjuntos:

Requiere un token de integración personalizada con el permiso Leer todos los mensajes:

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

Obtener identificadores de conversaciones para un miembro según la conversación:

Requiere un token de integración personalizada con el permiso Leer todos los mensajes:

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

Obtener mensajes para un identificador de conversación determinado para un usuario en particular:

Requiere un token de integración personalizada con el permiso Leer todos los mensajes:

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

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

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

Eliminar un mensaje específico en la bandeja de entrada de un miembro utilizando un token de integración personalizada:

Requiere un token de integración personalizada con el permiso Eliminar mensajes de chat:

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

Obtener la fecha y hora del momento en que se invitó a un miembro y se reclamó su cuenta:

Requiere un token de integración personalizada con el permiso Administrar cuentas:

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

Obtener la fecha y hora del momento en que se desactivó la cuenta de un miembro:

Requiere un token de integración personalizada con el permiso Administrar cuentas:

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

Obligar a un usuario a cerrar sesión en Workplace

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

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

Establecer una foto del perfil

Requiere un token de acceso con el permiso Administrar perfiles laborales. Admite la 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

Agregar el teléfono de un miembro

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

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

Obtener las habilidades de un miembro

Requiere token de acceso con el permiso Leer el perfil laboral.

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

Agregar una habilidad

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

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

Eliminar una habilidad

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

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

Obtener las insignias de un miembro

Requiere token 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 token de acceso con el permiso Administrar insignias. Consulte la documentación de la comunidad para obtener información sobre 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 token de acceso con el permiso Administrar insignias. Consulta la documentación de la comunidad para obtener información sobre las insignias disponibles y sus identificadores. Ten en cuenta que # en la URL debe tener codificación URL.

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

Desactivar un miembro

Requiere token de acceso con el permiso Otorgar de cuentas de usuario.

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

Eliminar un miembro

Requiere token de acceso con el permiso Otorgar de cuentas de usuario.

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

Obtener el estado de primera línea de un usuario

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