AccediInizia la prova gratuita
easyCoexistence API ufficiali

Leggere la cronologia dei messaggi di Messenger tramite l'API

La cronologia Messenger di una Pagina Facebook si legge con GET /{page-id}/conversations?platform=messenger, che elenca gli ID delle conversazioni con l'ora dell'ultimo aggiornamento, poi GET /{conversation-id}?fields=messages per gli ID dei messaggi e GET /{message-id} per il mittente, il destinatario, il testo e gli allegati di ogni messaggio. Meta restituisce i dettagli dei 20 messaggi più recenti di una conversazione, e le chiamate richiedono un token della Pagina con pages_messaging.

easyCoexistence inoltra al tuo endpoint i nuovi messaggi Messenger di una Pagina man mano che arrivano, e send_social_dm risponde entro la finestra di 24 ore, da Claude, ChatGPT o dal tuo codice.

20 messages

Solo i 20 messaggi più recenti di una conversazione restituiscono i dettagli; quelli più vecchi restituiscono un errore che indica che il messaggio è stato eliminato.

2 per second

Chiamate alla Conversations API che un'app può effettuare per ogni Pagina Facebook.

30 days

Le conversazioni nella cartella Richieste che non sono attive da questo periodo vengono escluse dai risultati dell'API.

MESSAGING or MODERATE

L'attività sulla Pagina che la persona titolare del token deve poter svolgere per leggere le conversazioni.

80006

Errore per troppe chiamate all'API di Messenger verso un account Pagina; Meta consiglia di attendere un po' e riprovare.

Come si elencano le conversazioni di una Pagina?

Con GET /{page-id}/conversations, impostando platform su messenger. Il risultato contiene un array data di ID delle conversazioni, ciascuno con updated_time, l'ora in cui è stato aggiunto l'ultimo messaggio, e un oggetto paging; il riferimento di Meta segnala che la paginazione basata sul tempo non è disponibile su questo endpoint, quindi segui l'oggetto paging per scorrere l'elenco.

Listing a Page's Messenger conversations
GET /{page-id}/conversations?platform=messenger

{
  "data": [
    { "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" },
    { "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" }
  ],
  "paging": { ... }
}

Come si trova la conversazione di una persona?

Aggiungi alla stessa richiesta user_id, impostato sull'ID con ambito della Pagina della persona. Meta risponde con l'ID della conversazione tra la Pagina e quella persona, che è il percorso più breve da un webhook dei messaggi, dove il PSID arriva come sender.id, fino alla cronologia correlata:

One person's conversation
GET /{page-id}/conversations?platform=messenger&user_id=<PSID>

{ "data": [ { "id": "<CONVERSATION_ID>" } ] }

Come si leggono i messaggi di una conversazione?

In due passaggi. GET /{conversation-id} con fields=messages restituisce gli ID dei messaggi della conversazione, ciascuno con created_time, dal più recente; poi GET /{message-id} con i campi che ti servono, come id, created_time, from, to, message e reply_to, restituisce il contenuto di un singolo messaggio. I campi predefiniti sono id e created_time, e un campo senza dati viene omesso dalla risposta.

Quali campi si possono leggere?

Una conversazione e un messaggio espongono campi diversi. Questi sono quelli elencati nei riferimenti di Meta per la messaggistica delle Pagine:

  • Conversazione: id, updated_time, participants con il loro ID, nome ed email, messages, e is_owner quando Conversation Routing è attivo.
  • Messaggio: id, created_time, from e to, ciascuno con ID, nome ed email, e message, il testo, vuoto quando non c'è.
  • attachments: file, immagini e video con i rispettivi URL CDN, e is_unsupported, restituito solo quando un messaggio contiene contenuti non supportati.
  • reactions, reply_to con il mid a cui risponde e is_self_reply, e shares per i post e i reel condivisi.
  • tags: la cartella e la fonte del messaggio, come inbox, read o source:chat.

Fino a dove si può leggere indietro?

Fino all'inizio della conversazione per gli ID, ma non per i contenuti. La guida di Meta dice che l'endpoint della conversazione restituisce tutti gli ID dei messaggi di una conversazione, mentre i dettagli arrivano solo per i 20 messaggi più recenti; chiedere un messaggio più vecchio restituisce un errore che indica che il messaggio è stato eliminato. Le conversazioni nella cartella Richieste inattive da 30 giorni non vengono restituite affatto.

