Panoramica della Piattaforma Messenger |
La panoramica della Piattaforma Messenger ne descrive il funzionamento e la procedura da seguire per una corretta implementazione.
Messenger from Meta è un servizio di messaggistica che consente alla Pagina Facebook aziendale o all'account Instagram per professionisti di rispondere alle persone interessate alla tua azienda o ai tuoi social media. Le conversazioni tra una persona e il tuo account devono essere avviate dalla persona.
La Piattaforma Messenger è gratuita per te.
Una persona invia un messaggio alla tua Pagina aziendale o al tuo account Instagram per professionisti con accesso effettuato a Facebook o Instagram, oppure tramite un plug-in di Meta mentre visita la tua app mobile o il tuo sito web. La tua Pagina aziendale o il tuo account Instagram per professionisti può usare la Piattaforma Messenger per gestire il messaggio ricevuto, inviando una risposta automatica, facendo rispondere un operatore o tramite una combinazione di automazione e operatore.
Quando una persona invia un messaggio alla tua Pagina aziendale o al tuo account Instagram per professionisti, viene attivato un webhook che ti invia una notifica che la tua Pagina aziendale o il tuo account Instagram per professionisti ha ricevuto un messaggio. La tua app può quindi chiamare il social graph di Meta per ricevere questa conversazione, determinare la risposta appropriata e inviarla alla persona entro 24 ore. La piattaforma ti permette di eseguire questa operazione su vasta scala e fornisce un'ampia varietà di punti di accesso per conversazione e tipi di messaggi.
Per implementare correttamente la Piattaforma Messenger, devi comprendere i seguenti componenti.
Un token d'accesso è una stringa opaca che identifica un'app, una Pagina Facebook o una persona e può essere usata da un'app per chiamare in modo sicuro il social graph di Meta. Un token d'accesso offre accesso temporaneo e sicuro a specifici endpoint che consentono a una Pagina aziendale o a un account Instagram per professionisti di scambiare messaggi con le persone. Ulteriori informazioni qui.
Esistono due livelli di accesso per le app per le Pagine aziendali o gli account Instagram per professionisti: accesso standard e accesso avanzato. L'accesso standard è il livello di accesso predefinito quando registri la tua app con Meta. L'accesso standard ti consente di ottenere dati per le persone che hanno un ruolo nella tua app, come uno sviluppatore, un tester o un amministratore, o un ruolo su una Pagina aziendale o un account Instagram per professionisti che ha reclamato l'app. L'accesso avanzato consente alla tua app di ottenere dati per le persone che la utilizzano ma non hanno un ruolo al suo interno oppure all'interno della Pagina aziendale o dell'account Instagram per professionisti che ha reclamato l'app. Scopri di più sui ruoli dell'app , sui tipi di app e sull' accesso standard e avanzato .
A causa delle limitazioni dell'accesso standard, alcune funzioni potrebbero comportarsi in modo non corretto finché alla tua app non viene concesso l'accesso avanzato. Questo potrebbe rappresentare un limite per le app test.
Devi completare l'analisi dell'app se la tua app avrà bisogno dell'accesso avanzato per ottenere dati su o per gli utenti dell'app che non hanno un ruolo al suo interno oppure all'interno di una Pagina aziendale o un account Instagram per professionisti che ha reclamato l'app. Ulteriori informazioni 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.
Devi completare la verifica dell'azienda se la tua app verrà utilizzata da utenti dell'app che non hanno un ruolo al suo interno o in un Business Manager che ha reclamato l'app. Ulteriori informazioni qui.
La Piattaforma Messenger sfrutta gli URL CDN (Content Delivery Network), che ti consentono di recuperare contenuti rich media condivisi dagli utenti Instagram. L'URL CDN è conforme alla privacy e non restituirà il contenuto multimediale una volta eliminato o scaduto.
Perché la tua Pagina o il tuo account Instagram possa inviare un messaggio a una persona, è necessario ottenerne l'autorizzazione. Per richiedere queste autorizzazioni dovrai implementare Facebook Login. Ulteriori informazioni qui.
È necessaria una Pagina Facebook per inviare e ricevere messaggi usando la Piattaforma Messenger. Ulteriori informazioni qui.
Se disponi di più di un'app che gestisce i messaggi, ad esempio un'app gestisce le risposte automatiche e un'altra le escalation a un operatore, dovrai implementare il protocollo di consegna per passare la conversazione da un'app all'altra. Per rispondere a un messaggio, un'app deve controllare la conversazione; il protocollo di consegna consente alla tua app di richiedere il controllo da un'altra app quando deve rispondere a un messaggio, accettare il controllo da un'altra app e rilasciare il controllo della conversazione una volta che l'app ha inviato la risposta.
Se la tua Pagina o il tuo account Instagram per professionisti invia o riceve un alto volume di messaggi, la posta non potrà più mostrare o inviare nuovi messaggi fino a quando il volume dei messaggi non diminuisce.
Se una Pagina invia più di 40 messaggi al secondo oppure invia o riceve costantemente messaggi in un gran numero di conversazioni contemporaneamente, i nuovi messaggi non saranno visualizzati nella posta della Pagina e la Pagina non potrà inviare nuovi messaggi fino a quando il volume dei messaggi non diminuisce.
Se una Pagina raggiunge il limite di volume elevato, le chiamate API per ricevere tutte le conversazioni avranno esito negativo; tuttavia, puoi comunque chiamare una singola conversazione per ricevere nuovi messaggi per quella conversazione.
Se un account Instagram per professionisti invia e riceve più di 72 000 messaggi, i nuovi messaggi non saranno visualizzati nella posta di Instagram e il tuo account Instagram per professionisti non potrà inviare nuovi messaggi fino a quando il volume dei messaggi non diminuisce.
I banner sono visualizzati nella conversazione e indicano che il limite è stato raggiunto. Questi banner non saranno più visualizzati quando il volume dei messaggi diminuisce.
La consegna del tuo messaggio potrebbe subire ritardi La consegna del tuo messaggio potrebbe richiedere più tempo del solito perché [nome-tuo-account] sta ricevendo un elevato numero di messaggi.
Il tuo messaggio non è stato consegnato Il tuo messaggio non è stato consegnato perché [nome-tuo-account] sta ricevendo un elevato numero di messaggi. Riprova più tardi.
Per inviare e ricevere messaggi di Instagram, devi avere un account Instagram per professionisti. Questo consente alla tua app di accedere ai dati degli endpoint del social graph di Meta usando la Pagina Facebook collegata al tuo account. Ulteriori informazioni qui.
Quando una persona invia un messaggio a un account Instagram per professionisti, viene creato un ID assegnato a Instagram che rappresenta quella persona su quell'app. Questo ID è specifico per la persona e per l'account Instagram con cui sta interagendo. Questo consente a un account Instagram per professionisti di mappare le interazioni per la stessa persona su più app di messaggistica.
Dovrai registrarti come sviluppatore e registrare la tua app su Meta per effettuare chiamate al social graph di Meta. Ulteriori informazioni qui.
Quando una persona invia un messaggio a una Pagina Facebook, viene creato un ID della singola Pagina che rappresenta quella persona su quella Pagina. Questo ID è specifico per la persona e per la Pagina con cui sta interagendo. Questo consente a una Pagina di mappare le interazioni per la stessa persona su più app di messaggistica.
La persona che richiede il token d'accesso della Pagina deve poter eseguire l'attività MESSAGING
per inviare messaggi e l'attività MODERATE
per rispondere ai commenti sulla Pagina Facebook collegata alla tua app di messaggistica. Ulteriori informazioni qui.
Trova un partner con esperienza nella Piattaforma Messenger nella nostra directory dei partner di Meta .
La tua app dovrà richiedere le seguenti autorizzazioni tramite Facebook Login per le conversazioni su Messenger:
pages_show_list
pages_manage_metadata
pages_messaging
pages_read_engagement
business_management
Per accedere alla messaggistica di Instagram, devi anche chiedere:
instagram_basic
instagram_manage_messages
business_management
Quando richiedi l'autorizzazione per business_management
, specifica quanto segue nell'invio per l'analisi della tua app:
pages_messaging
e pages_show_list
.instagram_manage_messages
.Nella tua app, assicurati di informare l'amministratore della Pagina che deve fornire esplicitamente le autorizzazioni all'app per gestire le sue risorse business. Dovrai aggiungere l'autorizzazione business_management
durante il flusso Facebook Login for Business.
Per ottenere e mantenere l'accesso al social graph di Meta, devi rispettare le Normative della Piattaforma Messenger, le Condizioni e le Normative della Piattaforma Meta e i nostri Standard della community. Ulteriori informazioni qui.
Paesi diversi potrebbero avere requisiti diversi per i messaggi inviati da una Pagina aziendale o da un account Instagram per professionisti. Prendi familiarità con queste normative e con le altre normative della piattaforma che applichiamo.
Il rate limiting per la Piattaforma Messenger dipende dall'API usata e, in alcuni casi, dal contenuto del messaggio.
Le richieste fatte dalla tua app vengono conteggiate nel numero di chiamate che l'app può effettuare in un periodo continuo di 24 ore, calcolato nel modo seguente:
Calls within 24 hours = 200 * Number of Engaged Users
Il Number of Engaged Users (Numero di utenti con interazioni) è il numero di persone a cui l'azienda può inviare messaggi tramite Messenger.
Le richieste fatte dalla tua app vengono conteggiate nel numero di chiamate che l'app può effettuare per account Instagram per professionisti e per l'API usata.
API Conversations
API Send
API Private Replies
I webhook di Meta sono notifiche in tempo reale che ti consentono di ricevere informazioni sui messaggi inviati alla tua Pagina aziendale o all'account Instagram per professionisti senza dover effettuare chiamate al social graph di Meta, che potrebbero dare luogo a rate limiting. Dovrai configurare Webhooks per ricevere notifiche sui messaggi inviati alla tua Pagina aziendale o al tuo account Instagram per professionisti per evitare rate limiting.
Scopri di più sulla Piattaforma Messenger nei nostri video per gli sviluppatori . Questi video includono procedure dettagliate, best practice, eventi registrati e altro ancora.