Modelo genérico
Os modelos genéricos são mensagens simples e estruturadas, com título, subtítulo, imagem e até três botões. Além disso, é possível especificar um objeto default_action para definir uma URL a ser aberta no webView do Messenger quando o modelo for tocado.
Conteúdo
Carga do modelo
Para ver a lista completa de propriedades, consulte Referências de modelo genérico.
"payload": {
"template_type":"generic",
"elements":[
{
"title":"Enviar um carrossel de modelos genéricos
A plataforma do Messenger é compatível com o envio de um carrossel de modelos genéricos com rolagem horizontal.
Para criar um carrossel com rolagem, inclua até 10 modelos genéricos na matriz de elements do payload.
"payload": {
"template_type":"generic",
"elements":[Exemplo de solicitação
Para ver todos os detalhes e as propriedades da solicitação, consulte Referências de modelo genérico.
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>"Exemplo de resposta
{
"recipient_id": "1254477777772919",
"message_id": "AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P"
}
Boas práticas
Use esses modelos para mensagens com hierarquia de informação consistente (por exemplo, prévia de produtos ou artigos, previsões meteorológicas).
Use a proporção correta na sua imagem. No modelo genérico, as fotos com dimensão diferente de 1,91:1 serão redimensionadas ou cortadas.
Não use modelos genéricos caso a sua mensagem não tenha informações estruturadas nem exija hierarquia.
Também não os utilize se precisar que as pessoas ampliem a imagem em tela cheia.
Não use GIFs no modelo se pretender que eles sejam animados. Os GIFs são aceitos, mas não serão animados.
Carrossel
Use um carrossel quando o seu conteúdo tiver ordem de prioridade (ou seja, caso o primeiro item seja o mais interessante).
Tente manter a consistência. Se um balão tiver uma foto, inclua fotos em todos eles.
Minimize o número de modelos genéricos no seu carrossel. Caso contrário, as pessoas terão dificuldades para lembrar de todas as opções.
Não misture tipos de conteúdo. Se você incluir um artigo ao lado de uma lista de produtos, a experiência pode gerar confusão.
Não use carrosséis quando for importante que as pessoas vejam tudo na lista. É possível que elas não rolem a tela até o final. Nesse caso, considere usar modelos de lista.