Plantilla genérica
La plantilla genérica es un mensaje simple estructurado que incluye título, subtítulo, imagen, texto y hasta tres botones. También puedes especificar un objeto default_action que define la URL que se abrirá en la vista web de Messenger cuando una persona toque la plantilla.
Índice
Carga de plantilla
Para ver una lista completa de las propiedades de la plantilla, consulta la referencia de la plantilla genérica.
"payload": {
"template_type":"generic",
"elements":[
{
"title":"Enviar una secuencia de plantillas genéricas
La plataforma de mensajes admite el envío de una secuencia de plantillas genéricas, que se puede desplazar de manera horizontal.
Para crear una secuencia desplazable, incluye hasta 10 plantillas genéricas en la matriz elements de la payload.
"payload": {
"template_type":"generic",
"elements":[Ejemplo de solicitud
Para ver las propiedades y los detalles completos 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
Úsala para mensajes que tengan una jerarquía de información coherente (p. ej., vistas previas de productos o artículos, pronósticos del tiempo).
Usa la relación de aspecto correcta para tu imagen. Las fotos de la plantilla genérica que no tengan una relación de aspecto de 1.91:1 se ampliarán o recortarán.
No la uses si el mensaje no tiene una información estructurada o requiere jerarquía.
No la uses si necesitas que las personas puedan ampliar tu imagen a pantalla completa.
No uses GIF en la plantilla si pretendes que sean animados. Los GIF son compatibles, pero no podrán ser animados.
Secuencia
Usa una secuencia cuando tu contenido tenga un orden de prioridad, es decir, cuando el primer artículo sea probablemente el más interesante.
Esfuérzate por demostrar coherencia. Si una burbuja tiene una foto, incluye una foto en todas.
Minimiza la cantidad de plantillas genéricas de la secuencia. De lo contrario, a las personas les resultará difícil recordar todas las opciones.
No mezcles diferentes tipos de contenido. Si incluyes un artículo junto a una lista de productos, tu experiencia podría causar confusión.
No uses una secuencia si es importante que las personas vean todo el contenido de la lista. Lo más probable es que no se desplacen hasta el final. Considera usar una plantilla de lista.