Riferimento per gli eventi del webhook messaging_optins

Un evento del webhook di attivazione della messaggistica si attiva quando una persona accetta di ricevere messaggi di marketing o tocca un plug-in Invia a Messenger.

Quando si utilizza il plug-in Invia a Messenger, il parametro optin.ref è impostato dal campo data-ref sul plug-in "Invia a Messenger". Questo campo può essere usato dallo sviluppatore per associare un evento di clic sul plug-in a una callback.

Notifica webhook di iscrizione ai messaggi

La tua app riceverà una notifica webhook di iscrizione quando si verificano le seguenti condizioni:

  • Una persona effettua l'iscrizione ai messaggi.
  • Una persona rinnova l'iscrizione ai messaggi cliccando sul pulsante Continua a ricevere messaggi mostrato prima della scadenza del token per i messaggi di notifica.
  • Una persona modifica lo stato della propria iscrizione, interrompendo o riattivando la ricezione delle notifiche.
{
  "sender": {
    "id": "PSID",
  },
  "recipient": {
    "id": "PAGE-ID",
  },
  "timestamp": "TIMESTAMP",
  "optin": {
    "type": "notification_messages", 
    "payload": "ADDITIONAL-INFORMATION",
    "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN", 
    "notification_messages_frequency": "FREQUENCY",  
    "notification_messages_timezone": "TIMEZONE-ID",
    "token_expiry_timestamp": "TIMESTAMP",
    "user_token_status": "TOKEN-STATUS",  
    "notification_messages_status": "NOTIFICATION-STATUS",
    "title": "TITLE" 
    }
}

optin

ProprietàDescrizione

payload

stringa

Informazioni aggiuntive che si desidera includere nella notifica webhook.

title

stringa

Il titolo visualizzato nel modello.

notification_messages_token

stringa

Il token che rappresenta la persona che ha effettuato l'iscrizione, con l'argomento specifico e la frequenza dei messaggi, che serve per inviare messaggi di marketing.

notification_messages_frequency

enum { DAILY, WEEKLY, MONTHLY }

Il valore può essere uno dei seguenti:

  • DAILY: invio di 1 notifica al giorno (24 ore) per 6 mesi dalla data di iscrizione
  • WEEKLY: invio di 1 notifica a settimana per 9 mesi dalla data di iscrizione
  • MONTHLY : invio di 1 notifica al mese per 12 mesi dalla data di iscrizione

(Rimosso nell'API v16)

notification_messages_timezone

stringa

Il fuso orario della persona che riceve il messaggio.

notification_messages_status

enum { STOP NOTIFICATIONS, RESUME NOTIFICATIONS }
Questo campo è presente solo quando l'utente interrompe o riattiva i messaggi di marketing.

Il valore può essere uno dei seguenti:

  • STOP NOTIFICATIONS: l'utente ha cliccato su "Blocca questi messaggi".
  • RESUME NOTIFICATIONS: l'utente ha cliccato su "Riattiva questi messaggi".

token_expiry_timestamp

indicazione temporale unix

Data di scadenza del token del messaggio di notifica.

type

stringa

Il valore deve essere notification_messages.

user_token_status

enum { REFRESHED, NOT_REFRESHED }

Il valore può essere uno dei seguenti:

  • REFRESHED: viene impostato quando l'utente sceglie di effettuare nuovamente l'iscrizione per ricevere i messaggi di marketing dopo la scadenza del token.
  • NOT_REFRESHED: valore predefinito. Viene impostato quando l'utente sceglie di non effettuare nuovamente l'iscrizione per ricevere i messaggi di marketing dopo la scadenza del token.