API Messenger Profile

Il profilo Messenger per la tua Pagina è il luogo in cui puoi impostare le proprietà che definiscono i vari aspetti delle seguenti funzioni della Piattaforma Messenger. Per maggiori informazioni, consulta la tabella Proprietà del profilo Messenger qui sotto.

• Pulsante Inizia
• Pagina di benvenuto
• Rompighiaccio
• Menu always-on
• Whitelist dei domini
• Collegamento dell'account
• Comandi
• Tab Suggeriti (obsoleta)

L'API Messenger Profile ti consente di impostare, aggiornare, recuperare ed eliminare proprietà dal profilo Messenger della Pagina.

Autorizzazioni

Per interagire con questo endpoint, è necessario un token d'accesso della Pagina con l'autorizzazione pages_messaging.

Per le app in modalità sviluppo, le impostazioni del profilo Messenger saranno visibili solo alle persone con un ruolo sull'app.

Indice

• URI della richiesta
• Proprietà del profilo Messenger
• Recupero delle proprietà
• Impostazione/Aggiornamento delle proprietà
• Eliminazione delle proprietà
• Rate limiting

URI della richiesta

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

Proprietà del profilo Messenger

Di seguito sono riportate le proprietà che possono essere incluse nel profilo Messenger per la tua Pagina. Consulta le descrizioni della tabella qui sotto per il tipo e lo scopo di ognuna di esse.

Recupero delle proprietà

Recupera il valore corrente di una o più proprietà del profilo Messenger per nome.

Parametri della richiesta

Di seguito sono riportati i parametri inclusi nella stringa della query della richiesta:

Esempio di richiesta

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

Esempio di risposta

Il valore corrente delle proprietà richieste viene restituito nell'array data:

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

Impostazione/Aggiornamento delle proprietà

Imposta i valori di una o più proprietà del profilo Messenger. Solo le proprietà impostate nel corpo della richiesta verranno sovrascritte.

Esempio di richiesta

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

Esempio di risposta

{
    "result": "success"
}

Eliminazione delle proprietà

Elimina una o più proprietà del profilo Messenger. Vengono eliminate solo le proprietà specificate nell'array fields.

Esempio di richiesta

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

Esempio di risposta

{
    "result": "success"
}