API Messenger Profile

Le profil Messenger de votre Page est l’espace dans lequel vous définissez les propriétés des différents aspects des fonctionnalités suivantes de la plateforme Messenger. Pour en savoir plus, reportez-vous au tableau Propriétés du profil Messenger ci-dessous.

• Bouton Démarrer
• Page d’accueil
• Prises de contact
• Menu fixe
• Liste blanche de domaines
• Association de comptes
• Commandes
• Onglet Découvrir (obsolète)

L’API Messenger Profile vous permet de définir, mettre à jour, récupérer et supprimer des propriétés du profil Messenger de votre Page.

Autorisations

Un token d’accès de Page associé à l’autorisation pages_messaging est obligatoire pour interagir avec ce point de terminaison.

Pour les applications en mode développement, seules les personnes disposant d’un rôle sur ces applications pourront voir les paramètres du profil Messenger.

Table des matières

• URI de requête
• Propriétés du profil Messenger
• Récupérer des propriétés
• Définir/Mettre à jour des propriétés
• Supprimer des propriétés
• Plafond

URI de requête

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

Propriétés du profil Messenger

Le profil Messenger de votre Page peut inclure les propriétés suivantes. Pour en savoir plus sur le type et la fonction de chaque propriété, reportez-vous aux descriptions fournies dans le tableau ci-dessous.

Récupérer des propriétés

Récupère la valeur actuelle d’une ou de plusieurs propriétés du profil Messenger par nom.

Paramètres de la requête

Les paramètres inclus dans la chaîne de requête de la requête sont les suivants :

Exemple de requête

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

Exemple de réponse

La valeur actuelle des propriétés demandées sera renvoyée dans le tableau data :

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

Définir/Mettre à jour des propriétés

Définit les valeurs d’une ou de plusieurs propriétés du profil Messenger. Seules les propriétés définies dans le corps de la requête seront remplacées.

Exemple de requête

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

Exemple de réponse

{
    "result": "success"
}

Supprimer des propriétés

Supprime une ou plusieurs propriétés du profil Messenger. Seules les propriétés spécifiées dans le tableau fields seront supprimées.

Exemple de requête

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

Exemple de réponse

{
    "result": "success"
}