Referencia de la plantilla de botón

La plantilla de botón te permite enviar un mensaje estructurado que incluya texto y botones. Para obtener detalles sobre la implementación, consulta plantilla de botón.

Índice

URI de la solicitud
Ejemplo de solicitud
Ejemplo de respuesta
Propiedades

URI de la solicitud

https://graph.facebook.com/v19.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>

Ejemplo de solicitud

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<PSID>"
  },
  "message":{
    "attachment":{
      "type":"template",
      "payload":{
        "template_type":"button",
        "text":"What do you want to do next?",
        "buttons":[
          {
            "type":"web_url",
            "url":"https://www.messenger.com",
            "title":"Visit Messenger"
          },
          {
            ...
          },
          {...}
        ]
      }
    }
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

Ejemplo de respuesta

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

Propiedades

`recipient`

Descripción del destinatario del mensaje. Todas las solicitudes deben incluir uno de los siguientes valores: id, phone_number, o user_ref.

Propiedad	Tipo	Descripción
`recipient.id`	Cadena	Ya sea `PSID`, `phone_number` o `user_ref` del destinatario del mensaje.
`recipient.phone_number`	Cadena	*Opcional.* Número de teléfono del destinatario con el formato +1(212)555-2368. Para enviar mensajes de esta forma, tu bot debe estar aprobado para la segmentación por lista de clientes.
`recipient.user_ref`	Cadena	*Opcional.*`user_ref` del plugin de casilla de verificación.
`recipient.name`	Object	*Opcional.* Se usa solo si se configura `phone_number`. Especifica el nombre de la persona con el formato: `{"first_name":"John", "last_name":"Doe"}` Cuando se proporciona el nombre aumentan las probabilidades de obtener una coincidencia exitosa.

`message`

Description of the message to be sent.

Property	Type	Description
`message.attachment`	Object	An object describing attachments to the message.

`message.attachment`

Property	Type	Description
`type`	String	Value must be `template`
`payload`	Object	`payload` de la plantilla.

`message.attachment.payload`

Propiedad	Tipo	Descripción
`template_type`	Cadena	El valor debe ser `button`
`text`	Cadena	Texto codificado UTF-8 de hasta 640 caracteres. El texto aparecerá encima de los botones.
`buttons`	Matriz <button>	Conjunto de 1 a 3 botones, que aparecen como llamada a la acción.