API de perfiles de Messenger

El perfil de Messenger de la página es donde configuras las propiedades que definen varios aspectos de las siguientes funciones de la plataforma de Messenger. Para obtener más información, consulta la tabla Propiedades del perfil de Messenger, que se muestra a continuación.

• Botón "Empezar"
• Página de bienvenida
• Temas para empezar una conversación
• Menú persistente
• Lista blanca de dominios
• Vinculación de cuentas
• Comandos
• Pestaña "Sugerencias" (obsoleta)

La API del perfil de Messenger te permite configurar, actualizar, recuperar y eliminar propiedades desde el perfil de Messenger de la página.

Permisos

Se requiere el token de acceso a la página con permiso pages_messaging para interactuar con este punto de conexión.

En las apps en modo de desarrollo, solo las personas que tengan un rol en la app podrán ver la configuración del perfil de Messenger.

Índice

• URI de la solicitud
• API de perfiles de Messenger
• Recuperar propiedades
• Configurar/actualizar propiedades
• Eliminar propiedades
• Límite de frecuencia

URI de la solicitud

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

Propiedades de perfiles de Messenger

Se pueden incluir las siguientes propiedades en el perfil de Messenger de una página. Consulta las descripciones de la tabla que se muestra a continuación para informarte sobre el tipo y la función de las propiedades.

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

Se incluyen los siguientes parámetros 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

Se devolverá el valor actual de las propiedades solicitadas en la matriz data:

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

Configurar/actualizar propiedades

Configura los valores de una o más propiedades del perfil de Messenger. Se reemplazarán solo las propiedades que se configuraron 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. Se eliminarán únicamente las propiedades especificadas 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"
}