Общий шаблон

Общий шаблон — это простое структурированное сообщение, содержащее название, субтитры, изображение и кнопки (не более трех). Кроме того, можно указать объект default_action, задающий URL, который будет открыт в веб-представлении Messenger при касании шаблона.

Содержание

Полезные данные шаблона

Полный список свойств шаблона см. в справке по общему шаблону.

"payload": {
  "template_type":"generic",
  "elements":[
     {
      "title":"

Платформа Messenger поддерживает отправку кольцевой галереи общих шаблонов с горизонтальной прокруткой.

Чтобы создать кольцевую галерею с прокруткой, добавьте до 10 общих шаблонов в массив elements объекта payload.

"payload": {
  "template_type":"generic",
  "elements":[

Пример запроса

Сведения и свойства запроса см. в справке по общему шаблону.

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>"

Пример ответа

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

Рекомендации

Используйте для сообщений с единообразной иерархией информации (например, предпросмотр товаров или статей, прогноз погоды).

Используйте правильное соотношение сторон для изображения. В общем шаблоне фотографии с соотношением сторон, отличным от 1.91:1, будут масштабированы или обрезаны.

Не используйте, если ваше сообщение не содержит структурированной информации или ему необходима иерархия.

Не используйте, если вам необходимо, чтобы пользователи могли увеличить изображение на весь экран.

Не используйте в шаблоне изображения GIF, если они должны быть анимированными. Изображения GIF поддерживаются, но не могут быть анимированными.

Используйте кольцевую галерею, если ваш контент должен отображаться в порядке приоритетности, то есть когда первый элемент является наиболее интересным.

Старайтесь обеспечить единообразие. Если в значке облака есть фото, добавьте фото во все из них.

Максимально сократите количество общих шаблонов в своей кольцевой галерее. Если шаблонов слишком много, пользователям будет сложно запомнить все варианты.

Не используйте контент разных типов. Если вы добавляете статью вместе со списком товаров, ваша конечная цель может быть непонятной.

Не используйте кольцевую галерею, если пользователям важно видеть все пункты в списке. Возможно, они не смогут прокрутить список до конца. Вместо этого рассмотрите вариант использования шаблона списка.