Messenger 플랫폼

일반 템플릿 참조

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

목차

요청 URI

https://graph.facebook.com/v19.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개의 버튼을 지원합니다.