Messenger 플랫폼

일반 템플릿

일반 템플릿은 제목, 부제, 이미지, 3개 이내의 버튼을 포함하는 단순한 구조화된 메시지입니다. 또한 템플릿을 누를 때 Messenger 웹 보기에서 열리는 URL을 설정하는 default_action 개체를 지정할 수도 있습니다.

목차

템플릿 페이로드

템플릿 속성의 전체 리스트는 일반 템플릿 참조 문서를 참조하세요.

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

Messenger 플랫폼에서는 일반 템플릿의 수평 스크롤 가능한 슬라이드를 전송할 수 있습니다.

스크롤 가능한 슬라이드를 만들려면 payload의 elements 배열에 일반 템플릿을 최대 10개 포함하세요.

"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는 지원되지만 애니메이션은 적용되지 않습니다.

콘텐츠에 우선순위가 있을 경우 슬라이드를 사용하세요(예: 첫 항목이 가장 흥미를 유발할 가능성이 클 경우).

되도록이면 일관성을 유지하세요. 어떤 버블에 사진이 있을 경우 모든 버블에 사진을 포함하세요.

슬라이드에서 일반 템플릿 수를 최소화하세요. 일반 템플릿이 너무 많으면 사용자가 모든 옵션을 기억하기 어렵습니다.

콘텐츠 유형을 섞지 마세요. 제품 리스트 옆에 아티클을 포함할 경우 경험에서 혼란이 발생할 수 있습니다.

사용자가 리스트에 있는 모든 항목을 보는 것이 중요할 경우 슬라이드를 사용하지 마세요. 끝까지 스크롤되지 않을 수 있습니다. 대신 리스트 템플릿을 사용하는 것이 좋습니다.