템플릿 만들기
WhatsApp Business 計定 > 메시지 템플릿
엔드포인트로 POST 要請을 보내서 템플릿을 만듭니다.
要請 構文
POST /<WHATSAPP_BUSINESS_ACCOUNT_ID>/message_templates
POST 本文
{
"name": "<NAME>",
"category": "<CATEGORY>",
"allow_category_change": <ALLOW_CATEGORY_CHANGE>,
"language": "<LANGUAGE>",
"components": [<COMPONENTS>]
}
本文 屬性
자리 標示子
| 說明
| 샘플 값
| <NAME>
文字列
| 必須 項目.
템플릿 이름입니다.
最大 512者입니다.
| order_confirmation
|
<CATEGORY>
enum
| 必須 項目.
템플릿 카테고리입니다.
아래의
템플릿 카테고리
를 參照하세요.
| UTILITY
|
<ALLOW_CATEGORY_CHANGE>
부울
| 選擇 事項.
true로 設定하면
카테고리를 自動으로 割當
할 수 있습니다. 省略하는 境遇, 카테고리 誤謬로 인해 템플릿이 거부될 수 있습니다.
| true
|
<LANGUAGE>
enum
| 必須 項目.
템플릿
言語 및 로캘 코드
입니다.
| en_US
|
<LIBRARY_TEMPLATE_NAME>
文字列
| 選擇 事項.
유틸리티 템플릿 라이브러리 템플릿의 正確한 이름입니다.
유틸리티 템플릿 라이브러리
를 使用하여 템플릿을 만드는 方法 알아보기
| delivery_update_1
|
<LIBRARY_TEMPLATE_BUTTON_INPUTS>
個體의 配列
| 選擇 事項.
템플릿에서 使用되는 비즈니스의 웹사이트 및/또는 電話番號입니다.
參考: 버튼이 있는 유틸리티 템플릿의 境遇, 이 屬性은 選擇 事項이
아닙니다
.
유틸리티 템플릿 라이브러리
를 使用하여 템플릿을 만드는 方法 알아보기
| “[
{'type': 'URL', 'url': {'base_url' : 'https://www.example.com/{{1}}',
'url_suffix_example' : 'https://www.example.com/demo'}},
{type: 'PHONE_NUMBER', 'phone_number': '+16315551010'}
]"
|
<COMPONENTS>
個體의 配列
| 必須 項目.
템플릿을 構成하는 構成 要素입니다.
아래의
템플릿 構成 要素
를 參照하세요.
| 아래의
템플릿 構成 要素
를 參照하세요.
|
템플릿 카테고리
템플릿은 다음 中 한 가지 카테고리로 分類되어야 합니다. 카테고리는
價格
에 反映되며 指定한 카테고리는 템플릿 生成 時
檢證
됩니다.
AUTHENTICATION
MARKETING
UTILITY
템플릿을 만들 때 어떤 카테고리를 使用할지 確認하려면
템플릿 카테고리化
文書를 參照하세요.
템플릿 構成 要素
템플릿은 비즈니스 要求 事項을 基盤으로 다양한 텍스트, 미디어 및 인터랙티브 構成 要素로 構成됩니다. 샘플 및 例示 쿼리, 모든 可能한 構成 要素 및 該當 要求 事項의 리스트는
템플릿 構成 要素
文書를 參照하세요.
템플릿을 만들 때 構成 要素 個體의 配列을 要請 本文의 components 屬性에 割當하여 構成 要素를 定義합니다.
例를 들어 두 個의 變數와 샘플 값이 包含된
텍스트 本文
構成 要素,
電話番號 버튼
構成 要素,
URL 버튼
構成 要素를 包含하는 配列은 다음과 같습니다.
[
{
"type": "BODY",
"text": "Thank you for your order, {{1}}! Your confirmation number is {{2}}. If you have any questions, please use the buttons below to contact support. Thank you for being a customer!",
"example": {
"body_text": [
[
"Pablo","860198-230332"
]
]
}
},
{
"type": "BUTTONS",
"buttons": [
{
"type": "PHONE_NUMBER",
"text": "Call",
"phone_number": "15550051310"
},
{
"type": "URL",
"text": "Contact Support",
"url": "https://www.luckyshrub.com/support"
}
]
}
]
샘플 및 例示 쿼리, 모든 可能한 構成 要素 및 該當 要求 事項의 리스트는
템플릿 構成 要素
文書를 參照하세요.
AUTHENTICATION
으로 分類한 템플릿에는 固有한 構成 要素 要求 事項이 있습니다.
引證 템플릿
을 參照하세요.
카테고리 檢證
템플릿 生成 要請을 電送하면 Meta에서
템플릿 카테고리 分類
가이드라인을 使用하여 카테고리를 卽時 檢證합니다.
Meta가 指定된 카테고리에
同意
하는 境遇 템플릿을 만들고
status
를
PENDING
으로 設定합니다. 그러면 템플릿은
템플릿 檢收
를 거치게 됩니다.
Meta가 指定된 카테고리에
同意하지 않는
境遇 템플릿을 만들지만
status
를
REJECTED
로 設定하고
reason
을
INCORRECT_CATEGORY
로 設定한
메시지 템플릿 狀態 업데이트
Webhooks를 트리거합니다. Meta에서는 開發者가 Webhooks를 受信하여 拒否된 템플릿을 確認하거나 새로 生成된 템플릿에서
rejected_reason
필드를 要請할 것을 勸奬합니다. 이 필드는
TAG_CONTENT_MISMATCH
값을 가지게 됩니다.
두 境遇 모두 템플릿의 最初 狀態가 API 應答 過程에서 返還됩니다.
카테고리 檢證 過程에서 템플릿 狀態가
REJECTED
로 設定된 境遇 다음과 같은 여러 가지 옵션이 있습니다.
自動 카테고리 分類
要請에
allow_category_change
屬性을 包含하여 Meta에서 템플릿 內容과
템플릿 카테고리 分類
가이드라인에 따라 카테고리를 自動으로 割當하도록 할 수 있습니다. 그러면 카테고리 誤謬로 인해 템플릿 狀態가 바로
REJECTED
로 設定되지 않도록 할 수 있습니다.
自動 카테고리 分類는 템플릿을 만들 때만 使用할 수 있습니다.
템플릿 檢收
狀態가
PENDING
人 템플릿은 템플릿 檢收를 받는 過程에 있습니다. Meta는 各各의 새로 만들거나 修正된 템플릿의 內容을 檢討하여 콘텐츠 가이드라인과 政策을 遵守하는지 確認합니다. 이 檢收 結果에 따라서 템플릿 狀態를
APPROVED
또는
REJECTED
로 自動 變更합니다. 그러면
메시지 템플릿 狀態 업데이트
Webhooks가 트리거됩니다.
템플릿 狀態
카테고리 檢證 및 템플릿 檢收 結果에 따라 템플릿의
status
를 다음 값 中 한 가지로 設定하거나 變更합니다.
모든 使用 可能한 필드와 狀態는
WhatsApp 메시지 템플릿
엔드포인트 參考 資料를 參照하세요.
應答
要請이 成功하면 새로 만든 템플릿 ID, 狀態, 카테고리를 包含하여 API가 應答합니다. 可能한 세 가지 結果는 다음과 같습니다.
{
"id": "<ID>",
"status": "<STATUS>",
"category": "<CATEGORY>"
}
應答 屬性
자리 標示子
| 說明
| 샘플 값
| <ID>
| 템플릿 ID입니다.
| 572279198452421
|
<STATUS>
| 템플릿 狀態
입니다.
| PENDING
|
<CATEGORY>
| 開發者가 指定했거나
Meta에서 割當한
템플릿 카테고리
입니다.
| MARKETING
|
要請 例示
다음의 構成 要素로 構成된 시즌性 弘報 템플릿을 만들기 위한 要請의 예:
텍스트 헤더
텍스트 本文
바닥글
두 個의 빠른 答狀 버튼
追加的인 例示는
要請 例示
를 參照하세요.
curl 'https://graph.facebook.com/
v20.0
/102290129340398/message_templates' \
-H 'Authorization: Bearer EAAJB...' \
-H 'Content-Type: application/json' \
-d '
{
"name": "seasonal_promotion",
"language": "en_US",
"category": "MARKETING",
"components": [
{
"type": "HEADER",
"format": "TEXT",
"text": "Our {{1}} is on!",
"example": {
"header_text": [
"Summer Sale"
]
}
},
{
"type": "BODY",
"text": "Shop now through {{1}} and use code {{2}} to get {{3}} off of all merchandise.",
"example": {
"body_text": [
[
"the end of August","25OFF","25%"
]
]
}
},
{
"type": "FOOTER",
"text": "Use the buttons below to manage your marketing subscriptions"
},
{
"type":"BUTTONS",
"buttons": [
{
"type": "QUICK_REPLY",
"text": "Unsubscribe from Promos"
},
{
"type":"QUICK_REPLY",
"text": "Unsubscribe from All"
}
]
}
]
}'
應答 例示
{
"id": "572279198452421",
"status": "PENDING",
"category": "MARKETING"
}