FAQ

L'installazione di un'app si effettua dal sito web dell'app usando Facebook Login e concedendo l'autorizzazione pages_messaging a una Pagina specifica. Le app autorizzate sono visibili nelle Impostazioni della Pagina sotto Messaggi avanzati.

Sì, una singola app di Facebook può ricevere gli aggiornamenti di più Pagine. Una volta eseguita l'analisi dell'app, come l'autorizzazione pages_messaging, l'app può richiedere di ricevere Webhooks su più di una Pagina. Starà a te ottenere il contesto di ogni Webhook in base al payload.

Sì, è possibile sottoscrivere più di un'app a una Pagina. Quando più applicazioni gestiscono la stessa conversazione, consigliamo di usare il protocollo di consegna per stabilire a quale bot appartiene la serie di post in un determinato momento.

Per leggere le FAQ sul GDPR e sulla Piattaforma Messenger, consulta La Piattaforma Messenger e il Regolamento generale sulla protezione dei dati.

Quando usi il plug-in "Invia a Messenger", puoi usare il parametro data-ref come parametro pass-through per l'invio delle informazioni sul contesto del clic.

Gli utenti possono scoprire la tua Pagina anche attraverso la ricerca su Messenger. In questi casi, non avrai un parametro pass-through. Puoi usare la funzione di collegamento degli account per associare una conversazione a un account utente sul tuo sito.

Quando un'app è in modalità sviluppo, il plug-in è visibile solo agli amministratori, agli sviluppatori e ai tester dell'app stessa. Dopo l'analisi e l'approvazione dell'app, devi renderla disponibile per tutti nella tab Analisi dell'app della Dashboard gestione app.

No. Unlike subscriptions where a business can send multiple messages to people on a recurring basis, the one-time notification API limits the business to a single message per user request. If the person engages with the message, the standard messaging window will reopen.

Yes. Pages interested in using the One-time Notification API need to apply for permission. Go to the Advanced Messaging section of your Page Settings and consent to the terms. A Page will be granted permission if the Page meets our criteria.

Common uses of the API include various promotional and non-promotional use cases where the User explicitly requested a follow-up. Examples include:

• Back in stock alerts
• Collection launches
• Concert tickets going on sale
• Price drop alerts
• Train tickets available for purchase
• CSAT surveys

Your Page is not allowed to send a notification on a topic for which the User has not agreed to receive a notification. Please see the Usage and Restrictions and Limitations sections of the One-time Notification guide for more information.

A Page can send multiple requests however, the 24-hour policy will be applied to all the requests being sent. We also have controls in place to prevent spamming users with multiple requests.

The 24 hour standard messaging window will open only if the user interacts with the opt-in message. The behavior is consistent with interactions with other elements in the Messenger experience.

Pages will need to subscribe to message_optins webhook to receive notifications about User consent.

Once a person asks to be notified, the Page will receive a token which is equivalent to a permission to send a single message to the person. The token can be used to send a message to the person outside the 24 hour window. The token can only be used once and unused tokens will expire within 1 year of creation.

Yes. However, while it is possible to send another notification request using an existing token, there is no clear benefit for the business to send these type of requests.

Token is for one-time use only. Once a token is used it can not be used again.

No. The API does not return tokens available to a Page.

Page level. Permissions for the One-time Notification API are given at the Page level.

No. The app does not need to specify any message tags when sending a message outside the 24-hour standard messaging window using this API.

Questa situazione può verificarsi per diversi motivi:

• Stai usando un ID di Facebook Login. Gli ID di Facebook Login non sono compatibili con l'API Send/Receive. Solo gli ID utente ottenuti tramite autenticazione con la Piattaforma Messenger sono compatibili con tale piattaforma.
• Stai usando un ID con il token d'accesso per la Pagina errato. Gli ID utente per la Piattaforma Messenger sono assegnati a una singola Pagina e, di conseguenza, sono specifici per quest'ultima. Se usi un ID utente valido ma con un token d'accesso per la Pagina assegnato a un'altra Pagina, la chiamata non funziona. Assicurati di usare l'ID utente e il token d'accesso per la Pagina assegnati alla stessa Pagina.
• Stai inviando un messaggio a un numero di telefono non verificato di recente. Quando usi l'API Send con un numero di telefono, invieremo i messaggi solo se tale numero è stato verificato di recente. L'invio potrebbe non avere esito positivo anche se il numero di telefono risulta verificato, ma tale verifica non è avvenuta di recente. Verifica nuovamente il numero di telefono, attendi 24 ore e riprova.

