Risposte veloci

Le risposte veloci sono un nuovo modo per mostrare i pulsanti all'utente. Sono messe in evidenza al di sopra del composer, con la tastiera in una posizione meno evidente. Quando l'utente tocca una risposta veloce, il messaggio viene inviato nella conversazione con i metadati definiti dallo sviluppatore nella callback. Inoltre, i pulsanti vengono nascosti per evitare che gli utenti tocchino quelli allegati a messaggi precedenti in una conversazione.

Le risposte veloci contengono testo. Se lo desideri, puoi aggiungere un'immagine.

Puoi anche usare le risposte veloci per chiedere la posizione di un utente.

Esempio

Solo testo

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"USER_ID"
  },
  "message":{
    "text":"Pick a color:",
    "quick_replies":[
      {
        "content_type":"text",
        "title":"Red",
        "payload":"DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_RED"
      },
      {
        "content_type":"text",
        "title":"Green",
        "payload":"DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_GREEN"
      }
    ]
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=PAGE_ACCESS_TOKEN"    

Testo e immagine

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"USER_ID"
  },
  "message":{
    "text":"Pick a color:",
    "quick_replies":[
      {
        "content_type":"text",
        "title":"Red",
        "payload":"DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_RED",
        "image_url":"http://petersfantastichats.com/img/red.png"
      },
      {
        "content_type":"text",
        "title":"Green",
        "payload":"DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_GREEN",
        "image_url":"http://petersfantastichats.com/img/green.png"
      }
    ]
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=PAGE_ACCESS_TOKEN"    

Luogo

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"USER_ID"
  },
  "message":{
    "text":"Please share your location:",
    "quick_replies":[
      {
        "content_type":"location",
      }
    ]
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=PAGE_ACCESS_TOKEN"

Campi

Oggetto message

• quick_replies è limitato a 11

Oggetto attachment

Le risposte veloci funzionano con tutti i tipi di messaggi, tra cui quelli con testo, immagini e modelli in allegato. Consulta la documentazione sull'API Send per maggiori informazioni su come usare l'oggetto attachment.

Oggetto quick_reply

• title ha un limite di 20 caratteri, dopodiché viene troncato
• payload ha un limite di 1000 caratteri
• Se content_type è location, title e payload non vengono usati
• L'immagine di image_url deve essere di almeno 24 x 24 e verrà ritagliata e ridimensionata

Callback

Quando viene toccata una risposta veloce, viene inviato un messaggio di testo alla callback per i messaggi ricevuti del tuo webhook. Il testo del messaggio corrisponde al titolo della risposta veloce. Inoltre, l'oggetto del messaggio contiene un campo denominato quick_reply, contenente i dati di payload sulla risposta veloce.

{
  "sender": {
    "id": "USER_ID"
  },
  "recipient": {
    "id": "PAGE_ID"
  },
  "timestamp": 1464990849275,
  "message": {
    "mid": "mid.1464990849238:b9a22a2bcb1de31773",
    "seq": 69,
    "text": "Red",
    "quick_reply": {
      "payload": "DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_RED"
    }
  }
}    

Quando un utente condivide la propria posizione, la callback ha un aspetto simile a questo:

{
  "object": "page",
  "entry": [
    {
      "id": "PAGE_ID",
      "time": 1472672934319,
      "messaging": [
        {
          "sender": {
            "id": "USER_ID"
          },
          "recipient": {
            "id": "PAGE_ID"
          },
          "timestamp": 1472672934259,
          "message": {
            "mid": "mid.1472672934017:db566db5104b5b5c08",
            "seq": 297,
            "attachments": [
              {
                "title": "Facebook HQ",
                "url": "https://www.facebook.com/l.php?u=https%....5-7Ocxrmg",
                "type": "location",
                "payload": {
                  "coordinates": {
                    "lat": 37.483872693672,
                    "long": -122.14900441942
                  }
                }
              }
            ]
          }
        }
      ]
    }
  ]
}