Версия API Graph

Whats App Business Account Message Templates

Represents a collection of templates on a WhatsApp Business Account. See Templates.

Чтение

Get a list of templates on a WhatsApp Business Account.

Requirements

Type	Description
Access Tokens	User or System User
Permissions	whatsapp_business_management

Request Syntax

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>

Path Parameters

Placeholder	Value
`<WHATSAPP_BUSINESS_ACCOUNT_ID>`	WhatsApp Business Account ID.

Response

A list of WhatsApp Message Template nodes.

Sample Request

curl 'https://graph.facebook.com/v16.0/102290129340398/message_templates?category=utility' \
-H 'Authorization: Bearer EAAJB...'

Sample Response

{
  "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"
    }
  }
}

Параметры

Параметр	Описание
`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 `name` or `content` match this value
`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

Поля

При чтении с данной границы контекста будет возвращен результат в формате JSON:

{
    "data": [],
    "paging": {},
    "summary": {}
}

`data`

Список узлов «WhatsAppMessageTemplate».

`paging`

Для получения дополнительных сведений о пагинации смотрите Руководство по API Graph.

`summary`

Совокупная информация о ребре, такая как «количество». Укажите поля для получения суммарного параметра (такого как summary=total_count).

Поле	Описание
`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

Error Codes

Ошибка	Описание
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

Создание

Вы можете сделать запрос POST к границе message_templates из этих местоположений:

/{whats_app_business_account_id}/message_templates

При размещении публикации на этой границе создается a WhatsAppMessageTemplate.

Type	Description
Access Tokens	User or System User
Permissions	whatsapp_business_management

Request Syntax

POST /<WHATSAPP_BUSINESS_ACCOUNT_ID>/message_templates

Path Parameters

Placeholder	Value
`<WHATSAPP_BUSINESS_ACCOUNT_ID>`	ID of the WhatsApp Business Account to create the template on.

Post Body

See Parameters for property descriptions.

{
  "allow_category_change": <ALLOW_CATEGORY_CHANGE>,
  "name": "<NAME>",
  "language": "<LANGUAGE>",
  "category": "<CATEGORY>",
  "components": [<COMPONENTS>]
}

Response

See Return Type.

Sample Request

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"
        }
      ]
    }
  ]
}'

Sample Response

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

Параметры

Параметр	Описание
`allow_category_change` boolean	Set to `true` to allow us to assign a category based on our template guidelines and the template's contents. This can prevent the template `status` from immediately being set to `REJECTED` upon creation due to miscategorization. If omitted, template will not be auto-assigned a category and its status may be set to `REJECTED` if determined to be miscategorized. See Template Categories.
`category` enum {UTILITY, MARKETING, AUTHENTICATION}	Template category. See Template Categories. Обязательно
`components` array<JSON object>	Array of components that make up the template. See Template Components. For types `HEADER`, `BODY`, `FOOTER`, `text` is required.
`type` enum {GREETING, HEADER, BODY, FOOTER, BUTTONS, CAROUSEL, LIMITED_TIME_OFFER}	Component type. Обязательно
`format` enum {TEXT, IMAGE, DOCUMENT, VIDEO, LOCATION}	Component format.
`text` string	Required for components with type `HEADER`,`BODY`, or `FOOTER`. Component text.
`buttons` array<JSON object>	Button components to be used in the template.
`type` enum {QUICK_REPLY, URL, PHONE_NUMBER, OTP, MPM, CATALOG, FLOW, VOICE_CALL, APP, POSTBACK}	Button type. Обязательно
`text` string	Button text.
`url` URI	url
`phone_number` phone number string	phone_number
`example` array<string>	example
`flow_id` int64	flow_id
`zero_tap_terms_accepted` boolean	zero_tap_terms_accepted
`flow_action` enum {NAVIGATE, DATA_EXCHANGE}	flow_action
`navigate_screen` string	navigate_screen
`supported_apps` array<JSON object>	supported_apps
`package_name` string	package_name Обязательно
`signature_hash` string	signature_hash Обязательно
`example` JSON object	Placeholder examples. Templates will not be approved without examples.
`header_text` array<string>	header_text
`body_text` array<array<string>>	body_text
`header_handle` array<string>	header_handle
`language` string	Template location and locale code. Обязательно
`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.
`add_contact_number` boolean	add_contact_number
`add_learn_more_link` boolean	add_learn_more_link
`add_security_recommendation` boolean	add_security_recommendation
`add_track_package_link` boolean	add_track_package_link
`code_expiration_minutes` int64	code_expiration_minutes
`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.
`type` enum {QUICK_REPLY, URL, PHONE_NUMBER, OTP, MPM, CATALOG, FLOW, VOICE_CALL, APP, POSTBACK}	type Обязательно
`phone_number` string	phone_number
`url` JSON object	url
`base_url` string	base_url Обязательно
`url_suffix_example` string	url_suffix_example
`otp_type` enum {COPY_CODE, ONE_TAP, ZERO_TAP}	otp_type
`zero_tap_terms_accepted` boolean	zero_tap_terms_accepted
`supported_apps` array<JSON object>	supported_apps
`package_name` string	package_name Обязательно
`signature_hash` string	signature_hash Обязательно
`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, we will retry the delivery for a period of time known as a time-to-live, TTL, or the message validity period. TTL can be configured for certain message types. See Time-To-Live.
`name` string	Template name. Обязательно
`parameter_format` enum {NAMED, POSITIONAL}	The parameter format of the template
`sub_category` enum {ORDER_DETAILS, ORDER_STATUS}	Sub category of the template

Тип возврата

Эта конечная точка поддерживает чтение после записи и будет считывать узел, в который вы сделали публикацию.

Struct {

id: numeric string,

status: enum,

category: enum,

}

Error Codes

Ошибка	Описание
100	Invalid parameter
192	Invalid phone number
131009	Parameter value is not valid
368	The action attempted has been deemed abusive or is otherwise disallowed
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.
200	Permissions error
139002	Publishing attempt failed
190	Invalid OAuth 2.0 Access Token

Обновление

Нельзя выполнить эту операцию в этой конечной точке.

Удаление

Вы можете отменить связывание a WhatsAppMessageTemplate и a WhatsAppBusinessAccount, отправив запрос DELETE на адрес /{whats_app_business_account_id}/message_templates.

Type	Description
Access Tokens	User or System User
Permissions	whatsapp_business_management

Request Syntax

DELETE /<WHATSAPP_BUSINESS_ACCOUNT_ID>/message_templates

Path Parameters

Placeholder	Value
`<WHATSAPP_BUSINESS_ACCOUNT_ID>`	ID of the WhatsApp Business Account that owns the template.

Response

See Return Type.

Sample Request

curl -X DELETE 'https://graph.facebook.com/v21.0/102290129340398/message_templates?name=order_confirmation' \
-H 'Authorization: Bearer EAAJB...'

Sample Response

{
  "success": true
}

Параметры

Параметр Описание

Параметр	Описание
`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. Обязательно

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.

Обязательно

Тип возврата

Struct {

success: bool,

}

Error Codes

Ошибка	Описание
100	Invalid parameter
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.
190	Invalid OAuth 2.0 Access Token

Платформа WhatsApp Business | Облачный API | Локальный API | API Business Management