API de perfiles de Messenger

En el perfil de Messenger de tu página puedes establecer propiedades que definen distintos aspectos de las funciones siguientes de la plataforma de Messenger. Para obtener más información, consulta la tabla Propiedades de los perfiles de Messenger que se encuentra a continuación.

• Botón “Empezar”
• Página de bienvenida
• Frases para romper el hielo
• Menú persistente
• Lista de dominios autorizados
• Vinculación de cuentas
• Comandos
• Pestaña “Sugerencias” (obsoleta)

Con la API de perfiles de Messenger, puedes establecer, actualizar, recuperar y eliminar propiedades del perfil de Messenger de la página.

Permisos

Se necesita un identificador de acceso a la página con el permiso pages_messaging para interactuar con este extremo.

En el caso de las aplicaciones que se encuentren en el modo de desarrollo, la configuración del perfil de Messenger solo será visible para los usuarios que tengan un rol en la aplicación.

Contenido

• URI de solicitud
• Propiedades del perfil de Messenger
• Recuperar propiedades
• Establecer/actualizar propiedades
• Eliminar propiedades
• Límite de frecuencia

URI de solicitud

https://graph.facebook.com/v19.0/me/messenger_profile?access_token=<PAGE_ACCESS_TOKEN>

Propiedades del perfil de Messenger

Puedes incluir las propiedades siguientes en el perfil de Messenger de tu página. Consulta las descripciones de la tabla siguiente para ver el tipo y el propósito de cada propiedad.

Recuperar propiedades

Recupera el valor actual de una o más propiedades del perfil de Messenger según el nombre.

Parámetros de la solicitud

Los parámetros siguientes se incluyen en la cadena de consulta de la solicitud:

Ejemplo de solicitud

curl -X GET "https://graph.facebook.com/v19.0/me/messenger_profile?fields=whitelisted_domains,greeting&access_token=<PAGE_ACCESS_TOKEN>"

Ejemplo de respuesta

El valor actual de las propiedades solicitadas se devolverá en la matriz data:

{
   "data": [
        {
          "whitelisted_domains": [
            "https://facebook.com/"
          ],
          "greeting": [
            {
               "locale": "default",
               "text": "Hello!"
            },
            {
               "locale": "en_US",
               "text": "Timeless apparel for the masses."
            }
         ]
      }
   ]
}

Establecer/actualizar propiedades

Establece los valores de una o más propiedades del perfil de Messenger. Solo se sobrescribirán las propiedades establecidas en el cuerpo de la solicitud.

Ejemplo de solicitud

curl -X POST -H "Content-Type: application/json" -d '{
  "<PROPERTY_NAME>": "<NEW_PROPERTY_VALUE>",
  "<PROPERTY_NAME>": "<NEW_PROPERTY_VALUE>",
  ...
}' "https://graph.facebook.com/v18.0/me/messenger_profile?access_token=<PAGE_ACCESS_TOKEN>"

Ejemplo de respuesta

{
    "result": "success"
}

Eliminar propiedades

Elimina una o más propiedades del perfil de Messenger. Únicamente se eliminarán las propiedades que se especifiquen en la matriz fields.

Ejemplo de solicitud

curl -X DELETE -H "Content-Type: application/json" -d '{
  "fields": [
    "<PROPERTY_NAME>",
    "<PROPERTY_NAME>",
    "<PROPERTY_NAME>",
    ...
  ]
}' "https://graph.facebook.com/v19.0/me/messenger_profile?access_token=<PAGE_ACCESS_TOKEN>"

Ejemplo de respuesta

{
    "result": "success"
}