문서가 업데이트되었습니다.
한국어로 번역이 아직 완료되지 않았습니다.
영어 업데이트됨: 2023. 3. 15.

일반 템플릿

일반 템플릿을 사용하면 이미지, 텍스트, 버튼을 포함한 구조화된 메시지를 보낼 수 있습니다. 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":"

응답 예시

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

속성

recipient

메시지를 받는 사람에 대한 설명. 모든 요청에는 받는 사람을 식별하기 위한 다음의 속성 중 하나를 포함해야 합니다.

속성 유형 설명

recipient.id

문자열

메시지를 받는 사람의 IG 범위 사용자 ID(IGSID).

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>

전송할 일반 템플릿의 인스턴스를 설명하는 element 개체의 배열. 여러 요소를 지정하면 템플릿으로 구성된 수평 스크롤 가능한 슬라이드가 전송됩니다. 최대 10개의 요소가 지원됩니다.

message.attachment.payload.elements

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

속성 이름 유형 설명

title

문자열

템플릿에 표시할 제목입니다. 80자로 제한됩니다.

subtitle

문자열

선택 사항. 템플릿에 표시할 부제입니다. 80자로 제한됩니다.

image_url

문자열

선택 사항. 템플릿에 표시할 이미지의 URL입니다.

default_action

개체

선택 사항. 템플릿을 탭하면 실행되는 기본 작업입니다. 동일한 속성을 URL 버튼으로 허용합니다. title은 예외입니다.

buttons

배열<button>

선택 사항. 템플릿에 첨부할 버튼의 배열입니다. 요소당 최대 3개의 버튼을 지원합니다. postbackweb_url 버튼만 지원됩니다.