One-time Notification (beta)

Riepilogo

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.

Autorizzazioni

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.

Indice

• Utilizzo
• Invio della richiesta di notifica una tantum
• Invio del messaggio di follow-up
• Eventi del webhook
• Restrizioni e limitazioni

Utilizzo

• Non confondere, ingannare, truffare, fuorviare, inviare spam o raggirare nessuno. Assicurati che ci sia una relazione chiara ed evidente tra la notifica e il contenuto del messaggio. Il contenuto della richiesta di notifica una tantum e del messaggio deve essere conforme agli standard della community.
• Le pagine che ricevono volumi elevati di feedback negativi da parte degli utenti o che confondono, ingannano, truffano, fuorviano o raggirano gli utenti perderanno l'accesso all'API.

Invio della richiesta di notifica una tantum

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.

Invio del messaggio di follow-up

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/v19.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.

Eventi del webhook

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>",
   }
}

Restrizioni e limitazioni

• Non usare il campo del payload per inviare password, credenziali utente, informazioni di identificazione personale degli utenti (ovvero informazioni quali nome o indirizzo e-mail utilizzabili per contattare o identificare la persona) o altre informazioni sensibili (come dati di carattere sanitario, finanziario, di pagamento o relativi al titolare di una carta oppure altre categorie di informazioni definite come sensibili ai sensi della legge applicabile).
• Il numero di richieste di notifica una tantum è soggetto a rate limiting allo scopo di prevenire un'esperienza utente negativa.

FAQ

Puoi trovare ulteriori informazioni sulla nostra pagina delle FAQ.