쿠폰 코드 템플릿

쿠폰 코드 템플릿은 하나의 코드 복사 버튼을 표시하는 마케팅 템플릿입니다. 이 버튼을 누르면 코드가 고객 클립보드에 복사됩니다.

제한 사항

현재 쿠폰 코드 템플릿은 WhatsApp 웹 클라이언트에서 지원되지 않습니다.
코드는 15자로 제한됩니다.
버튼 텍스트는 맞춤 설정할 수 없습니다.
템플릿에서는 코드 복사 버튼이 하나로 제한됩니다.

쿠폰 코드 템플릿 만들기

WhatsApp Business 계정 > 메시지 템플릿 엔드포인트를 사용하여 쿠폰 코드 템플릿을 만듭니다.

요청 구문

POST /<WHATSAPP_BUSINESS_ACCOUNT_ID>/message_templates

POST 본문

{
  "name": "<NAME>",
  "language": "<LANGUAGE>",
  "category": "MARKETING",
  "components": [
    ... // Additional components, if using
    {
      "type":"BUTTONS",
      "buttons": [
        {
          "type":"COPY_CODE",
          "example": "<EXAMPLE>"
        },
        ... // Additional buttons, if using
      ]
    }
  ]
}

속성

자리 표시자 설명 예시 값

자리 표시자	설명	예시 값
`<NAME>` 문자열	필수 항목. 템플릿 이름입니다. 최대 512자입니다.	`fall2023_promotion`
`<LANGUAGE>` enum	필수 항목. 템플릿 언어 및 로캘 코드입니다.	`en_US`
`<EXAMPLE>` 문자열	필수 항목. 버튼을 눌렀을 때 복사되는 쿠폰 코드입니다. 최대 15자입니다.	`25OFF`

<NAME>

문자열

필수 항목.

템플릿 이름입니다.

최대 512자입니다.

fall2023_promotion

<LANGUAGE>

enum

필수 항목.

템플릿 언어 및 로캘 코드입니다.

en_US

<EXAMPLE>

문자열

필수 항목.

버튼을 눌렀을 때 복사되는 쿠폰 코드입니다.

최대 15자입니다.

25OFF

응답

요청에 성공하면 API가 다음과 같이 응답합니다.

{
   "category" : "<CATEGORY>",
   "id" : "<ID>",
   "status" : "<STATUS>"
}

응답 속성

자리 표시자 설명 예시 값

자리 표시자	설명	예시 값
`<CATEGORY>` enum	템플릿 카테고리입니다.	`MARKETING`
`<ID>` 숫자 문자열	템플릿 ID입니다.	`1924084211297547`
`<STATUS>` enum	템플릿 상태입니다.	`PENDING`

<CATEGORY>

enum

템플릿 카테고리입니다.

MARKETING

<ID>

숫자 문자열

템플릿 ID입니다.

1924084211297547

<STATUS>

enum

템플릿 상태입니다.

PENDING

요청 예시

curl 'https://graph.facebook.com/v21.0/102290129340398/message_templates' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "name": "coupon_code_fall2023_25off",
  "language": "en_US",
  "category": "MARKETING",
  "components": [
    {
      "type": "HEADER",
      "format": "TEXT",
      "text": "Our Fall Sale is on!"
    },
    {
      "type": "BODY",
      "text": "Shop now through November and use code {{1}} to get {{2}} off of all merchandise!",
      "example": {
        "body_text": [
          [
            "25OFF",
            "25%"
          ]
        ]
      }
    },
    {
      "type": "BUTTONS",
      "buttons": [
        {
          "type": "QUICK_REPLY",
          "text": "Unsubscribe"
        },
        {
          "type": "COPY_CODE",
          "example": "250FF"
        }
      ]
    }
  ]
}'

응답 예시

{
  "category" : "MARKETING",
  "id" : "1924084211297547",
  "status" : "PENDING"
}

쿠폰 템플릿 보내기

클라우드 API를 사용하여 템플릿 메시지에서 승인된 쿠폰 코드 템플릿을 보냅니다. 쿠폰 코드 템플릿 보내기를 참조하세요.