Creazione
Crea e invia messaggi ai tuoi 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 sulla Pagina
L'autorizzazione pages_messaging
Il destinatario del messaggio deve aver inviato alla tua Pagina un messaggio nelle 24 ore precedenti o aver accettato di ricevere messaggi dalla tua Pagina al di fuori della finestra dei messaggi standard di 24 ore
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.
Formattato per una maggiore leggibilità.Il seguente esempio è una risposta inviata dalla tua Pagina al messaggio di una persona e contiene solo testo.
curl -X POST "https://graph.facebook.com/v21.0/{PAGE_ID}/messages" \
-d "recipient={'id':'{PSID}'}" \
-d "messaging_type=RESPONSE" \
-d "message={'text':'hello, world'}" \
-d "access_token={PAGE_ACCESS_TOKEN}"
Se l'azione viene eseguita correttamente, l'app riceve la seguente risposta JSON:
{
"recipient_id": "PAGE-SCOPED-ID",
"message_id": "AG5Hz2U..."
}
Parametri
| Parametro | Descrizione | message
oggetto | Il tipo di messaggio inviato dalla tua Pagina. Quando si utilizza questo parametro deve essere impostata una tra le opzioni text e attachement. |
messaging_type
enumObbligatorio | Il tipo di messaggio inviato. RESPONSE: il messaggio è inviato in risposta a un messaggio ricevuto. Sono compresi messaggi promozionali e non promozionali inviati all'interno della finestra dei messaggi standard di 24 ore. Per esempio, utilizza questo tag per rispondere se una persona chiede la conferma di una prenotazione o un aggiornamento dello stato. UPDATE: il messaggio viene inviato in modo proattivo e non in risposta a un messaggio ricevuto. Sono compresi messaggi promozionali e non promozionali inviati all'interno della finestra dei messaggi standard di 24 ore.
|
notification_type
enum | Il tipo di notifica push ricevuta da una persona. NO_PUSH: nessuna notifica.
REGULAR (predefinito): suono o vibrazione quando una persona riceve un messaggio.
SILENT_PUSH: solo notifica su schermo.
|
recipient
oggettoObbligatorio | La persona che riceverà il messaggio inviato dalla tua Pagina. id: l'ID per singola Pagina per la persona utilizzato per rispondere a un messaggio ricevuto dalla tua Pagina entro 24 ore o per una persona che ha accettato di ricevere messaggi dalla tua Pagina al di fuori della finestra dei messaggi standard di 24 ore.
user_ref: il riferimento per la persona utilizzato per inviare un messaggio in risposta a un plug-in della casella di spunta o per la chat.
comment_id: l'ID per il commento utilizzato per inviare un messaggio come risposta privata al commento di un ospite su un post della tua Pagina.
post_id: l'ID per il post della Pagina utilizzato per inviare un messaggio come risposta privata al post di un ospite sulla tua Pagina.
|
sender_action
enum | L'icona di azione mostrata nella finestra dei messaggi che rappresenta l'azione della Pagina su un messaggio ricevuto da una persona. typing_on: visualizza il fumetto di digitazione mentre la Pagina sta scrivendo una risposta.
typing_off: non visualizza il fumetto di digitazione.
mark_seen: visualizza l'icona di visualizzato 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, deve essere inviato come richiesta separata. |
tag
enum | Un tag che abilita la tua Pagina all'invio di un messaggio a una persona al di fuori della finestra dei messaggi standard di 24 ore. ACCOUNT_UPDATE: tagga il messaggio che invii al cliente come aggiornamento non ricorrente dell'app o dell'account di quel cliente. Visualizza gli usi consentiti. Non disponibile per l'API per i messaggi di Instagram. CONFIRMED_EVENT_UPDATE: tagga il messaggio che invii al cliente come promemoria di un evento in programma o un aggiornamento per un evento in corso per cui il cliente si è registrato. Visualizza gli usi consentiti.Non disponibile per l'API per i messaggi di Instagram. HUMAN_AGENT: obbligatorio per l'API per i messaggi di Instagram. L'aggiunta di questo tag a un messaggio destinato a una persona consente a un operatore reale di rispondere. I messaggi possono essere inviati entro 7 giorni dal messaggio di quella persona. Il supporto con operatore reale viene utilizzato per la risoluzione di problemi che non possono essere risolti entro la finestra dei messaggi standard. Visualizza gli usi consentiti.L'autorizzazione Human Agent non è disponibile in accesso standard o in modalità sviluppatore. Dovrai completare il processo di analisi dell'app prima di poter sfruttare il tag Human Agent. Durante l'invio per l'analisi dell'app, fornisci istruzioni chiare e una dimostrazione su come intendi sfruttare il tag Human Agent nelle tue esperienze. POST_PURCHASE_UPDATE: tagga il messaggio che invii al cliente come aggiornamento per un acquisto recente effettuato dal cliente. Visualizza gli usi consentiti.Non disponibile per l'API per i messaggi di Instagram.
|
Utilizzo dei tag dei messaggi
La tabella seguente elenca i tipi di messaggi per ogni tag.
| Tag nel messaggio | Utilizzo | ACCOUNT_UPDATE
| Utilizzi consentitiNotifica di un cambiamento di stato per un'app, ad esempio per una carta di credito o una candidatura a un lavoro. Notifica di attività sospette, come avvisi di frode.
Utilizzi 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 questionari, sondaggi o recensioni non correlati a una precedente interazione in Messenger
Non disponibile per l'API per i messaggi di Instagram. |
CONFIRMED_EVENT_UPDATE
| Utilizzi consentitiPromemoria per una lezione, un appuntamento o un evento in programma che un utente ha pianificato. Conferma della prenotazione o della partecipazione dell'utente a un evento o a un appuntamento accettato. Notifica del trasporto o del viaggio programmato da un utente, come arrivo, cancellazione, ritardo del bagaglio o altri cambiamenti di stato.
Utilizzi non consentiti (non è un elenco completo)Contenuti promozionali, inclusi ma non limitati a promozioni, offerte, coupon e sconti. Contenuti relativi a un evento a cui l'utente non si è registrato (ad es. promemoria per l'acquisto di biglietti per eventi, cross-selling di altri eventi, programmi di tour, ecc.). Messaggi relativi ad eventi passati. Richieste di questionari, sondaggi o recensioni non correlati a una precedente interazione in Messenger
Non disponibile per l'API per i messaggi di Instagram. |
CUSTOMER_FEEDBACK
| Utilizzi consentitiUtilizzi non consentiti (non è un elenco completo)Non disponibile per l'API per i messaggi di Instagram. |
HUMAN_AGENT
| Utilizzi consentitiUtilizzi non consentiti (non è un elenco completo)Obbligatorio per l'API per i messaggi di Instagram. |
POST_PURCHASE_UPDATE
| Utilizzi consentitiConferma della transazione, come fatture o ricevute. Aggiornato di stato della spedizione, come prodotto in transito, spedito, consegnato o in ritardo. Aggiornamento di stato che richiede a un utente di eseguire una determinata azione in relazione a un ordine effettuato, come ad esempio carta di credito rifiutata, articoli in riassortimento o altri aggiornamenti dell'ordine che richiedono un'azione da parte dell'utente.
Utilizzi non consentiti (non è un elenco completo)Contenuti promozionali, compresi, a titolo esemplificativo, offerte, promozioni, coupon e sconti. Messaggi di cross-selling o up-selling di prodotti o servizi. Richieste di questionari, sondaggi o recensioni non correlati a una precedente interazione in Messenger
Non disponibile per l'API per i messaggi di Instagram. |
