Referencia

Miembro

Objeto /{member-id} de la ruta

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

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, se requiere el permiso Leer todo el contenido o Administrar cuentas.

Campos

Nombre del campoDescripciónTipo

id

Identificador de la cuenta de usuario de esta persona.

string

first_name

Nombre de la persona.

string

last_name

Apellidos de la persona.

string

email

Dirección de correo electrónico principal de la persona, que también se utiliza como su nombre de usuario en Workplace.

string

title

Puesto de la persona en Workplace.

string

department

Nombre del departamento de la persona en Workplace, si se establece a través de la API de administración de cuentas.

string

employee_number

Identificador numérico o alfanumérico asignado a una persona, por lo general basado en el orden de contratación o asociación con una organización.

string

primary_phone

Número de teléfono principal de la persona. Se asigna a la entrada phoneNumbers, que está marcada como primary en la API de administración de cuentas.

string

primary_address

Dirección principal de la persona. Se asigna a la entrada addresses, marcada como primary en la API de administración de cuentas.

string

picture

Foto del perfil de la persona.

url

link

Enlace al perfil de la persona.

url

locale

Configuración regional de la persona.

string

name

Nombre completo de la persona.

string

name_format

Nombre de la persona formateado correctamente para gestionar pedidos chinos, japoneses o coreanos.

string

account_invite_time

Hora de invitación de la cuenta en formato UTC.

datetime

account_claim_time

Hora de reclamación de la cuenta en formato UTC.

datetime

impersonate_token

Identificador de acceso de un miembro que permite que una integración realice llamadas en nombre de una persona específica. Requiere el permiso de suplantación.

El permiso de suplantación está obsoleto. No lo utilices al compilar nuevas funcionalidades. Dicho permiso ya no se puede añadir a las integraciones personalizadas.

string

about

Contenido del campo "Biografía" en el perfil del usuario.

string

frontline

Información sobre el estado de primera línea del usuario

object (consulta el ejemplo a continuación)

Publicación

No puedes realizar ninguna publicación con este nodo.

Eliminación

No puedes realizar ninguna eliminación con este nodo.

Actualización

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

Perímetros

Nombre del perímetroDescripción

/events

Eventos para esta persona. De forma predeterminada, no se incluyen eventos que la persona ha rechazado o a los que no ha respondido.

/feed

Sección de noticias de las publicaciones (incluidas las actualizaciones de estado) y enlaces publicados por esta persona.

/conversations

Mensajes de Workplace de la página de un bot o una persona. Requiere el permiso Leer todos los mensajes

/managers

Administrador o administradores enumerados de una persona.

/reports

Informes enumerados de una persona.

/picture

Fotos de perfil del miembro.

/groups

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

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


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

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


Obtén 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

Recuperación de 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 determinado

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}

El alias /me apunta a la página del bot cuando se utiliza un identificador de integración personalizado.


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

Estos campos solo están presentes si el miembro ha recibido una invitación o ha reclamado su cuenta.

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}

Al eliminar un mensaje, este solo se elimina de la vista del miembro que se ha especificado en la solicitud. Para eliminar un mensaje completamente, la vista del mensaje se debe eliminar para todos los miembros.

Obtener el estado de primera línea del usuario

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