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.
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.
Inattività dopo la quale le conversazioni nella cartella Richieste non vengono più restituite.
Chiamate alla Conversations API che un'app può effettuare al secondo per ogni account professionale di Instagram.
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.
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.
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.
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.
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