Represents a collection of templates on a WhatsApp Business Account. See Templates.
Get a list of templates on a WhatsApp Business Account.
Type | Description |
---|---|
Access Tokens | User or System User |
Permissions |
GET /<WHATSAPP_BUSINESS_ACCOUNT_ID>/message_templates ?category=<CATEGORY>, &content=<CONTENT>, &language=<LANGUAGE>, &name=<NAME>, &name_or_content=<NAME_OR_CONTENT>, &quality_score=<QUALITY_SCORE>, &status=<STATUS>
Placeholder | Value |
---|---|
| WhatsApp Business Account ID. |
A list of WhatsApp Message Template nodes.
curl 'https://graph.facebook.com/v16.0/102290129340398/message_templates?category=utility' \ -H 'Authorization: Bearer EAAJB...'
{ "data": [ { "name": "order_delivery_update", "components": [ { "type": "HEADER", "format": "LOCATION" }, { "type": "BODY", "text": "Good news {{1}}! Your order #{{2}} is on its way to the location above. Thank you for your order!", "example": { "body_text": [ [ "Mark", "566701" ] ] } }, { "type": "FOOTER", "text": "To stop receiving delivery updates, tap the button below." }, { "type": "BUTTONS", "buttons": [ { "type": "QUICK_REPLY", "text": "Stop Delivery Updates" } ] } ], "language": "en_US", "status": "APPROVED", "category": "UTILITY", "id": "1667192013751005" }, ... ], "paging": { "cursors": { "before": "MAZDZD", "after": "MjQZD" } } }
Thông số | Mô tả |
---|---|
category array<enum {ACCOUNT_UPDATE, PAYMENT_UPDATE, PERSONAL_FINANCE_UPDATE, SHIPPING_UPDATE, RESERVATION_UPDATE, ISSUE_RESOLUTION, APPOINTMENT_UPDATE, TRANSPORTATION_UPDATE, TICKET_UPDATE, ALERT_UPDATE, AUTO_REPLY, TRANSACTIONAL, OTP, UTILITY, MARKETING, AUTHENTICATION}> | The category for a template |
content string | The content for a template |
language array<string> | A list of supported languages that are available for each template |
name string | The name for a message template |
name_or_content string | Returns a list of message templates where the value for |
quality_score array<enum {GREEN, YELLOW, RED, UNKNOWN}> | The quality score for a template |
status array<enum {APPROVED, IN_APPEAL, PENDING, REJECTED, PENDING_DELETION, DELETED, DISABLED, PAUSED, LIMIT_EXCEEDED, ARCHIVED}> | The review status for a template |
Đọc từ cạnh này sẽ trả về một kết quả JSON đã định dạng:
{ "
data
": [], "paging
": {}, "summary
": {} }
data
paging
summary
Thông tin tổng hợp về cạnh, chẳng hạn số lượng. Hãy chỉ định các trường để tìm nạp trong thông số tóm tắt (như summary=total_count
).
Trường | Mô tả |
---|---|
total_count unsigned int32 | The total number of message templates that belong to a WhatsApp Business Account |
message_template_count int32 | The current number of message templates that belong to the WhatsApp Business Account |
message_template_limit int32 | The maximum number of message templates that can belong to a WhatsApp Business Account |
are_translations_complete bool | The status for template translations |
Lỗi | Mô tả |
---|---|
80008 | There have been too many calls to this WhatsApp Business account. Wait a bit and try again. For more info, please refer to https://developers.facebook.com/docs/graph-api/overview/rate-limiting. |
100 | Invalid parameter |
200 | Permissions error |
190 | Invalid OAuth 2.0 Access Token |
message_templates
từ các đường dẫn sau: Type | Description |
---|---|
Access Tokens | User or System User |
Permissions |
POST /<WHATSAPP_BUSINESS_ACCOUNT_ID>/message_templates
Placeholder | Value |
---|---|
| ID of the WhatsApp Business Account to create the template on. |
See Parameters for property descriptions.
{ "allow_category_change": <ALLOW_CATEGORY_CHANGE>, "name": "<NAME>", "language": "<LANGUAGE>", "category": "<CATEGORY>", "components": [<COMPONENTS>] }
See Return Type.
curl 'https://graph.facebook.com/v21.0
/102290129340398/message_templates' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
"name": "seasonal_promotion",
"language": "en",
"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": "Unsubcribe from Promos"
},
{
"type":"QUICK_REPLY",
"text": "Unsubscribe from All"
}
]
}
]
}'
{ "id": "594425479261596", "status": "PENDING", "category": "MARKETING" }
Thông số | Mô tả |
---|---|
allow_category_change boolean | Set to
|
category enum {UTILITY, MARKETING, AUTHENTICATION} | Template category. See Template Categories. Bắt buộc |
components array<JSON object> | Array of components that make up the template. See Template Components.
|
language string | Template location and locale code. Bắt buộc |
library_template_body_inputs JSON object | Optional data during creation of a template from a library template. These are optional fields for the body component. |
library_template_button_inputs array<JSON object> | Optional data during creation of a template from a library template. These are optional fields for the button component. |
library_template_name string | library_template_name |
message_send_ttl_seconds int64 | Time to live for message template sent. If users are offline for more than TTL duration after message template is sent, message will be dropped from message queue and will not be delivered. Only allowed for authentication message templates. |
name string | Template name. Bắt buộc |
parameter_format enum {NAMED, POSITIONAL} | The parameter format of the template |
sub_category enum {ORDER_DETAILS, ORDER_STATUS} | Sub category of the template |
id
: numeric string, status
: enum, category
: enum, Lỗi | Mô tả |
---|---|
100 | Invalid parameter |
192 | Invalid phone number |
131009 | Parameter value is not valid |
200 | Permissions error |
80008 | There have been too many calls to this WhatsApp Business account. Wait a bit and try again. For more info, please refer to https://developers.facebook.com/docs/graph-api/overview/rate-limiting. |
368 | The action attempted has been deemed abusive or is otherwise disallowed |
190 | Invalid OAuth 2.0 Access Token |
/{whats_app_business_account_id}/message_templates
.Type | Description |
---|---|
Access Tokens | User or System User |
Permissions |
DELETE /<WHATSAPP_BUSINESS_ACCOUNT_ID>/message_templates
Placeholder | Value |
---|---|
| ID of the WhatsApp Business Account that owns the template. |
See Return Type.
curl -X DELETE 'https://graph.facebook.com/v21.0
/102290129340398/message_templates?name=order_confirmation' \
-H 'Authorization: Bearer EAAJB...'
{ "success": true }
Thông số | Mô tả |
---|---|
hsm_id numeric string | ID of template to be deleted. Required if deleting a template by ID. |
name string | Name of template to be deleted. Bắt buộc |
success
: bool, Lỗi | Mô tả |
---|---|
100 | Invalid parameter |
200 | Permissions error |
190 | Invalid OAuth 2.0 Access Token |
80008 | There have been too many calls to this WhatsApp Business account. Wait a bit and try again. For more info, please refer to https://developers.facebook.com/docs/graph-api/overview/rate-limiting. |