일반 템플릿 참조

일반 템플릿을 사용하면 이미지, 텍스트, 버튼을 포함한 구조화된 메시지를 보낼 수 있습니다. elements 배열에 설명된 여러 템플릿이 포함된 일반 템플릿은 수평 스크롤이 가능한 항목으로 구성된 슬라이드를 전송하며, 각 항목은 이미지, 텍스트, 버튼으로 구성됩니다. 구현에 대한 자세한 내용은 일반 템플릿을 참조하세요.

요청 URI

https://graph.facebook.com/v21.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>

요청 예시

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

속성

`recipient`

메시지 받는 사람의 설명. 모든 요청에는 id, phone_number 또는 user_ref 중 하나가 포함되어야 합니다.

속성	유형	설명
`recipient.id`	문자열	메시지를 받는 사람의 `PSID`, `phone_number` 또는 `user_ref`.
`recipient.phone_number`	문자열	*선택 사항.* 받는 사람의 전화번호(형식: +1(212)555-2368). 이 방법으로 메시지를 보내려면 봇의 고객 매칭 기능 사용이 승인되어야 합니다.
`recipient.user_ref`	문자열	*선택 사항.*확인란 플러그인의 `user_ref`입니다.
`recipient.name`	개체	*선택 사항.*`phone_number`가 설정된 경우에만 사용됩니다. 사람 이름을 다음과 같은 형식으로 지정합니다. `{"first_name":"John", "last_name":"Doe"}` 이름을 지정하면 매칭 성공 확률이 증가합니다.

`message`

Description of the message to be sent.

Property	Type	Description
`message.attachment`	Object	An object describing attachments to the message.

`message.attachment`

Property	Type	Description
`type`	String	Value must be `template`
`payload`	Object	템플릿의 `payload`입니다.

`message.attachment.payload`

속성 이름	유형	설명
`template_type`	문자열	값은 `generic`이어야 합니다.
`elements`	배열<`element`>	메시지에서 미디어를 설명하는 요소 개체 하나를 포함하는 배열입니다. 최대 1개의 요소가 지원됩니다.
`sharable`	부울	*선택 사항.* Messenger에서 템플릿 메시지에 대한 네이티브 공유 버튼을 활성화하려면 `true`로 설정하세요. 기본값은 `false`입니다.

`message.attachment.payload.elements`

일반 템플릿은 메시지 1개당 최대 10개의 요소를 지원합니다. title 외에 적어도 1개의 속성을 설정해야 합니다.

속성 이름	유형	설명
`title`	문자열	템플릿에 표시할 제목입니다. 80자로 제한됩니다.
`subtitle`	문자열	*선택 사항.* 템플릿에 표시할 부제입니다. 80자로 제한됩니다.
`image_url`	문자열	*선택 사항.* 템플릿에 표시할 이미지의 URL입니다.
`default_action`	개체	*선택 사항.* 템플릿을 탭하면 실행되는 기본 작업입니다. 동일한 속성을 URL 버튼으로 허용합니다. `title`은 예외입니다.
`buttons`	배열<`button`>	*선택 사항.* 템플릿에 첨부할 버튼의 배열입니다. 요소당 최대 3개의 버튼을 지원합니다.