Plataforma de Messenger

API de perfiles de usuario

La API de perfiles de usuario permite usar un identificador específico de Instagram (IGSID) para recuperar información de los perfiles de los clientes. Esta información se puede utilizar para crear una experiencia personalizada de interacción entre los clientes y una empresa.

Consentimiento de los usuarios

Se necesita el consentimiento de los usuarios para acceder a su perfil. El consentimiento de los usuarios se establece solo cuando un usuario envía un mensaje a una empresa o hace clic en frases para romper el hielo o un menú persistente. Si un usuario comenta en una publicación o comentario, pero no ha enviado un mensaje a la empresa, la aplicación recibirá un error. Se necesita el consentimiento de los usuarios para acceder a su perfil.

Requisitos

Necesitarás lo siguiente:

  • El permiso instagram_basic.
  • El permiso instagram_manage_messages.
  • Los permisos pages_manage_metadata.
  • El permiso pages_read_engagement.
  • El permiso pages_show_list.
  • Un identificador de acceso a la página solicitado por una persona que pueda realizar la tarea MODERATE en la página.

Limitaciones

Si un cliente ha bloqueado tu empresa, no podrás ver su información.

Campos del perfil de un usuario

Los siguientes campos de perfil están disponibles para todas las versiones de la API Graph.

Nombre del campo Descripción

name

Cadena

Nombre del cliente (puede ser null si el nombre no está establecido).

profile_pic

URL

URL de la foto de perfil del cliente (puede ser null si la foto de perfil no está establecida). La URL caducará en el plazo de unos días.

Los siguientes campos de perfil están disponibles para la versión 12.0 y posteriores de la API Graph.

Nombre del campo Descripción

is_verified_user

Booleano

Estado de verificación del cliente.

follower_count

Entero

Recuento de seguidores del cliente.

is_user_follow_business

Booleano

Indica si el cliente sigue a la empresa.

is_business_follow_user

Booleano

Indica si la empresa sigue al cliente.

Los siguientes campos están disponibles para la versión 14.0 y posteriores de la API Graph.

CampoDescripción

username

Cadena

Nombre de usuario de la cuenta de Instagram del cliente.

Ejemplos

Para obtener la información del perfil de un cliente, envía una solicitud GET al nodo de identificador específico de Instagram del cliente e incluye los campos que quieras ver.

Ejemplo de solicitud

Se ha aplicado formato con fines de legibilidad.
curl -X GET "https://graph.facebook.com/v19.0/instagram-scoped-user-id
  ?fields=name,username,profile_pic,follower_count,is_user_follow_business,is_business_follow_user
  &access_token=page-access-token"

Cuando esta operación se completa correctamente, la aplicación recibirá la respuesta JSON siguiente:

{
  "name": "Peter Chang",
  "username": "peter_chang_live",
  "profile_pic": "https://fbcdn-profile-...",
  "follower_count": 1234
  "is_user_follow_business": false,
  "is_business_follow_user": true,
}

Ayuda para desarrolladores