Ecco una soluzione alternativa per usare un utente test della piattaforma per la tua integrazione con la Piattaforma Messenger:

1. Nella pagina Ruoli della tua app, crea un nuovo utente test cliccando sul pulsante Aggiungi.
2. Attiva l'opzione Vuoi autorizzare gli utenti test per questa app? e concedere le autorizzazioni "manage_pages" e "page_messaging".
3. Usa il pulsante Modifica e ottieni un token d'accesso per l'utente (tramite la versione 2.6). Conservalo per un uso successivo.
4. Usa il pulsante Modifica per effettuare l'accesso come utente test.
5. Dopo l'accesso, crea una Pagina come utente test.
6. Usa il token d'accesso per l'utente test per acquisire il token d'accesso per la Pagina di tale utente. A tale scopo, effettua la chiamata seguente:

   https://graph.facebook.com/v2.6/me/accounts?access_token=[TEST_USER_ACCESS_TOKEN]

   (Documentazione)
7. Usa il token d'accesso per la Pagina per collegare l'app Facebook alla tua Pagina:

   https://graph.facebook.com/v2.6/me/subscribed_apps?method=POST&access_token=[TEST_USER_PAGE_ACCESS_TOKEN]
           

   (Documentazione)
8. Topo aver seguito i passaggi, riceverai gli aggiornamenti in tempo reale nella Pagina test e potrai inviare messaggi al tuo utente test da tale Pagina. Oltre a quanto indicato in precedenza, puoi sostituire il token d'accesso con uno di lunga durata nel caso in cui il primo scada troppo velocemente rispetto ai test. Attieniti alla documentazione disponibile qui:

   GET /oauth/access_token?  
       grant_type=fb_exchange_token&           
       client_id={app-id}&
       client_secret={app-secret}&
       fb_exchange_token={short-lived-token} 
           

Sì, i bot possono includere entrambi i tipi di messaggi. Gli utenti dovranno attivare i messaggi della piattaforma standard tramite uno degli attivatori idonei e dovranno accettare di ricevere i messaggi in abbonamento.

Tecnicamente, i bot non sono in grado di inviare agli utenti più di un messaggio al di fuori delle 24 ore prestabilite (il messaggio non viene inviato). Durante il periodo di transizione per i bot esistenti, questi messaggi supereranno il blocco, ma verranno segnalati se individuati.

No, la Piattaforma Messenger non offre un'API che restituisca l'elenco dei PSID degli utenti che hanno accettato di ricevere messaggi dal tuo bot.

Per ricevere le callback, devi seguire 2 passaggi. In primo luogo, verifica la corretta configurazione del webhook (https://developers.facebook.com/docs/messenger-platform/webhook-reference#setup). Un indicatore ti comunica la corretta configurazione dei webhooks.

In secondo luogo, effettua l'iscrizione a ogni Pagina. La lista includerà tutte le Pagine a cui hai effettuato l'iscrizione.

Se le chiamate al tuo webhook hanno esito negativo per un periodo prolungato, l'iscrizione dell'app viene annullata e dovrai aggiungere nuovamente il webhook e ripetere l'iscrizione alla Pagina.

Le chiamate al webhook contengono un campo nell'intestazione denominato X-Hub-Signature, che puoi usare per convalidare la provenienza della chiamata da Facebook.

Assicurati che il webhook risponda con un codice di stato 200. Tale codice ci comunica che il webhook è stato ricevuto correttamente. Se non restituisci un codice 200, riproveremo a effettuare la chiamata finché non ha esito positivo. Inoltre, se un webhook non restituisce un codice 200 per un periodo prolungato, invieremo gli avvisi per gli sviluppatori.

Tieni presente anche che i codici di stato relativi a un'azione eseguita correttamente devono essere restituiti in modo tempestivo. Una chiamata al webhook va in timeout dopo 20 secondi. Assicurati di strutturare il codice affinché i webhooks vengano elaborati in modo asincrono, in questo modo è possibile restituire immediatamente un codice di stato relativo a un'azione eseguita correttamente, che viene elaborata a parte.

Esiste uno strumento che mostra gli errori recenti del webhook. Se i webhook non vengono consegnati, i server di Facebook annulleranno la sottoscrizione del tuo URL. Per individuare lo strumento, accedi alla Dashboard gestione app > Messenger, Impostazioni, nella scheda Webhooks troverai il pulsante Mostra errori recenti