Creazione
Crea e invia messaggi ai clienti o alle persone interessate alla tua Pagina Facebook.
Prima di iniziare
Ecco cosa ti servirà:
Un token d'accesso della Pagina richiesto da una persona che può eseguire l'attività MESSAGE
nella Pagina
L'autorizzazione pages_messaging
Il destinatario del messaggio deve aver inviato alla Pagina un messaggio nelle ultime 24 ore o aver accettato di ricevere messaggi dalla Pagina al di fuori della finestra di 24 ore dei messaggi standard.
Limitazioni
Tieni presente che l'API Send non include il parametro recipient_id
nella risposta per i messaggi inviati usando recipient.user_ref
o recipient.phone_number
per identificare il destinatario del messaggio.
Esempio di richiesta
Per inviare un messaggio a una persona, invia una richiesta POST
all'endpoint /PAGE-ID/messsages
con i parametri messaging_type
e recipient
impostati e il contenuto del messaggio.
Formattazione per le leggibilità.Il seguente esempio è una risposta al messaggio di una persona in cui il messaggio inviato dalla tua Pagina è solo testuale.
curl -i -X POST "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages
?recipient={'id':'PSID'}
&messaging_type=RESPONSE
&message={'text':'hello,world'}
&access_token=PAGE-ACCESS-TOKEN
Se l'azione viene eseguita correttamente, la tua app riceverà la seguente risposta JSON:
{
"recipient_id": "PAGE-SCOPED-ID",
"message_id": "AG5Hz2U..."
}
Parametri
Parameter | Description | message object | Il tipo di messaggio che la tua Pagina sta inviando. Quando si usa questo parametro, è necessario impostare text o attachement . |
messaging_type enumCampo obbligatorio | Il tipo di messaggio inviato RESPONSE : messaggi di risposta a un messaggio ricevuto. Ciò comprende messaggi promozionali e non inviati all'interno della finestra di 24 ore dei messaggi standard. Ad esempio, usa questo tag per rispondere se un utente richiede la conferma di una prenotazione o un aggiornamento di stato.
|
notification_type enum | Tipo di notifica push che una persona riceverà NO_PUSH : nessuna notifica
REGULAR (predefinita): suono o vibrazione quando un messaggio è ricevuto da una persona
SILENT_PUSH : solo notifica sullo schermo
|
recipient objectCampo obbligatorio | La persona che riceverà il messaggio inviato dalla tua Pagina id : l'ID della singola Pagina per la persona solita a inviare un messaggio in risposta a un messaggio ricevuto dalla tua Pagina entro le ultime 24 ore o per una persona che ha accettato di ricevere messaggi dalla tua Pagina al di fuori della finestra di 24 ore dei messaggi standard
user_ref : il riferimento per la persona usato per inviare un messaggio in risposta a una casella o a un plug-in per la chat con i clienti
comment_id : l'ID del commento usato per inviare un messaggio come risposta privata in risposta al commento di un visitatore nel tuo post della Pagina
post_id : l'ID del post della Pagina usato per inviare un messaggio come risposta privata in risposta al post di un visitatore sulla tua Pagina
|
sender_action enum | L'icona dell'azione visualizzata nella finestra dei messaggi che rappresenta l'azione intrapresa dalla Pagina su un messaggio che la Pagina ha ricevuto da una persona. typing_on : mostra il fumetto di digitazione quando la Pagina sta preparando una risposta
typing_off : non mostra il fumetto di digitazione
mark_seen : mostra l'icona di visualizzazione per i messaggi che sono stati visualizzati dalla Pagina
Può essere inviato solo con il parametro recipient . Non può essere inviato con il parametro message , ma deve essere inviato come richiesta separata. |
tag enum | Un tag che consente alla Pagina di inviare un messaggio a una persona al di fuori della finestra di 24 ore dei messaggi standard. ACCOUNT_UPDATE : tagga il messaggio che stai inviando al cliente come aggiornamento non ricorrente della relativa applicazione o del relativo account. Vedi gli usi consentiti. Non disponibile per l'API dei messaggi di Instagram. CONFIRMED_EVENT_UPDATE : tagga il messaggio che stai inviando al tuo cliente come un promemoria di un evento in programma o un aggiornamento di un evento in corso al quale il cliente si è registrato. Vedi gli usi consentiti. Non disponibile per l'API dei messaggi di Instagram. HUMAN_AGENT : necessario per l'API dei messaggi di Instagram. Quando questo tag viene aggiunto a un messaggio inviato a una persona, consente a un agente umano di rispondere al messaggio della persona. I messaggi possono essere inviati entro 7 giorni dal messaggio della persona. Il supporto dell'agente umano riguarda i problemi che non possono essere risolti entro la finestra di messaggi standard. Vedi gli usi consentiti. L'autorizzazione Human Agent non è disponibile nell'accesso standard o nella modalità sviluppo. Dovrai completare il processo di analisi dell'app prima di poter sfruttare il tag dell'agente umano. Durante l'invio dell'analisi dell'app, fornisci istruzioni chiare e una dimostrazione di come intendi sfruttare il tag dell'agente umano nelle tue esperienze. POST_PURCHASE_UPDATE : tagga il messaggio che stai inviando al cliente come aggiornamento di un recente acquisto effettuato dal cliente. Vedi gli usi consentiti. Non disponibile per l'API dei messaggi di Instagram.
|
Usi dei tag nei messaggi
La seguente tabella elenca i tipi di messaggi per ogni tag del messaggio.
Tag del messaggio | Uso | ACCOUNT_UPDATE
| Utilizzi consentitiUna notifica per una variazione dello stato di un'applicazione, ad esempio in relazione a una carta di credito o a un'offerta di lavoro di lavoro Una notifica di attività sospetta, ad esempio avvisi di frode
Usi non consentiti (non è un elenco completo)Contenuto promozionale, tra cui il contenuto ricorrente di offerte, promozioni, coupon e sconti (ad esempio, l'estratto conto è pronto, la bolletta è in scadenza, nuove offerte di lavoro) Richieste di sondaggi, questionari o interviste non correlate a una precedente interazione su Messenger
Non disponibile per l'API dei messaggi di Instagram. |
CONFIRMED_EVENT_UPDATE
| Utilizzi consentitiIl promemoria per una lezione, un appuntamento o un evento in programma che l'utente ha programmato La conferma di una prenotazione dell'utente o la partecipazione a un evento o appuntamento accettato La notifica relativa a un trasporto o viaggio programmato dell'utente, ad esempio arrivo, annullamento, ritardo dei bagagli o altri cambiamenti dello stato del viaggio
Usi non consentiti (non è un elenco completo)Contenuto promozionale, tra cui, offerte, coupon e sconti Contenuto correlato a un evento a cui l'utente non si è iscritto (ad esempio, promemoria per acquistare i biglietti dell'evento, cross-selling di altri eventi, programmi dei tour ecc.) Messaggi correlati a eventi passati Richieste di sondaggi, questionari o interviste non correlate a una precedente interazione su Messenger
Non disponibile per l'API dei messaggi di Instagram. |
CUSTOMER_FEEDBACK
| Utilizzi consentitiUsi non consentiti (non è un elenco completo)Non disponibile per l'API dei messaggi di Instagram. |
HUMAN_AGENT
| Utilizzi consentitiUsi non consentiti (non è un elenco completo)Necessario per l'API dei messaggi di Instagram. |
POST_PURCHASE_UPDATE
| Utilizzi consentitiLa conferma di una transazione, ad esempio fatture o ricevute L'aggiornamento di stato di una spedizione, ad esempio in caso di prodotto in transito, spedito, consegnato o in ritardo Un aggiornamento di stato che richiede all'utente di eseguire un'azione in relazione a un ordine da lui inviato, ad esempio una carta di credito rifiutata, articoli arretrati o altri aggiornamenti dell'ordine che richiedono un'azione dell'utente
Usi non consentiti (non è un elenco completo)Contenuto promozionale, tra cui offerte, promozioni, coupon e sconti Messaggi per cross-selling o up-selling di prodotti o servizi Richieste di sondaggi, questionari o interviste non correlate a una precedente interazione su Messenger
Non disponibile per l'API dei messaggi di Instagram. |