AccediInizia la prova gratuita
easyCoexistence API ufficiali

Leggere la cronologia dei DM di Instagram: la Conversations API

L'API Conversations di Instagram legge la cronologia dei DM di un account professionale su graph.instagram.com. GET /me/conversations?platform=instagram elenca le conversazioni con il loro updated_time, GET /<CONVERSATION_ID>?fields=messages elenca i messaggi di una conversazione per ID e ora, e GET /<MESSAGE_ID>?fields=id,created_time,from,to,message restituisce un singolo messaggio. I dettagli sono disponibili per i 20 messaggi più recenti di ogni conversazione.

easyCoexistence inoltra i nuovi DM di Instagram al tuo endpoint non appena arrivano e risponde con send_social_dm entro la finestra di 24 ore, da Claude, ChatGPT o dal proprio codice, tramite l'API ufficiale di Meta; non ha uno strumento per la cronologia della Conversations API.

20

I messaggi più recenti per conversazione di cui l'API restituisce i dettagli; quelli più vecchi rispondono con un errore che dice che sono stati eliminati.

30 days

Inattività dopo la quale le conversazioni nella cartella Richieste non vengono più restituite.

2/sec

Chiamate alla Conversations API che un'app può effettuare al secondo per ogni account professionale di Instagram.

2 permissions

instagram_business_basic e instagram_business_manage_messages, con un token di qualcuno che può gestire i messaggi dell'account.

Come si elencano le conversazioni di un account?

Con GET /me/conversations, oppure /<IG_ID>/conversations, e platform=instagram, usando un token di accesso Instagram User di qualcuno che può gestire i messaggi dell'account. Ogni voce dell'array data è una conversazione, con il suo id e updated_time.

Listing conversations
GET https://graph.instagram.com/me/conversations
  ?platform=instagram
  &access_token=<ACCESS_TOKEN>

{
  "data": [
    { "id": "<CONVERSATION_ID>", "updated_time": "<UPDATED_TIME>" }
  ]
}

Come si trova la conversazione con una persona?

Si aggiunge user_id con l'ID con ambito Instagram della persona, cioè l'IGSID che arriva come sender.id quando scrive all'account, e la risposta restituisce l'id di quella conversazione. Trasforma un evento webhook nel suo thread senza scorrere l'intero elenco.

One person's conversation
GET https://graph.instagram.com/me/conversations
  ?user_id=<IGSID>
  &access_token=<ACCESS_TOKEN>

Come si leggono i messaggi?

In due passaggi. GET /<CONVERSATION_ID>?fields=messages elenca i messaggi della conversazione per id e created_time, cioè i campi predefiniti. GET /<MESSAGE_ID> con fields=id,created_time,from,to,message restituisce poi un singolo messaggio: chi lo ha inviato e a chi, ciascuno con un username e un ID, e il suo testo.

A conversation's messages, then one message
GET https://graph.instagram.com/<CONVERSATION_ID>
  ?fields=messages
  &access_token=<ACCESS_TOKEN>

GET https://graph.instagram.com/<MESSAGE_ID>
  ?fields=id,created_time,from,to,message
  &access_token=<ACCESS_TOKEN>

Fino a quando si può risalire indietro?

La guida e la panoramica di Meta fissano quattro limiti su ciò che viene restituito:

  • Dettagli dei messaggi: i 20 messaggi più recenti di ogni conversazione; chiedendone uno più vecchio si ottiene un errore che dice che è stato eliminato.
  • Richieste: le conversazioni nella cartella Richieste senza attività da 30 giorni non vengono restituite.
  • Condivisioni: un post o un Reel condiviso viene restituito solo come URL della sua immagine o del suo video.
  • Frequenza: 2 chiamate al secondo per ogni account professionale di Instagram.

Di cosa ha bisogno?

Con Instagram Login, dei permessi instagram_business_basic e instagram_business_manage_messages e di un token di qualcuno che può gestire i messaggi dell'account. L'Accesso Standard basta per gli account di cui si è proprietari o che si gestiscono e che sono stati aggiunti all'app; servire altri account richiede l'Accesso Avanzato. Inoltre, nelle impostazioni dell'app Instagram dell'account deve essere attiva l'opzione Consenti accesso ai messaggi.

Perché conservare una registrazione dai webhook?

Poiché l'API restituisce i dettagli solo per gli ultimi 20 messaggi di ogni conversazione, la cronologia completa va salvata man mano che avviene. Il webhook dei messaggi consegna i DM non appena arrivano, con l'IGSID della persona come sender.id, e arrivano anche i messaggi inviati dall'account, con gli ID invertiti, così si possono registrare entrambi i lati di una conversazione.

Come si legge la cronologia dei DM tramite easyCoexistence?

Inoltra i DM invece di leggere la cronologia. I nuovi DM raggiungono il proprio endpoint non appena arrivano, una volta impostato con set_social_webhook_destination, inoltrati senza conservarne una copia, e send_social_dm risponde entro la finestra di 24 ore, da Claude, ChatGPT o dal proprio codice. Nessuno strumento chiama me/conversations, quindi i messaggi precedenti si leggono nell'app Instagram, oppure vengono conservati dal proprio sistema man mano che arrivano.

Errori comuni

  • Aspettarsi l'intera conversazione dall'API. I dettagli si fermano ai 20 messaggi più recenti, quindi conserva i DM dal webhook dei messaggi man mano che arrivano.
  • Interrogare le conversazioni per cercare nuovi DM. L'API consente 2 chiamate al secondo per account, mentre il webhook dei messaggi consegna ogni DM non appena arriva.
  • Cercare una vecchia richiesta di messaggio. Le conversazioni in Richieste con 30 giorni di inattività non vengono più restituite.
  • Leggere l'errore di eliminato come una cancellazione da parte della persona. Meta risponde così per qualsiasi messaggio più vecchio dei 20 più recenti.
Farlo con EasyCoexistence

Da US$ 9 a US$ 0,75 per connessione al mese, con riduzione man mano che aggiungi connessioni, con i primi 3 giorni gratuiti.

Domande frequenti

È possibile esportare l'intera cronologia dei DM di un account Instagram?

Non per intero tramite l'API: elenca le conversazioni ma restituisce i dettagli solo per i 20 messaggi più recenti di ognuna. Una registrazione completa si ottiene salvando i DM man mano che il webhook li consegna.

Leggere i messaggi tramite l'API li segna come letti?

No. Meta afferma che i messaggi consegnati tramite l'API non vengono segnati come letti nell'app Instagram finché non viene inviata una risposta.

La Conversations API funziona con Instagram Login?

Sì. La guida di Meta è scritta per Instagram Login, con chiamate a graph.instagram.com e ai permessi instagram_business_*.

Come si ottiene lo username di una persona da una conversazione?

Richiedi from su un messaggio, che restituisce lo username e l'ID del mittente. La User Profile API restituisce di più, come il nome, a partire dal suo IGSID una volta che ha scritto all'account.

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