Plataforma de Messenger

API de perfil de usuario

La API de perfil de usuario te permite usar un identificador específico de Instagram (IGSID) para recuperar información de perfiles de clientes. Puedes usar esta información para crear una experiencia de personalización para las personas que interactúan con tu empresa.

Consentimiento del usuario

Es obligatorio tener el consentimiento del usuario para acceder a su perfil. El consentimiento del usuario se establece solo cuando una persona envía un mensaje a un negocio, o hace clic en preguntas para romper el hielo o en el menú persistente. Si una persona comentó en una publicación o en un comentario, pero no envió un mensaje a la empresa, tu app recibirá un error, Es necesario el consentimiento del usuario 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 token de acceso a la página solicitado por una persona que pueda realizar la tarea MODERATE en la página

Limitaciones

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

Campos del perfil del usuario

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

Nombre del campo Descripción

name

cadena

El nombre del cliente (puede quedar vacío si no se definió)

profile_pic

url

La URL de la foto del perfil del cliente (puede quedar vacío si no se definió una foto del perfil) La URL vencerá en un par de días.

Los siguientes campos del perfil están disponibles en la API Graph versión 12.0 o posteriores.

Nombre del campo Descripción

is_verified_user

booleano

Estado de verificación del cliente

follower_count

número entero

Cuenta de seguidor del cliente

is_user_follow_business

booleano

Indica si el cliente sigue a la empresa o no

is_business_follow_user

booleano

Indica si la empresa sigue al cliente o no

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

CampoDescripción

username

cadena

El 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 del identificador específico de Instagram del cliente e incluye los campos que te gustaría ver.

Ejemplo de solicitud

El formato se modificó para facilitar la lectura.
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"

Si la operación se completa correctamente, tu app recibirá la siguiente respuesta JSON:

{
  "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