Messenger 플랫폼

버튼 템플릿 참고 자료

버튼 템플릿을 사용하면 텍스트와 버튼을 포함한 구조화된 메시지를 보낼 수 있습니다. 구현에 대한 자세한 내용은 버튼 템플릿을 참조하세요.

목차

요청 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":"button",
        "text":"What do you want to do next?",
        "buttons":[
          {
            "type":"web_url",
            "url":"https://www.messenger.com",
            "title":"Visit Messenger"
          },
          {
            ...
          },
          {...}
        ]
      }
    }
  }
}' "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

문자열

값은 button이어야 합니다.

text

문자열

640자 이내의 UTF-8 인코딩 텍스트입니다. 텍스트는 버튼 위에 표시됩니다.

buttons

배열<button>

행동 유도로 표시되는 1~3개의 버튼으로 구성된 세트입니다.