Questo documento contiene il registro modifiche per le versioni attuali della Piattaforma Messenger. La Piattaforma Messenger segue la versione dell'API Graph.
La versione più recente è: v21.0
response_feedback
MessengerIl nuovo evento webhook response_feedback
ti informa quando un utente fornisce feedback su un messaggio inviato da te, cliccando su uno dei pulsanti "pollice in su"/"pollice in giù"/"Risposta buona"/"Risposta scadente". Consulta maggiori dettagli sul webhook qui.
L'app può effettuare ora 300 chiamate al secondo (in precedenza erano 100) per account Instagram per professionisti per messaggi che contengono testo, link, reazioni e adesivi. Ulteriori informazioni.
Componenti di questa nuova API di Instagram:
graph.instagram.com
instagram_business_basic
instagram_business_content_publishing
instagram_business_manage_comments
instagram_business_manage_messages
Monitora eventuali modifiche nel Registro modifiche della piattaforma Instagram, tra cui correzioni di bug e nuove funzionalità
ig_reel
ora sarà un tipo di allegato supportato per il webhook messaggi. Gli allegati dei reel di Instagram saranno di tipo ig_reel
e il payload dell'allegato includerà il titolo, l'URL e l'ID video del reel.
ig_reel
e reel
ora saranno tipi di allegati supportati in un webhook messaggi. Gli allegati dei reel di Instagram saranno di tipo ig_reel
e il payload dell'allegato includerà il titolo, l'URL e l'ID video del reel. Gli allegati dei reel di Facebook saranno di tipo ig_reel
e il payload dell'allegato includerà il titolo, l'URL e l'ID video del reel.
Le aziende che usano il Routing delle conversazioni su Messenger possono ora configurare la funzionalità di assunzione del controllo di una conversazione a livello di singola app. La configurazione originale di assunzione del controllo associata all'app predefinita è ora obsoleta e tutti i valori sono stati migrati. Per saperne di più clicca qui.
Si applica a tutte le versioni.
Oltre a ad_id
e ad_title
, original_media_id
sarà restituito nell'oggetto media
dell'oggetto comments
del campo value
quando una persona commenta un post di Instagram in evidenza o un post pubblicitario di Instagram. Per maggiori informazioni, consulta Configurazione di webhook per Instagram.
message_edits
Il nuovo evento webhook message_edits
ti informa quando un utente modifica un messaggio inviato in precedenza. Scopri di più su questo evento webhook qui.
"Reel" ora sarà un tipo di allegato supportato per i webhook di messaggi inviati per le conversazioni su Messenger. Questi allegati saranno classificati come tipo reel
e il payload dell'allegato includerà il titolo, l'URL e l'ID video del reel.
I comandi sono parole chiave che l'utente può invocare in qualsiasi momento per eseguire azioni specifiche all'interno dell'esperienza di Messenger. I comandi sono composti dal comando stesso e da un indizio, che fornisce all'utente informazioni sul suo funzionamento. Ad esempio, quando un utente digita "aiutami a prenotare voli e hotel per il Messico per l'ultima settimana di dicembre", invoca i comandi per voli e hotel configurati dall'agenzia di viaggi. Per saperne di più clicca qui.
Il menu dei comandi è un nuovo menu che stiamo introducendo e che apparirà automaticamente quando configurerai i comandi. Se hai già configurato un menu always-on per la tua esperienza su Messenger, il menu comandi lo sovrascriverà. Per saperne di più clicca qui.
Ora le persone possono condividere la tua esperienza di messaggistica dalla Pagina del profilo business su Messenger. Questo facilita il passaparola relativo alla tua esperienza su Messenger. Per saperne di più clicca qui.
I comandi saranno visualizzati sul profilo business dopo che avrai configurato i comandi per la tua esperienza su Messenger. Le persone possono accedere al profilo business toccando il nome della Pagina in alto e scoprire i comandi che hai reso disponibili nella tua esperienza su Messenger.
La schermata di benvenuto mostra l'elenco dei comandi supportati dall'esperienza di messaggistica, consentendo alle persone di capire facilmente quali azioni può eseguire l'esperienza di Messenger. Per saperne di più clicca qui.
Se stai sviluppando l'app per inviare e ricevere messaggi per la tua Pagina, non dovrai procedere all'analisi dell'app. Se stai pianificando di recuperare le informazioni del profilo utente, devi comunque procedere all'analisi dell'app per le autorizzazioni necessarie per accedere all'API User Profile.
Il routing delle conversazioni è ora disponibile per Instagram. Il routing delle conversazioni consente a Meta di indirizzare le conversazioni tra la tua azienda e i clienti o i clienti potenziali all'app che hai indicato come responsabile della gestione della conversazione. Questo routing consente alla tua azienda di creare conversazioni significative con le persone e di ridurre al minimo le chiamate API ai server di Meta.
L'accesso all'API Custom Labels e all'API Personas è stato ripristinato per le aziende che operano in Europa e per le persone in Europa e Giappone che si connettono con aziende a livello globale.
Le aziende e le agenzie possono ora collegare facilmente le loro inserzioni che rimandano a Messenger e a Instagram Direct a un messaggio di benvenuto creato in un'app partner senza dover usare uno snippet di codice JSON. Il messaggio di benvenuto sarà visualizzato come menu a discesa in Gestione inserzioni quando crei l'inserzione che rimanda a Messenger e a Instagram Direct. Per saperne di più clicca qui.
La funzione Risposta privata è ora disponibile per i commenti su Facebook Reels.
Aggiornamenti alle risposte private per gruppi, nuovi campi che supportano le informazioni sugli autori dei commenti tramite il campo from
e il contesto dell'ID principale tramite parent_id
introdotti nel webhook group_feed
. Potresti dover aggiornare il tuo server webhook per la gestione di questi nuovi campi.
In qualità di azienda, puoi usare più provider di messaggistica terzi per diverse conversazioni con i clienti, come la generazione di contatti, le offerte di marketing per i tuoi prodotti o le domande di assistenza clienti. Il routing delle conversazioni ti consente di definire quali partner controllano le conversazioni con i clienti in un determinato momento, per offrire le informazioni di cui i clienti hanno bisogno. Puoi creare e gestire le regole del routing dei messaggi nelle impostazioni della Pagina.
Il modello del pulsante invia un messaggio di testo con un massimo di tre pulsanti allegati. Questo modello è utile per offrire al destinatario del messaggio delle opzioni tra cui scegliere, come risposte predeterminate a una domanda o azioni da intraprendere. I tipi di pulsante supportati sono postback
e web_url
.
In qualità di azienda, puoi usare più provider di messaggistica terzi per diverse conversazioni con i clienti, come la generazione di contatti, le offerte di marketing per i tuoi prodotti o le domande di assistenza clienti. Il routing delle conversazioni ti consente di definire quali partner controllano le conversazioni con i clienti in un determinato momento, per offrire le informazioni di cui i clienti hanno bisogno. Puoi creare e gestire le regole del routing dei messaggi nelle impostazioni della Pagina.
Il modello del pulsante invia un messaggio di testo con un massimo di tre pulsanti allegati. Questo modello è utile per offrire al destinatario del messaggio delle opzioni tra cui scegliere, come risposte predeterminate a una domanda o azioni da intraprendere. I tipi di pulsante supportati sono postback
e web_url
.
La messaggistica di Instagram è ora disponibile per qualsiasi account di Instagram per professionisti per aziende o creator.
Ora puoi aggiungere un suggerimento di chiamata per consentire ai clienti o alle persone interessate alla tua azienda di chiamarla.
Ora puoi creare inserzioni che includono un flusso di clic che rimandano all'inserzione che ti consentono di chiedere ai clienti o alle persone interessate alla tua azienda di accettare di ricevere messaggi di marketing.
Il routing multi-app è ora disponibile per Instagram Direct e Messenger.
Risposte private
La tua azienda può ora inviare risposte private a una persona che ha commentato un post del gruppo Facebook.
Notifiche ricorrenti
Le notifiche ricorrenti hanno preso il nome di "messaggi di marketing".
Modelli
Ora è disponibile un modello strutturato per acquisire le informazioni di spedizione da un cliente.
API Messaging Insights
Nuovi parametri e metriche disponibili per l'API Messaging Insights.
Notifiche ricorrenti per la Piattaforma Messenger
La proprietà title
per le richieste di iscrizione di notifiche ricorrentinon è più necessaria. Se title
non è impostato, il valore è per impostazione predefinita "Aggiornamenti e promozioni". Questa modifica si applica alle richieste di iscrizione inviate da una Pagina Facebook o da account Instagram per professionisti.
Notifiche ricorrenti per la piattaforma Messenger
La proprietà notification_messages_frequency
per le richieste di iscrizione delle notifiche ricorrenti è obsoleta e non sarà più restituita nelle richieste GET
o notifiche webhook. Tuttavia, i token dei messaggi di notifica creati prima del 2 febbraio 2023 per le notifiche ricorrenti settimanali o mensili saranno supportati e il notification_message_frequency
sarà restituito nelle notifiche webhook.
Ora puoi inviare fino a tre messaggi di follow-up a una persona che abbia accettato la ricezione di notifiche ricorrenti. Tutti e tre i messaggi di follow-up devono essere inviati entro 2 minuti dal primo messaggio di follow-up.
Ora l'endpoint GET /PAGE-ID/notification_message_tokens
è disponibile per la messaggistica su Instagram.
Ora è disponibile la proprietà next_eligible_time
per gli endpoint dei token di notifica dei messaggi. Questo campo restituisce l'orario in cui puoi inviare la prossima notifica ricorrente usando il token del messaggio di notifica.
Messenger API for Instagram
Ora puoi inviare GIF nei messaggi inviati da un account Instagram per professionisti usando Messenger API for Instagram.
Ora l'API Attachment Upload supporta il caricamento dei contenuti multimediali per i messaggi inviati da un account Instagram per professionisti.
Le informazioni di riferimento per le inserzioni che rimandano a una conversazione su Instagram (CTD) ora sono restituite nelle notifiche webhook sui messaggi.
A partire dal 31 marzo 2023, non potrai più scaricare un file CVS dalla dashboard di Messenger Analytics. Visita l'API Messaging Insights per scoprire come ottenere tali insight.
Business Login per Instagram semplifica la registrazione degli utenti Instagram che devono ancora configurare il proprio account per l'accesso all'API attraverso pop-up modali e meno passaggi.
Abbiamo semplificato il follow-up delle inserzioni per acquisizione contatti che rimandano a Messenger tramite:
L'API Messaging Events supporta l'evento lead_submitted
. Le aziende possono usare questo evento per segnalare le risposte di contatti acquisiti dalle inserzioni che rimandano a Messenger. Questo nuovo evento di messaggistica è stato pubblicato come versione beta aperta. I report in Gestione inserzioni saranno presto disponibili.
Il menu always-on è ora disponibile per la messaggistica di Instagram.
La messaggistica di Instagram ora supporta le risposte private per i commenti alla storie di Instagram Live e ai post per le inserzioni. Potresti dover aggiornare il tuo server webhook per la gestione di questi nuovi campi.
Ora puoi ottenere una lista di tutti i token per messaggi di notifica validi utilizzando l'endpoint GET /PAGE-ID/notification_message_tokens
.
Gli ID dell'app non saranno più associati ai token per messaggi di notifica. Tutte le app collegate a una Pagina ora riceveranno le notifiche di richiesta di iscrizione relative ai webhook quando una persona fornisce un consenso esplicito alla ricezione delle notifiche ricorrenti.
Sono stati aggiunti i seguenti campi di payload degli allegati dei messaggi:
image_aspect_ratio
: consente di impostare un'immagine a proporzioni orizzontali o quadrate per le richieste di iscrizioneelements
: consente di creare un carosello di immagini per le richieste di iscrizionenotification_message_tokens
: consente di ottenere una lista dei token dei messaggi di notifica correnti notification_messages_cta_text
: consente di personalizzare il testo per le call to action per le richieste di iscrizioneSono stati aggiunti i seguenti modi per ottenere il consenso esplicito per le notifiche ricorrenti:
È stato aggiunto il campo title
alla notifica webhook Notifica ricorrente.
La funzione Risposta privata è ora disponibile per i commenti ai reel di Instagram.
Ora puoi inviare messaggi di Instagram con audio e video che sono stati caricati su un server Meta o inviati dal tuo server.
L'API User Profile supporta il recupero del campo nome utente di Instagram del cliente su API Graph v14.0 e versioni successive.
La funzione Notifiche ricorrenti è un aggiornamento importante per Messenger API che consente alle aziende di inviare messaggi automatizzati proattivi per aumentare il coinvolgimento. Le notifiche ricorrenti aiutano le aziende a inviare messaggi personalizzati e incentrati sul cliente in ogni fase del suo percorso.
Notifiche ricorrenti per Messenger API for InstagramAbbiamo annunciato la versione beta della funzione Notifiche ricorrenti per Messenger API for Instagram. Gli sviluppatori possono iscriversi alla lista per manifestare il proprio interesse per la beta prima di luglio.
Aumento del rate limiting per l'API Send di InstagramAbbiamo aumentato il rate limiting dell'API Send a 100 chiamate API al secondo per ciascun account Instagram per professionisti.
Parametro per il referral di ig.meLe aziende possono aggiungere link ig.me su siti web, e-mail e packaging dei prodotti per permettere agli utenti di avviare conversazioni con un'azienda su Instagram. Stiamo implementando la possibilità per i brand di aggiungere un parametro referral a questi link ig.me per creare esperienze di messaggistica personalizzate.
Nuovo flusso di registrazione dell'API InstagramStiamo annunciando un nuovo flusso di registrazione per l'API Instagram come beta. Gli sviluppatori possono iscriversi alla lista per manifestare il proprio interesse per la beta prima del 29 giugno.
Abbiamo introdotto il menu always-on per il supporto di Messenger API per Instagram, che consente agli utenti di scoprire le funzioni principali di una Pagina e di interagirvi.
Come comunicato il 14 settembre 2021, verrà eseguita la migrazione per tutte le Pagine Facebook per supportare il nuovo comportamento del protocollo di consegna. Prevediamo di concludere la migrazione di tutte le Pagine entro il 18 marzo 2022. Consulta la sezione delle modifiche sostanziali per ulteriori dettagli. Di seguito è riportato un riepilogo dei principali miglioramenti comunicati in precedenza.
Stiamo apportando dei miglioramenti al protocollo di consegna, che aiuta gli sviluppatori e le aziende a lanciare rapidamente esperienze di messaggistica (ad esempio, app), semplifica il superamento del controllo della conversazione tra le app e garantisce un'esperienza utente ottimale impedendo alle app di interferire con le conversazioni in corso. I miglioramenti chiave includono modalità esclusiva, modalità inattiva, nuove API per un controllo più capillare sulla proprietà delle conversazioni e rimozione del requisito di assegnazione di ruoli primari o secondari per le app
Abbiamo introdotto le impostazioni per la personalizzazione del punto di accesso del plug-in per la chat tramite API e il nostro strumento di configurazione proprietario. Questo consentirà alle aziende di scegliere da un insieme di opzioni predefinite l'icona del punto di accesso e la relativa etichetta più adatte al proprio branding. Per maggiori dettagli, consulta la nostra documentazione per gli sviluppatori.
Messenger API for Instagram è ora disponibile per gli account creator di Instagram con meno di 500 000 follower. Consulta la documentazione per gli sviluppatori per i dettagli.
https://ig.me/m/{ig_profile_handle}
su sito web, e-mail ecc. Consulta la documentazione per gli sviluppatori per i dettagli.Miglioramenti al protocollo di consegna
API Custom Labels: stiamo apportando dei miglioramenti importanti all'API Custom Labels che consentirebbero alle aziende di creare, aggiornare ed eliminare etichette e sincronizzarle tra la posta della Pagina Facebook e qualsiasi altro strumento che l'azienda potrebbe utilizzare per comunicare con i propri clienti.
v12.0
+ il campo name
dell'API Custom Labels verrà sostituito con page_label_name
. Questa modifica entrerà in vigore per tutte le versioni dell'API Graph precedenti a partire dal 14 dicembre 2021. Lo sviluppatore deve sfruttare page_label_name
attraverso vari webhook e chiamate API CRUD (Create, Retrieve, Update, Delete).Aggiornamenti a Messenger API per Europa e Giappone: abbiamo ripristinato il modello per il feedback dei clienti in Messenger API che non era disponibile per le aziende in Europa e per le persone in Europa e Giappone che si connettono con aziende a livello globale. Dettagli qui.
Aggiornamenti a Messenger API for Instagram:
Webhook reazione: abbiamo aggiornato le reazioni con emoji per restituire un nuovo formato unicode e supportare più reazioni con emoji. Consulta la documentazione per gli sviluppatori ed esegui la migrazione alla nuova versione prima del 14 dicembre 2021 affinché le reazioni con emoji continuino a essere supportate.
API User Profile: abbiamo aggiornato l'API User Profile per includere campi aggiuntivi disponibili pubblicamente sull'app Instagram. Consulta la documentazione per gli sviluppatori per i dettagli.
Obsolescenza di IGID: l'API Conversation non restituirà più il campo IGID
e si affiderà completamente al campo IGSID
. Consulta la documentazione per gli sviluppatori per i dettagli su come eseguire la migrazione prima del 14 dicembre 2021.
API Facebook Chat Plugin Customization: stiamo introducendo le impostazioni di personalizzazione del plug-in per la chat tramite API. Grazie a questa nuova versione, gli sviluppatori potranno modificare le funzioni tra cui la posizione, il colore, i saluti, le impostazioni della modalità ospite ecc. che al momento sono disponibili solo utilizzando i nostri strumenti proprietari.
Il webhook Message Echo ora includerà l'ID app per la posta della Pagina Facebook come parte dell'API Graph v12.0
: quando un'azienda risponde a una conversazione di Messenger dalla posta della Pagina Facebook, altre app collegate alla Pagina possono ascoltare il webhook Message Echo. Queste app riceveranno un webhook echo con l'ID app della posta della Pagina Facebook (263902037430900
).
Le modifiche seguenti si applicano a partire dalla versione v11.0
Aggiunta di <mid>
agli eventi messaging_postback
per Messenger e Messenger API for Instagram per l'API Graph v11.0 e successive: stiamo provvedendo ad aggiungere il campo ID messaggio (<mid>
) come parte del payload messaging_postback
per contribuire a ridurre il sovraccarico in termini di progettazione per i nostri partner che hanno fatto ricorso all'API Conversations per recuperare la cronologia delle conversazioni e confrontarla con gli eventi del webhook. Scopri maggiori dettagli qui.
I modelli per le compagnie aeree sono stati dichiarati obsoleti: i modelli per le compagnie aeree non saranno più supportati a partire dall'API Graph v11. L'obsolescenza per le versioni precedenti dell'API Graph avverrà 6 mesi dopo l'annuncio di questa modifica il 6 dicembre 2021. Consigliamo alle compagnie aeree di inviare i modelli di Carta di imbarco e Check-in come immagini, in maniera coerente con la modalità con cui di solito inviano queste notifiche su altri canali.
Messenger API for Instagram: abbiamo reso disponibile Messenger API for Instagram a tutti gli sviluppatori che stanno lavorando per consentire ai brand di offrire esperienze di messaggistica su Instagram su larga scala. Ora, gli sviluppatori possono aggiungere alle proprie app i messaggi di Instagram e creare esperienze per questi ultimi. Gli sviluppatori possono aiutare le aziende a utilizzare diverse app per sfruttare i flussi di lavoro esistenti, avere conversazioni più significative, aumentare la soddisfazione dei clienti e incrementare le vendite. Scopri di più qui. L'utilizzo dell'API Messenger per Instagram deve essere conforme alle Normative per gli sviluppatori, in particolare alle normative elencate in "API Messenger e Messaggi di Instagram", e alla documentazione tecnica.
Tag del messaggio Human Agent ora disponibile per tutti gli sviluppatori. Questo tag consente alle aziende di rispondere ai messaggi degli utenti su Messenger e Instagram, manualmente, al di fuori della finestra dei messaggi standard di 24 ore, per un periodo fino a 7 giorni. Questo tag è particolarmente utile per i casi d'uso come le chiusure nel fine settimana o le richieste che richiedono più di 24 ore. Gli sviluppatori devono richiedere l'autorizzazione per il tag Human Agent tramite la Dashboard gestione app, anche nel caso in cui l'app sia stata approvata in precedenza per il tag del messaggio Human Agent. Accedi alla sezione "Permessi e funzioni" della Dashboard gestione app e richiedi l'autorizzazione "Human Agent". Scopri di più qui.
Il Modello di feedback per i clientiè ora disponibile in versione beta. Stiamo lanciando un modello nativo in Messenger che supporta i formati di indagine comuni come CSAT (Customer Satisfaction), NPS (Net Promoter Score), CES (Customer Effort Score) e il testo in formato libero. Il modello nativo è più facile da integrare perché è basato sull'API Send, elimina la necessità di creare soluzioni di indagine personalizzate utilizzando Webview e semplifica agli sviluppatori l'aggregazione dei punteggi su canali che utilizzano formati di indagine simili. Scopri di più qui.