DM su Instagram tramite API e la finestra di 24 ore
Tramite l'API di Instagram, un account professionale può rispondere a chiunque gli abbia inviato un DM, entro una finestra di messaggistica standard che dura 24 ore per la maggior parte delle conversazioni. La persona deve scrivere per prima, e l'account deve attivare Consenti l'accesso ai messaggi nell'app Instagram prima che qualsiasi app possa leggere o inviare i suoi DM.
easyCoexistence risponde ai DM di Instagram con send_social_dm da Claude, ChatGPT o dal tuo codice, dentro la finestra di 24 ore, e inoltra i nuovi DM al tuo endpoint non appena arrivano.
La finestra standard per rispondere dopo un messaggio della persona, per la maggior parte delle azioni dell'utente.
La finestra separata Human Agent di Meta, per le risposte che una persona scrive e marca con human_agent.
Il testo più lungo che un DM può contenere tramite l'API, codificato in UTF-8.
Sottocodice di errore, sotto il codice 10, per un messaggio inviato fuori dalla finestra consentita.
Inattività dopo la quale una conversazione nella cartella Richieste non viene più restituita dall'API.
Chi può contattare un account tramite l'API?
Chiunque gli abbia già scritto. Le conversazioni iniziano solo quando una persona scrive all'account, dal feed, da un post, da una menzione in una Storia o altrove, e da quel momento un'app può rispondere. Chi commenta un post può anche ricevere una risposta privata, descritta sotto.
L'API non permette di inviare il primo messaggio, e le conversazioni di gruppo non sono supportate: ogni conversazione è tra l'account e una sola persona.
Quanto dura la finestra di messaggistica?
24 ore per la maggior parte delle conversazioni. Meta la chiama finestra di messaggistica standard, e l'azione che la apre ne stabilisce la durata: un messaggio della persona apre 24 ore, e il suo messaggio successivo la riapre. Quando il primo messaggio arriva da chi ha toccato un annuncio Click-to-Direct, la finestra può durare fino a 7 giorni.
Meta prevede anche una finestra separata Human Agent di 7 giorni, per le risposte scritte da una persona e marcate human_agent da un'app con quella funzione, pensate per i casi che la finestra standard non copre. Un invio fuori da qualsiasi finestra aperta fallisce con codice 10, sottocodice 2534022.
Cos'è Consenti l'accesso ai messaggi?
Un'impostazione dell'app Instagram che permette agli strumenti collegati di leggere e inviare i messaggi diretti dell'account. La guida di Meta la colloca in Impostazioni, Messaggi e risposte alle storie, Controlli dei messaggi, Strumenti collegati, e l'account deve attivarla prima che un'app possa gestire i suoi DM. Finché è disattivata, gli invii falliscono con codice 200, sottocodice 2534041: il titolare dell'account ha disattivato l'accesso ai messaggi diretti di Instagram.
Come funzionano le risposte private ai commenti?
Un account professionale può inviare un solo messaggio a chi ha commentato il suo post, Reel o Storia, entro 7 giorni dal commento, oppure durante una Live solo mentre la diretta è in corso. Il messaggio arriva nella casella della persona se segue l'account e tra le richieste se non lo segue, e include un link al post. Un eventuale follow-up deve attendere la risposta della persona, e poi parte entro 24 ore da quella risposta.
Dove compaiono le conversazioni API nell'app?
Nella normale casella di Instagram dell'account, con alcune differenze da conoscere:
- Le nuove conversazioni di chi segue l'account iniziano in Principale; quelle di chi non lo segue, in Richieste.
- Una conversazione a cui si risponde tramite un'app passa nella cartella Generale, qualunque siano le impostazioni della casella.
- I messaggi consegnati a un'app non vengono segnati come letti nell'app Instagram finché non viene inviata una risposta.
- Le richieste senza attività per 30 giorni non vengono più restituite dall'API.
Con quale frequenza può inviare un account?
Meta stabilisce i limiti di invio per ogni account professionale Instagram, separatamente dalle altre chiamate API dell'app:
- Testo, link, reazioni e sticker: 100 chiamate al secondo.
- Audio o video: 10 chiamate al secondo.
- Risposte private ai commenti di post e Reel: 750 chiamate all'ora.
- Conversations API: 2 chiamate al secondo.
Cosa può contenere un messaggio?
Testo, link, immagini, audio, video, file PDF, sticker, reazioni, template e post di proprietà dell'account. Il testo deve essere in UTF-8 e non superare i 1.000 byte, che equivalgono a meno caratteri quando ci sono accenti ed emoji. Le immagini possono essere PNG o JPEG fino a 8 MB, mentre audio, video e PDF fino a 25 MB.
Errori comuni
- Lasciare disattivato Consenti l'accesso ai messaggi. Gli invii falliscono con codice 200, sottocodice 2534041, finché l'account non lo attiva nell'app.
- Contare i caratteri invece dei byte. Le lettere accentate occupano due byte in UTF-8 e la maggior parte delle emoji quattro, quindi un testo che supera un controllo di 1.000 caratteri può comunque essere rifiutato.
- Inviare una seconda risposta privata allo stesso commento. Meta ne consente una sola; il messaggio successivo attende la risposta della persona.
- Calcolare la finestra dal primo messaggio della conversazione. Parte dall'ultimo messaggio della persona, quindi ogni sua risposta dà all'account più tempo.
Le automazioni possono rispondere da sole, con un testo fisso o con l'AI, e le regole commento-DM inviano risposte private a tutte le ore. Da US$ 9 a US$ 0,75 per connessione al mese, con prezzo che scende man mano che aggiungi connessioni, e i primi 3 giorni di prova gratuita.
Domande frequenti
Un'azienda può inviare per prima un DM su Instagram?
Non tramite l'API. La persona deve scrivere all'account per prima, oppure commentare uno dei suoi post, cosa che consente una sola risposta privata entro 7 giorni.
Cosa succede quando le 24 ore sono scadute?
L'API rifiuta l'invio finché la persona non scrive di nuovo, cosa che apre una nuova finestra. Le risposte scritte da una persona possono usare la finestra separata Human Agent di Meta, di 7 giorni, con il tag human_agent.
Quanto può essere lungo un DM di Instagram inviato tramite l'API?
Fino a 1.000 byte di testo UTF-8 per messaggio. Accenti ed emoji occupano più di un byte ciascuno, quindi un messaggio con questi elementi contiene meno di 1.000 caratteri.
I messaggi letti tramite l'API risultano letti nell'app?
No. Un messaggio consegnato a un'app resta non letto nella casella di Instagram finché non viene inviata una risposta.
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