Plantilla genérica
La plantilla genérica es un mensaje estructurado sencillo que incluye un título, un subtítulo, una imagen y un máximo de tres botones. También puedes especificar un objeto default_action para establecer una URL que se abrirá en la vista web de Messenger cuando se toque la plantilla.
Contenido
Carga útil de la plantilla
Para obtener una lista completa de las propiedades de las plantillas, consulta la referencia de la plantilla genérica.
"payload": {
"template_type":"generic",
"elements":[
{
"title":"Enviar una secuencia de plantillas genéricas
La plataforma de Messenger admite el envío de una secuencia de plantillas genéricas por la que las personas puedan desplazarse horizontalmente.
Para crear una secuencia de elementos por la que el destinatario del mensaje se pueda desplazar, incluye un máximo de diez plantillas genéricas en la matriz elements del campo payload.
"payload": {
"template_type":"generic",
"elements":[Ejemplo de solicitud
Para obtener toda la información sobre las propiedades y los detalles de la solicitud, consulta la referencia de la plantilla genérica.
curl -X POST -H "Content-Type: application/json" -d '{
"recipient":{
"id":"<PSID>"
},
"message":{
"attachment":{
"type":"template",
"payload":{
"template_type":"generic",
"elements":[
{
"title":"Welcome!",
"image_url":"https://petersfancybrownhats.com/company_image.png",
"subtitle":"We have the right hat for everyone.",
"default_action": {
"type": "web_url",
"url": "https://petersfancybrownhats.com/view?item=103",
"messenger_extensions": false,
"webview_height_ratio": "tall",
"fallback_url": "https://petersfancybrownhats.com/"
},
"buttons":[
{
"type":"web_url",
"url":"https://petersfancybrownhats.com",
"title":"View Website"
},{
"type":"postback",
"title":"Start Chatting",
"payload":"DEVELOPER_DEFINED_PAYLOAD"
}
]
}
]
}
}
}
}' "https://graph.facebook.com/v2.6/me/messages?access_token=<PAGE_ACCESS_TOKEN>"Ejemplo de respuesta
{
"recipient_id": "1254477777772919",
"message_id": "AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P"
}
Prácticas recomendadas
Utiliza mensajes que tengan una jerarquía de información coherente (por ejemplo, vistas previas de productos o artículos, o previsiones meteorológicas).
Utiliza la relación de aspecto adecuada para la imagen. Las fotos de plantillas genéricas que tengan una relación distinta de 1,91:1 se ampliarán o recortarán.
No la utilices si tu mensaje no tiene información estructurada o no necesita una jerarquía.
No la utilices si necesitas que las personas tengan la posibilidad de ampliar la imagen a pantalla completa.
No utilices gifs en la plantilla si pretendes que sean animados. Los gifs se admiten, pero no serán animados.
Secuencia
Utiliza una secuencia cuando tu contenido tenga un orden de prioridad, es decir, el primer elemento es probablemente el más interesante.
Trata de ser coherente. Si un cuadro tiene una foto, incluye una foto en todos.
Minimiza el número de plantillas genéricas de la secuencia. Un número excesivo hace que resulte difícil recordar todas las opciones.
No mezcles tipos de contenido. Si incluyes un artículo junto a una lista de productos, tu experiencia podría generar confusión.
No utilices una secuencia cuando sea importante que las personas vean todo lo que hay en la lista. Es posible que no se desplacen hasta el final. En su lugar, plantéate la posibilidad de usar una plantilla de lista.