API de perfiles de usuario

La API de perfiles de usuario te permite utilizar un identificador específico de la página (PSID) para recuperar información del perfil de un usuario con la que podrás personalizar la experiencia de los usuarios que interactúan contigo por Messenger.

Disponibilidad

Para recuperar la información del perfil de un usuario, necesitas tener acceso avanzado para la función de acceso al perfil de usuario del activo comercial. Algunos campos requieren permisos adicionales para acceder.

Aunque un PSID puede ser válido, en algunos casos es posible que no se pueda utilizar para recuperar la información del perfil de un usuario. Por ejemplo, no se puede acceder a los PSID asociados a las páginas de Juegos instantáneos mediante la API de perfiles de usuario.

Suscripción voluntaria del usuario

Los siguientes eventos autorizarán a tu bot de Messenger a acceder a la información del perfil de un usuario:

El usuario inicia la conversación mediante una pantalla de bienvenida y toca el botón “Empezar”.
El usuario hace clic en un botón “Enviar a Messenger” para iniciar la conversación.
El usuario envía un mensaje para iniciar la conversación.
El usuario acepta una solicitud de mensaje de una página para iniciar la conversación.
El bot de Messenger utiliza la función askPermission() del SDK de extensiones de Messenger en la vista web para solicitar el permiso user_profile.
En el caso de las aplicaciones empresariales, también se requiere la función de acceso al perfil de usuario del activo comercial, que se puede solicitar mediante la revisión de la aplicación.

Algunos puntos de acceso permiten a las aplicaciones iniciar una conversación sin conceder a la aplicación autorización para acceder al perfil público de un usuario. En estos casos, se concederá permiso a la aplicación para acceder al perfil del usuario cuando este haya respondido al mensaje inicial. A continuación se indican algunas situaciones relevantes en las que un usuario puede iniciar una conversación con la aplicación, pero no autorizar el permiso de perfil:

Conversaciones iniciadas mediante el plugin “Checkbox” en las que el usuario no haya respondido en Messenger.
Interacciones con anuncios de clic a Messenger antes de que el usuario haya respondido en Messenger.

Perfil no disponible

En estos momentos, la API de perfiles de usuario no admite la recuperación de información de perfiles para cuentas de Messenger que se hayan creado con un número de teléfono.

En este caso, la API devolverá el código de error 2018218 junto con el mensaje “No hay ningún perfil disponible para este usuario”.

Campos de perfil disponibles

Las aplicaciones que hayan recibido la aprobación de la revisión de la aplicación para la función y el permiso necesarios pueden recuperar los siguientes campos para los usuarios que hayan hecho pública esta información y se hayan suscrito voluntariamente a tu página.

Nombre del campo	Descripción	Permiso
`id`	PSID del usuario	No aplicable
`name`	Nombre y apellidos del usuario	No aplicable
`first_name`	nombre	No aplicable
`last_name`	apellidos	No aplicable
`profile_pic`	Foto del perfil	No aplicable
`locale`	Idioma del usuario en Facebook	`pages_user_locale`
`timezone`	Zona horaria (número relativo a GMT)	`pages_user_timezone`
`gender`	Sexo	`pages_user_gender`

Solicitar acceso de funciones a campos de usuario para la página

Ve a Configuración de la página > Mensajería avanzada.
En “Información sobre las personas', selecciona el campo y haz clic en el botón “Solicitar”.

Recuperar el perfil de un usuario

Para usar la API de perfiles de usuario, envía una solicitud GET con los campos del perfil que quieres consultar del usuario:

curl -X GET "https://graph.facebook.com/<PSID>?fields=first_name,last_name,profile_pic&access_token=<PAGE_ACCESS_TOKEN>"

Si la aplicación puede acceder al perfil del usuario, la API de perfiles de usuario devolverá una cadena JSON con los campos solicitados de dicho perfil.

{
  "first_name": "Peter",
  "last_name": "Chang",
  "profile_pic": "https://fbcdn-profile-a.akamaihd.net/hprofile-ak-xpf1/v/t1.0-1/p200x200/13055603_10105219398495383_8237637584159975445_n.jpg?oh=1d241d4b6d4dac50eaf9bb73288ea192&oe=57AF5C03&__gda__=1470213755_ab17c8c8e3a0a447fed3f272fa2179ce",
  "locale": "en_US",
  "timezone": -7,
  "gender": "male",
  "last_ad_referral": {
    "source": "ADS",
    "type": "OPEN_THREAD",
    "ad_id": "6045246247433"
  }
}

Si la aplicación no puede acceder al perfil del usuario, se devuelve un objeto vacío.

Más información

Códigos de error de la plataforma de Messenger