Messenger Send API: invio di messaggi da una Pagina Facebook
Una Pagina Facebook invia messaggi Messenger con POST /{page-id}/messages e un token di accesso della Pagina: il destinatario contiene il PSID della persona, ovvero l'ID limitato alla Pagina; messaging_type è RESPONSE o UPDATE entro la finestra di messaggistica standard oppure MESSAGE_TAG dopo di essa; message contiene testo o un allegato come immagine, audio, video o file. Meta risponde con recipient_id e message_id.
easyCoexistence risponde ai DM su Messenger con send_social_dm da Claude, ChatGPT o dal tuo codice entro la finestra di 24 ore, come testo; media, risposte rapide e template non sono coperti.
Chiamate Send API che un'app può effettuare per Pagina per i messaggi con testo, link, reazioni e sticker.
Chiamate Send API che un'app può effettuare per Pagina per i messaggi con audio o video.
L'allegato più grande che la Messenger Platform salva per il riutilizzo; un'immagine caricata da un URL è limitata a 8 MB.
Numero massimo di immagini che un messaggio può contenere nel proprio array attachments, l'unico tipo di media ammesso lì.
Durata di un attachment_id salvato prima che il media debba essere caricato di nuovo.
Cosa contiene una richiesta Send API?
Meta elenca sei componenti che un invio deve includere: l'ID della Pagina che invia, l'ID della persona destinataria, un token di accesso della Pagina, il consenso della persona, il tipo di messaggio e il contenuto. La richiesta è un POST di JSON verso /{page-id}/messages, e una risposta a chi ha appena scritto ha questa forma:
POST /{page-id}/messages
{
"recipient": { "id": "<PSID>" },
"messaging_type": "RESPONSE",
"message": { "text": "Your order ships tomorrow." }
}
{ "recipient_id": "<PSID>", "message_id": "<MESSAGE_ID>" }Quale ID va inserito in recipient?
Di solito il PSID, cioè l'ID limitato alla Pagina che Meta assegna a una persona la prima volta che scrive alla Pagina; arriva come sender.id nel webhook dei messaggi. L'oggetto recipient accetta altri tipi di ID per casi particolari:
- id: il PSID, univoco per quella persona e quella Pagina.
user_ref: per chi ha usato un plugin o un pulsante postback per scrivere alla Pagina.comment_idopost_id: per una risposta privata a un commento o a un post di un visitatore.- Gli ID di Facebook Login sono limitati all'app e non funzionano su Messenger Platform.
Quale messaging_type deve usare un messaggio?
Il tipo indica a Meta perché il messaggio viene inviato e decide quando l'invio è consentito. Il riferimento dei messaggi della Pagina di Meta elenca quattro valori:
- RESPONSE: una risposta a un messaggio ricevuto dalla Pagina, promozionale o no, entro la finestra di messaggistica standard.
- UPDATE: un messaggio che la Pagina invia di propria iniziativa, promozionale o no, anch'esso entro la finestra.
MESSAGE_TAG: un messaggio non promozionale inviato dopo la finestra, con un tag che corrisponde a un caso d'uso approvato.- UTILITY: un messaggio di utilità costruito da un template approvato, come un aggiornamento di ordine o appuntamento.
Cosa può contenere un messaggio?
Testo oppure un oggetto allegato con un tipo e un payload: gli allegati di immagine, audio, video e file puntano a un URL o a un attachment_id salvato, e gli allegati template trasportano messaggi strutturati con pulsanti. Lo stesso endpoint accetta anche questi campi:
- attachments: un array fino a 30 immagini inviate in un unico messaggio.
reply_tocon un mid: una risposta a uno specifico messaggio precedente, della persona o della Pagina.quick_replies: fino a 13 pulsanti sopra il campo di composizione, ciascuno con un titolo fino a 20 caratteri.sender_action: un indicatore di digitazione, un segno di lettura o una reazione, inviato in una richiesta separata dal messaggio stesso.notification_type: REGULAR per impostazione predefinita, oppureSILENT_PUSHoNO_PUSH.
Quanto possono essere grandi gli allegati?
La guida di Meta al salvataggio degli asset fissa i limiti per i media che la Messenger Platform recupera e conserva: asset fino a 25 MB, immagini fino a 8 MB se caricate da un URL, audio inviato con un Content-Type audio e video recuperato entro 75 secondi. Impostando is_reusable su true si ottiene un attachment_id che può essere riusato solo dalla Pagina che lo ha inviato, per 90 giorni, e POST /{page-id}/message_attachments carica i media in anticipo.
Quali sono i limiti di frequenza della Send API?
Meta li conta per Pagina e per tipo di contenuto. Il suo riferimento dei messaggi della Pagina elenca 613, Calls to this api have exceeded the rate limit, tra gli errori di invio, quindi rallenta invece di riprovare subito quando compare:
- 300 chiamate al secondo per Pagina per i messaggi con testo, link, reazioni e sticker.
- 10 chiamate al secondo per Pagina per i messaggi con audio o video.
- Troppi messaggi verso una singola conversazione possono essere limitati anche da soli.
- Chiamate API Messenger complessive: 200 volte il numero di utenti coinvolti, su una finestra mobile di 24 ore.
- Oltre 40 messaggi al secondo, la casella dei messaggi della Pagina smette di mostrare i nuovi messaggi e la Pagina non può inviare finché il volume non scende.
Quali errori restituisce la Send API?
La tabella degli errori di Messenger di Meta associa a ogni codice un sottocodice che indica la causa. Questi sono quelli che una Pagina incontra più spesso durante l'invio:
- 10 con 2018278 o 2534022: messaggio inviato al di fuori della finestra consentita.
- 10 con 2018300: un'altra app controlla la conversazione.
- 100: parametro non valido, come un ID destinatario errato; il sottocodice 2018001 indica «No matching user found».
- 551: la persona non è disponibile, forse perché ha bloccato la Pagina o disattivato l'account; 200 con 1545041 indica «This person isn't available right now».
- 200 con 2018028: l'app non può scrivere a persone al di fuori dei propri ruoli finché
pages_messagingnon è approvato e l'app non è attiva. - 10904: la Pagina ha i messaggi disattivati nelle impostazioni.
Come easyCoexistence invia tramite questa API?
send_social_dm prende account_id, recipient_id della persona, che è sender.id in un evento messages inoltrato, e il testo, e li invia a /{page-id}/messages con messaging_type RESPONSE. Il risultato è la risposta di Meta con message_id, e un invio rifiutato restituisce il codice di errore e il messaggio di Meta. Media, risposte rapide, template e azioni del mittente non sono tra gli strumenti: send_social_dm invia testo.
Errori comuni
- Inviare un indicatore di digitazione insieme al messaggio. Meta vuole sender_action da solo con il destinatario, e testo o template in una richiesta separata.
- Inviare una raffica a una sola persona. Meta può limitare una singola conversazione anche da sola, oltre alle 300 chiamate al secondo per Pagina.
- Inviare audio o video alla velocità del testo. I messaggi con audio o video sono soggetti a 10 chiamate al secondo per Pagina.
- Riutilizzare un attachment_id più vecchio di 90 giorni. Gli ID di allegati salvati scadono, quindi carica di nuovo il media per ottenerne uno nuovo.
Le automazioni rispondono da sole ai nuovi messaggi con un testo fisso o una risposta IA. Da US$ 9 a US$ 0,75 per connessione al mese, con calo man mano che aggiungi connessioni, con i primi 3 giorni di prova gratuita.
Domande frequenti
Il Send API di Messenger è gratuito?
Sì, per i messaggi standard. La panoramica di Meta definisce la Messenger Platform gratuita da usare, quindi una Pagina che risponde a chi le ha scritto non paga nulla per messaggio; i messaggi di marketing sono addebitati per messaggio.
Quale attività della Pagina serve per inviare un messaggio?
La panoramica Messenger di Meta chiede un token della Pagina da qualcuno che può eseguire le attività MESSAGING e MODERATE, con il permesso pages_messaging concesso.
easyCoexistence può rispondere con immagini su Messenger?
Oggi no. send_social_dm invia testo, e nessuno strumento invia un allegato.
Quanto costa easyCoexistence per una Pagina Facebook?
Ogni Pagina che colleghi è una connessione, fatturata da US$ 9 a US$ 0,75 per connessione al mese a seconda di quante ne hai, e i primi 3 giorni sono una prova gratuita.
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