API Graph
Versione API Graph

Messaggio

Un singolo messaggio in una conversazione di Messenger o della messaggistica di Instagram.

Usa l'endpoint conversation o i webhook per recuperare i singoli ID messaggio.

Lettura

Tool di esplorazione per la API Graph
GET /v21.0/{message-id} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{message-id}',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "/{message-id}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{message-id}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{message-id}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Requisiti

TipoDescrizione

Analisi dell'app

Obbligatoria per accedere ai dati per le persone che non hanno un ruolo nella tua app, come gli sviluppatori, i tester o gli amministratori.

Funzioni

Non applicabile

Token

Un token d'accesso alla Pagina di una persona che può eseguire le attività MODERATE o MESSAGING sulla Pagina oggetto di query o collegata all'account Instagram per professionisti.

Autorizzazioni

Autorizzazioni pages_messaging e pages_manage_metadata

Le autorizzazioni instagram_basic e instagram_manage_messaging sono necessarie anche per la messaggistica di Instagram.

Limitazioni

Per la messaggistica di Instagram

  • Solo gli account Instagram per professionisti con una Pagina Facebook collegata possono accedere a questo endpoint.
  • Quando viene eseguita una query per questo endpoint, vengono restituiti tutti i messaggi per questa conversazione. Tuttavia, puoi eseguire query solo per i dati dei 20 messaggi più recenti nella conversazione. Se un messaggio non è incluso tra i 20 più recenti, verrà restituito un errore che indica che il messaggio è stato cancellato.

Campi

Se un campo non contiene dati, non verrà restituito nella risposta JSON.

NomeDescrizione

attachments.data

array
file_url
generic_template
id
image_data
name
video_data

Contenuti multimediali, come immagini, video o URL CDN di un file, allegati al messaggio.


L'URL del file allegato al messaggio

L'URL dell'immagine allegata al messaggio. Può includere le seguenti coppie chiave-valore:

  • cta: oggetto con title, type, url
  • medial_url: stringa, URL per l'immagine
  • subtitle: stringa, in pixel
  • title: stringa

L'ID dell'allegato

L'URL dell'immagine allegata al messaggio. Può includere le seguenti coppie chiave-valore:

  • animated_gif_preview_url: stringa, URL per l'anteprima della GIF
  • animated_gif_url: stringa, URL per la GIF
  • height: int, in pixel
  • max_height: int, in pixel
  • max_width: int, in pixel
  • preview_url: stringa, anteprima per l'URL
  • render_as_sticker: booleano, vero o falso
  • url: stringa, URL per l'immagine
  • width: int, in pixel

Il nome dell'allegato

L'URL del video allegato al messaggio

created_time

datetime

L'ora di creazione del messaggio

from

oggetto
id
email
name
username

Informazioni su chi ha inviato il messaggio. Può trattarsi di una persona, una Pagina o un account Instagram per professionisti.

L'ID può essere un ID per Instagram, un ID per singola Pagina, un ID Pagina o l'ID di un account Instagram per professionisti della tua azienda.

L'e-mail di una persona o una Pagina Facebook. Solo messaggi della Pagina.

Il nome di una persona o una Pagina Facebook. Solo messaggi della Pagina.

Il nome utente di una persona su Instagram o del tuo account Instagram per professionisti. Solo messaggi di Instagram.

"from": {
    "username": "INSTAGRAM-USERNAME",
    "id": "ID"
  }

id

stringa

L'ID di un messaggio

is_unsupported

booleano

Restituito solo quando true; un messaggio contiene contenuti non supportati.

message

stringa

Contenuto testuale del messaggio. Se il messaggio non contiene testo, questo campo sarà vuoto.

reactions

array
data array
reaction emoji
users array di oggetti
id

username

I tipi di reazioni che il messaggio ha ricevuto, con un elenco di tutte le persone che hanno reagito con quel tipo di reazione.

Un array di oggetti reaction

Il tipo di reazione emoji

Un elenco delle persone che hanno reagito al messaggio


L'ID può essere un ID per Instagram per una persona su Instagram o l'ID di un account Instagram per professionisti della tua azienda.

Il nome utente di una persona su Instagram o del tuo account Instagram per professionisti. Solo messaggi di Instagram.

"reactions":
  {
    "reaction": "❤️",
    "users" : [
      {
        "username": "INSTAGRAM-USERNAME",
        "id": "ID", 
      },
    ]
  }

shares

array

Condivisioni di contenuti multimediali, ad esempio post o modelli di prodotto, inclusi nel messaggio. Tieni presente che, per recuperare i dati per l'oggetto shares, devi richiedere anche i sottocampi.

"shares": {
  "data": [{
    "template": {
      "payload":{
        "product": {
           "elements":{     //Can contain multiple products if applicable
             "data": [
              {
                "id" : "PRODUCT-ID",    // 0 if business can't see this product
                "retailer_id": "ID-ASSIGNED-BY-THE-RETAILER", 
                "image_url" : "IMAGE-URL", 
                "name" : "PRODUCT-NAME",
                "price" : "$10"
              },
            ],
          }
        }
      }
    }
  }]
}

story

array

Il link e l'ID di una storia. Sono supportate solo menzioni e risposte.

StoryReply: 
{
    "link": "CDN-URL",
    "id": "STORY-ID"
}

StoryMention: 
{
    "link": "CDN-URL",
    "id": "STORY-ID"
}

tags

oggetto

Un array data che contiene i nomi dei tag che indicano la cartella e l'origine del messaggio.

  • Per le Pagine Facebook, name può essere inbox, read, source:chat.

to

oggetto
data array
id
email
name
username

Informazioni su chi ha ricevuto il messaggio



L'ID può essere un ID di Instagram, un ID della singola Pagina, un ID della Pagina o l'ID di un account Instagram per professionisti della tua azienda.

L'e-mail di una persona o una Pagina Facebook. Solo messaggi della Pagina.

Il nome di una persona o una Pagina Facebook. Solo messaggi della Pagina.

Il nome utente di una persona su Instagram o del tuo account Instagram per professionisti. Solo messaggi di Instagram.

"to": {
  "data": [
    { 
      "username": "INSTAGRAM-USERNAME", 
      "id": "ID" 
    }
  ]
}

Segmenti

Nome Descrizione

/attachments

File allegati al messaggio.

/shares

Elementi condivisi, inclusi link, foto, video, adesivi e prodotti.

Creazione

Non puoi eseguire questa operazione su questo endpoint.

Aggiornamento

Non puoi eseguire questa operazione su questo endpoint.

Eliminazione

Non puoi eseguire questa operazione su questo endpoint.