Miembro

Ruta `/{member-id}`

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

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 todo el contenido o Administrar cuentas.

Campos

Nombre del campo	Descripción	Tipo
`id`	El identificador de la cuenta de usuario de esta persona.	`string`
`first_name`	El primer nombre de la persona.	`string`
`last_name`	El apellido de la persona.	`string`
`email`	La dirección de correo electrónico principal de la persona, es decir, la que usa como nombre de usuario en Workplace.	`string`
`title`	El cargo de la persona en Workplace.	`string`
`department`	El departamento de la persona en Workplace, si se estableció a través de la API de administración de cuentas.	`string`
`employee_number`	Identificador numérico o alfanumérico que se asigna a una persona, normalmente en función del orden de contratación u asociación con una organización.	`string`
`primary_phone`	El número de teléfono principal de la persona. Mapas de la entrada `phoneNumbers`, que está marcada como `primary` en la API de administración de cuentas.	`string`
`primary_address`	La dirección principal de la persona. Mapas de la entrada `addresses`, que está marcada como `primary` en la API de administración de cuentas.	`string`
`picture`	La foto del perfil de la persona.	`url`
`link`	Un enlace al perfil de la persona.	`url`
`locale`	El idioma de la persona.	`string`
`name`	El nombre completo de la persona.	`string`
`name_format`	El nombre de la persona con el formato correcto para que sea compatible con los pedidos en chino, japonés y coreano.	`string`
`account_invite_time`	Tiempo de invitación de la cuenta en formato UTC.	`datetime`
`account_claim_time`	Tiempo de reclamación de la cuenta en formato UTC.	`datetime`
`impersonate_token`	Un token de acceso para miembros, que permite una integración para hacer llamadas en nombre de un persona determinada. Requiere permiso de suplantación. El permiso de suplantación de identidad se encuentra obsoleto. No lo uses para crear nuevas funcionalidades. Este permiso ya no se puede agregar más a las integraciones personalizadas.	`string`
`about`	El contenido del campo Presentación en el perfil del usuario.	`string`
`frontline`	Información sobre el estado de primera línea del usuario.	`object` (ver ejemplo a continuación)

Publicación

No puedes publicar contenido con este nodo.

Eliminación

No puedes eliminar contenido con este nodo.

Actualización

No puedes actualizar contenido con este nodo. Las cuentas se pueden actualizar o desactivar mediante la API de administración de cuentas.

Perímetros

Nombre del perímetro	Descripción
`/events`	Eventos para esta persona No se incluye de manera predeterminada los eventos que la persona rechazó o no contestó.
`/feed`	La lista de publicaciones (incluidas las actualizaciones de estado) y los enlaces publicados por esta persona.
`/conversations`	Los mensajes de Workplace de una persona o página de bot. Requiere un permiso Leer todos los mensajes.
`/managers`	El administrador o los administradores que se muestran de una persona.
`/reports`	Los informes que se muestran de una persona.
`/picture`	La foto del perfil del miembro.
`/groups`	Los grupos asociados a un miembro.

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

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}

Los puntos de alias /me de la página del bot cuando se utiliza un token de integración personalizada.

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

Estos campos solo están presentes si se invitó al miembro o se reclamó su cuenta.

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}

Eliminar un mensaje solo borra el mensaje de la vista del miembro que se especificó en la solicitud. Para eliminar un mensaje completo, se debe eliminar la vista de ese mensaje de cada uno de los miembros.

Obtener el estado de primera línea de un usuario

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

Miembro

Ruta /{member-id}

Lectura

Permisos

Campos

Publicación

Eliminación

Actualización

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

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

Obtener los eventos de un miembro

Recuperar información del administrador y de los informes de un usuario

Obtener informes de un determinado miembro

Obtener el administrador de un determinado miembro

Recuperar mensajes para un miembro

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

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

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

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

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

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

Obtener el estado de primera línea de un usuario

Ruta `/{member-id}`