Este documento se ha actualizado.
La traducción en Español (España) no está disponible todavía.

Actualización del documento en inglés: 7 mar. 2023

Plantilla genérica

Con la plantilla genérica, puedes enviar un mensaje estructurado en el que se incluya una imagen, texto y botones. Una plantilla genérica con diversas plantillas descritas en la matriz elements enviará una secuencia de elementos por los que los usuarios pueden desplazarse horizontalmente. Cada secuencia se compone de una imagen, texto y botones.

Actualmente, esta función no está disponible en ordenadores.

URI de 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":"

Ejemplo de respuesta

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

Propiedades

`recipient`

Descripción del destinatario del mensaje. Todas las solicitudes deben incluir una de las siguientes propiedades para identificar al destinatario.

Propiedad	Tipo	Descripción
`recipient.id`	Cadena	Identificador de usuario específico de Instagram (IGSID) del destinatario del mensaje.

`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	Objeto `payload` de la plantilla.

`message.attachment.payload`

Propiedad	Tipo	Descripción
`template_type`	Cadena	El valor debe ser `generic`.
`elements`	Matriz de <`element`>	Matriz de objetos `element` que describen ejemplos de la plantilla genérica que se va a enviar. Si se especifican diversos elementos, se enviará una secuencia de plantillas por las que las personas pueden desplazarse horizontalmente. Se admite un máximo de diez elementos.

`message.attachment.payload.elements`

La plantilla genérica admite un máximo de diez elementos por mensaje. Debe establecerse como mínimo una propiedad, además de title.

Nombre de la propiedad	Tipo	Descripción
`title`	Cadena	Título que se muestra en la plantilla. Límite de 80 caracteres.
`subtitle`	Cadena	*Opcional.* Subtítulo que se muestra en la plantilla. Límite de 80 caracteres.
`image_url`	Cadena	*Opcional.* URL de la imagen que se muestra en la plantilla.
`default_action`	Objeto	*Opcional.* Acción predeterminada que se ejecuta cuando alguien toca la plantilla. Acepta las mismas propiedades que el botón de URL, a excepción de `title`.
`buttons`	Matriz de <`button`>	*Opcional.* Matriz de botones que se anexarán a la plantilla. Se admite un máximo de tres botones por elemento. Solo se admiten los botones `postback` y `web_url`.