Quali permessi e attività servono?

Un token di accesso della Pagina di qualcuno che può svolgere l'attività MESSAGING o MODERATE sulla Pagina, con i permessi pages_manage_metadata, pages_read_engagement e pages_messaging. Leggere le conversazioni con persone che non hanno alcun ruolo sull'app, sulla Pagina o sull'azienda richiede Advanced Access, che Meta concede tramite App Review.

Quali limiti si applicano alle chiamate?

I limiti di frequenza di Meta danno alla Conversations API 2 chiamate al secondo per Pagina, e le chiamate oltre il limite tornano con 613 o 80006, There have been too many messenger api calls to this Page account. Una Pagina che raggiunge il limite ad alto volume di Meta, come l'invio di oltre 40 messaggi al secondo, non può elencare le sue conversazioni finché il volume non scende, anche se una singola conversazione può ancora essere letta per i nuovi messaggi.

Quando usare l'API invece dei webhook?

Per il passato. I webhook consegnano i nuovi messaggi man mano che arrivano, e Meta segnala che le notifiche passate non possono essere interrogate in seguito, quindi la Conversations API è il modo in cui un'integrazione legge ciò che è arrivato prima che iniziasse ad ascoltare, o recupera dopo un'interruzione. Con Conversation Routing attivo, il campo is_owner restringe l'elenco alle conversazioni di cui l'app è responsabile, cosa che Meta suggerisce per il recupero dopo un'interruzione.

Come easyCoexistence legge la cronologia Messenger?

Non legge la cronologia. La Pagina si collega con i permessi pages_messaging, pages_manage_metadata e pages_read_engagement, ma nessuno strumento chiama la Conversations API e i token delle Pagine non vengono consegnati. I nuovi messaggi arrivano al tuo endpoint tramite set_social_webhook_destination man mano che arrivano, inoltrati senza conservarne una copia, così il tuo sistema conserva la cronologia di cui ha bisogno.

Errori comuni

  • Aspettarsi il contenuto dei messaggi nella chiamata di elenco. L'endpoint della conversazione restituisce gli ID dei messaggi; leggi i campi di ogni messaggio da /{message-id}.
  • Contare sull'intera cronologia. I dettagli si fermano ai 20 messaggi più recenti, quindi salva ciò che ti serve dai webhook man mano che arrivano i messaggi.
  • Interrogare periodicamente per i nuovi messaggi. Con 2 chiamate al secondo per Pagina, un ciclo di polling raggiunge presto il limite di frequenza, mentre il webhook dei messaggi li consegna appena avvengono.
  • Paginare le conversazioni per data con since e until. La paginazione basata sul tempo non è disponibile sull'endpoint delle conversazioni; segui invece l'oggetto paging.
Farlo con EasyCoexistence

Non ha uno strumento per la Conversations API, quindi la cronologia precedente si legge nella casella della Pagina. Da US$ 9 a US$ 0.75 per connessione al mese, con prezzo che scende man mano che aggiungi connessioni, con i primi 3 giorni di prova gratuita.

Domande frequenti

La Conversations API include i messaggi della stessa Pagina?

Sì. I campi from e to indicano la persona o la Pagina, quindi i messaggi di una conversazione includono entrambe le parti.

Posso leggere le conversazioni di Messenger senza App Review?

Per le persone con un ruolo sull'app o sulla Pagina, lo Standard Access è sufficiente. Le conversazioni con chiunque altro richiedono Advanced Access, concesso tramite App Review.

La Conversations API può inviare risposte?

No. Il riferimento di Meta per la conversazione indica che l'endpoint non può pubblicare; le risposte passano dalla Send API su /{page-id}/messages.

easyCoexistence conserva le mie conversazioni di Messenger?

No, non di default. Gli eventi inoltrati vengono passati senza conservarne una copia; con un'automazione attiva, il testo dei messaggi viene conservato per 7 giorni e i log di esecuzione delle automazioni per 30 giorni.

Continua a leggere

Collega il tuo primo canale in due minuti.

Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.

  • 3 giorni gratis
  • Disdici quando vuoi
  • Solo API ufficiali
  • Monitorato 24/7

Verificato il