Con l'API One-Time Notification (beta) della Piattaforma Messenger, le pagine possono richiedere agli utenti di inviare un messaggio di follow-up allo scadere di una finestra dei messaggi di 24 ore. L'utente avrà la possibilità di decidere se ricevere una notifica futura. Se l'utente sceglie di ricevere la notifica, la pagina riceve un token che equivale a un'autorizzazione a inviare un singolo messaggio a quell'utente. Il token può essere usato una sola volta e ha una validità di 1 anno dalla creazione.
Le pagine interessate a utilizzare questa API devono richiedere l'autorizzazione "Notifica una tantum" nella sezione "Messaggistica avanzata" in Impostazioni della pagina. La pagina dovrà quindi accettare i termini della versione beta e, qualora soddisfi i nostri criteri, riceverà l'autorizzazione.
Usando l'API Send, le pagine possono inviare un messaggio contenente la richiesta di notifica come modello. Il tipo di modello deve essere one_time_notif_req
. Il corpo della richiesta segue un formato standard per tutti i tipi di modello, con la proprietà message.attachment.payload
contenente il tipo e i dettagli del contenuto, specifici per ogni tipo di modello. Puoi personalizzare solo il titolo e il payload della richiesta. Il campo name
prevede un limite di 65 caratteri.
{
"recipient": {
"id":"
Verrà mostrato il modello di messaggio contenente la richiesta di notifica una tantum e quando l'utente avrà cliccato sul pulsante "Avvisami", invieremo un webhook message_optins
al tuo back-end. A quel punto potrai usare il one_time_notif_token
per inviare un messaggio di follow-up una tantum all'utente al di fuori della finestra di 24 ore.
Per inviare un messaggio di follow-up, invia una richiesta POST
all'API Send, con il one_time_notif_token
ottenuto tramite il webhook e message.text
impostato nel corpo della richiesta:
curl -X POST -H "Content-Type: application/json" -d '{
"recipient": {
"one_time_notif_token":"<ONE_TIME_TOKEN>"
},
"message": {
"text":"<MESSAGE_CONTENT>"
}
}' "https://graph.facebook.com/v21.0
/me/messages?access_token=<PAGE_ACCESS_TOKEN>"
Per inviare un messaggio RTF, sostituisci il testo con contenuto formattato. Consulta il riferimento per l'API Send per la lista completa dei tipi di messaggio supportati. Il one_time_notif_token
può essere usato solo una volta e sarà reso non valido in seguito all'invio del messaggio.
Quando l'utente acconsente a essere informato di uno specifico aggiornamento, riceverai un evento webhook con payload
e one_time_notif_token
. Dovrai memorizzare sia il payload sia il token per poter inviare un messaggio di follow-up quando le informazioni saranno disponibili. Tieni presente che non sarà un'API separata a interrogare una lista di one_time_notif_token
, quindi è importante che elabori e memorizzi le informazioni del webhook che riceverai. Ogni token può essere usato una sola volta e ha una durata di un anno dalla data di creazione.
{ "sender": { "id":"<PSID>" }, "recipient": { "id":"<PAGE_ID>" }, "timestamp":1458692752478, "optin": { "type": "one_time_notif_req", "payload": "<USER_DEFINED_PAYLOAD>", "one_time_notif_token":"<ONE_TIME_TOKEN>", } }
Puoi trovare ulteriori informazioni sulla nostra pagina delle FAQ.