Piattaforma Messenger

Risposte rapide

Le risposte rapide consentono di presentare fino a 13 pulsanti all'interno della conversazione, con un titolo e un'immagine facoltativi, che vengono visualizzati in primo piano sopra lo strumento di composizione. Puoi anche utilizzare le risposte rapide per richiedere il luogo, l'indirizzo e-mail e il numero di telefono di una persona.


Quando viene toccata una risposta rapida, i pulsanti vengono ignorati e il titolo del pulsante toccato viene inviato nella conversazione come messaggio. Al tuo webhook verrà inviato un evento messages contenente il titolo del pulsante e un payload facoltativo.

Per una lista completa delle proprietà della richiesta, consulta il riferimento per le risposte rapide.

Invio di risposte rapide

Per inviare una risposta rapida, aggiungi l'array quick_replies al messaggio di testo e includi oggetti che definiscano fino a 13 pulsanti di risposta rapida.

Sono supportati i seguenti tipi di risposte rapide:

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<PSID>"
  },
  "messaging_type": "RESPONSE",
  "message":{
    "text": "Pick a color:",
    "quick_replies":[
      {
        "content_type":"text",
        "title":"Red",
        "payload":"<POSTBACK_PAYLOAD>",
        "image_url":"http://example.com/img/red.png"
      },{
        "content_type":"text",
        "title":"Green",
        "payload":"<POSTBACK_PAYLOAD>",
        "image_url":"http://example.com/img/green.png"
      }
    ]
  }
}' "https://graph.facebook.com/v21.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

Risposta rapida di testo

Puoi anche inviare le risposte rapide di testo con un'immagine facoltativa, visualizzata sotto forma di icona accanto al titolo. Se il content_type per una risposta rapida viene specificato come text, è necessario specificare un title non vuoto.

Sintassi

Per una lista completa delle proprietà della richiesta, consulta il riferimento per le risposte rapide.

{
  "content_type":"text",
  "title":"<BUTTON_TEXT>",
  "image_url":"http://example.com/img/red.png",
  "payload":"<DEVELOPER_DEFINED_PAYLOAD>"
}

Evento del webhook

Quando viene toccata una risposta rapida, viene inviato un messaggio di testo alla callback per i messaggi ricevuti del tuo webhook.

La proprietà text dell'evento corrisponde al titolo della risposta rapida. L'oggetto del messaggio contiene anche un campo denominato quick_reply, contenente i dati di payload sulla risposta rapida.

{
  "object": "page",
  "entry": [
    {
      "id": "<PAGE_ID>",
      "time": 1502905976963,
      "messaging": [
        {
          "sender": {
            "id": "1254459154682919"
          },
          "recipient": {
            "id": "682498171943165"
          },
          "timestamp": 1502905976377,
          "message": {
            "quick_reply": {
              "payload": "DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_GREEN"
            },
            "mid": "m_AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P",
            "text": "Green"
          }
        }
      ]
    }
  ]
}

Risposta rapida con numero di telefono dell'utente

La risposta rapida con numero di telefono dell'utente consente di richiedere il numero di telefono dell'utente. Dopo l'invio della risposta rapida con numero di telefono, la Piattaforma Messenger precompila automaticamente la risposta rapida visualizzata con il numero di telefono ricavato dalle informazioni del profilo dell'utente.

Se il profilo dell'utente non presenta un numero di telefono, la risposta rapida non verrà mostrata.

Il bot non riceverà il numero di telefono finché l'utente non clicca sulla risposta rapida.

La scelta della risposta rapida fa in modo che le informazioni vengano trasmesse una volta e non rappresenta un'autorizzazione per accedere alle informazioni in futuro.

Sintassi

{
  "content_type":"user_phone_number"
}

Evento del webhook

Quando l'utente tocca la risposta rapida, il numero di telefono viene passato all'attributo payload dell'evento del webhook messages.

{
  "object": "page",
  "entry": [
    {
      "id": "

Risposta rapida con e-mail dell'utente

La risposta rapida con e-mail dell'utente consente di richiedere l'e-mail dell'utente. Dopo l'invio della risposta rapida con e-mail, la Piattaforma Messenger precompila automaticamente la risposta rapida visualizzata con l'indirizzo e-mail ricavato dalle informazioni del profilo dell'utente.

Se il profilo dell'utente non presenta un indirizzo e-mail, la risposta rapida non verrà mostrata.

Il bot non riceverà l'indirizzo e-mail finché l'utente non clicca sulla risposta rapida.

La scelta della risposta rapida fa in modo che le informazioni vengano trasmesse una volta e non rappresenta un'autorizzazione per accedere alle informazioni in futuro.

Sintassi

{
  "content_type":"user_email"
}

Evento del webhook

Quando l'utente tocca la risposta rapida, l'indirizzo e-mail viene passato all'attributo payload dell'evento del webhook messages.

{
  "object": "page",
  "entry": [
    {
      "id": "

Best practice

Usa le risposte rapide per la scelta dei passaggi successivi specifici.

Mantieni brevi le risposte rapide, altrimenti verranno troncate.

Non usarle per le azioni che devono essere permanenti, dal momento che le risposte rapide non sono più visibili dopo il messaggio successivo.

Assistenza per gli sviluppatori