Riferimento per le risposte rapide

Le risposte rapide ti consentono di ricevere l'input del destinatario del messaggio inviando pulsanti all'interno del messaggio. Quando viene toccata una risposta rapida, il valore del pulsante viene inviato nella conversazione e la Piattaforma Messenger invia un evento messages al tuo webhook. Le risposte rapide sono un tipo di messaggio inviato con l'API Send. Per dettagli completi sull'invio dei messaggi, consulta Messaggi.

Per dettagli completi sull'utilizzo, consulta Risposte rapide.

Esempio di richiesta

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/v19.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

Esempio di risposta

{
  "recipient_id": "1254477777772919",
  "message_id": "AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P"
}

Proprietà

Proprietà	Tipo	Descrizione
`text`	Stringa	Testo del messaggio non vuoto da inviare con le risposte rapide. Deve essere impostato `text` o `attachment`.
`attachment`	Oggetto	Un allegato da inviare con le risposte rapide. Deve essere impostato `text` o `attachment`.
`quick_replies`	Array<`quick_reply`>	Un array di oggetti che descrivono i pulsanti di risposta rapida da inviare. Sono supportate al massimo 13 risposte rapide.

`quick_reply`

Proprietà	Tipo	Descrizione
`content_type`	Stringa	Deve essere uno dei seguenti: `text`: invia un pulsante di testo `user_phone_number`: invia un pulsante che consente al destinatario di inviare il numero di telefono associato al proprio account. `user_phone_number`: invia un pulsante che consente al destinatario di inviare l'e-mail associata al proprio account.
`title`	Stringa	Obbligatorio se `content_type` è "text". Il testo da mostrare sul pulsante di risposta rapida. Limite di 20 caratteri.
`payload`	Stringa, numero	Obbligatorio se `content_type` è "text". Dati personalizzati che ti verranno rispediti tramite l'evento webhook `messaging_postbacks`. Limite di 1000 caratteri. Può essere impostato su una stringa vuota se è impostato `image_url`.
`image_url`	Stringa	*Facoltativo.* URL dell'immagine da visualizzare sul pulsante di risposta rapida per le risposte rapide di testo. L'immagine deve essere almeno 24 pixel x 24 pixel. Le immagini più grandi saranno automaticamente ritagliate e ridimensionate. Obbligatorio se `title` è una stringa vuota.