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.

Come funziona

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.

Flusso di messaggi

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.

Limitazioni

  • Una persona che ha effettuato l'accesso a Facebook non può inviare un messaggio al tuo account Instagram per professionisti, mentre una persona che ha effettuato l'accesso a Instagram tramite la Piattaforma Messenger non può inviare un messaggio alla tua Pagina Facebook aziendale o alla Pagina del tuo account Instagram per professionisti.
  • La messaggistica di Instagram è disponibile per qualsiasi account di Instagram per professionisti per aziende e per creator.

Cosa ti serve

Per implementare correttamente la Piattaforma Messenger, devi comprendere i seguenti componenti.

Token d'accesso

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.

Accesso avanzato e accesso standard

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.

Analisi dell'app

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.

Verifica dell'azienda

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.

URL della rete di pubblicazione dei contenuti

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.

Facebook Login

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.

Pagina Facebook

È necessaria una Pagina Facebook per inviare e ricevere messaggi usando la Piattaforma Messenger. Ulteriori informazioni qui.

Funzioni

La funzione Human Agent consente alla tua app di avere un agente umano che risponde ai messaggi degli utenti con il tag human_agent entro 7 giorni dal messaggio dell'utente. L'utilizzo consentito per questa funzione è fornire l'assistenza di un agente umano nel caso in cui non fosse possibile risolvere il problema di un utente nella finestra dei messaggi standard. Tra gli esempi citiamo i casi in cui l'azienda è chiusa per il weekend o i problemi la cui risoluzione richiede più di 24 ore.

Protocollo di consegna

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.

Elevato volume di messaggi

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.

Per la messaggistica di Messenger

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.

Per la messaggistica di Instagram

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.

Account Instagram per professionisti

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.

ID assegnati a Instagram

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.

Registrazione su Meta

Dovrai registrarti come sviluppatore e registrare la tua app su Meta per effettuare chiamate al social graph di Meta. Ulteriori informazioni qui.

ID della singola Pagina

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.

Attività della Pagina

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.

Directory dei partner

Trova un partner con esperienza nella Piattaforma Messenger nella nostra directory dei partner di Meta .

Autorizzazioni

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

Richiesta dell'autorizzazione per business_management

Quando richiedi l'autorizzazione per business_management, specifica quanto segue nell'invio per l'analisi della tua app:

  1. L'autorizzazione viene richiesta come dipendenza per le autorizzazioni pages_messaging e pages_show_list.
  2. Per la messaggistica di Instagram, specifica che questa autorizzazione viene richiesta come dipendenza per l'autorizzazione instagram_manage_messages.
  3. Nello screencast per l'analisi dell'app, mostra chiaramente l'amministratore della Pagina che naviga nel flusso di Facebook Login, scegli le pagine o i gestori di Instagram e fornisci le autorizzazioni necessarie all'app.

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.

Normative

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.

Requisiti normativi per i bot

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.

Rate limiting

Il rate limiting per la Piattaforma Messenger dipende dall'API usata e, in alcuni casi, dal contenuto del messaggio.

API Messenger

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.

API Messenger per Instagram

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

  • L'app può effettuare 2 chiamate al secondo per account Instagram per professionisti.

API Send

  • L'app può effettuare 100 chiamate al secondo per account Instagram per professionisti per messaggi che contengono testo, link, reazioni e adesivi.
  • L'app può effettuare 10 chiamate al secondo per account Instagram per professionisti per messaggi che contengono contenuti audio o video.

API Private Replies

  • L'app può effettuare 100 chiamate al secondo per account Instagram per professionisti per risposte private a commenti Instagram Live.
  • L'app può effettuare 750 chiamate all'ora per account Instagram per professionisti per risposte private a commenti su post e reel di Instagram.

Webhook

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.

Passaggi successivi

  • Configura Webhooks - Scopri come ricevere notifiche HTTP in tempo reale per i messaggi inviati e ricevuti dalla tua app.

Scopri di più

Scopri di più sulla Piattaforma Messenger nei nostri video per gli sviluppatori . Questi video includono procedure dettagliate, best practice, eventi registrati e altro ancora.