> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API 变更日志

> 2023 年 3 月至 2026 年 7 月期间 YCloud API 的历史发布、新增功能以及兼容性变更。

此归档保留了早期 API 文档中截至 2026 年 7 月 13 日的带日期条目。历史公告反映的是当时的设计约定；后续条目及当前的 API 参考文档具有更高优先级。

<Note>
  有关当前的计费信息，请参阅 [WhatsApp 定价](/zh/documentation/pricing-and-billing/whatsapp-pricing-and-billing)。
  [2025 年定价迁移](/zh/api-reference/getting-started/changelog/whatsapp-pricing-2025)
  已单独保留，用于解读较早的历史记录。
</Note>

## 2026-07-13

* 新增了 WABA 级别的自动素材优化（Automatic Creative Optimizations）查询 API：`GET /v2/whatsapp/businessAccounts/{wabaId}/automatic-creative-optimizations`。
* 新增了 WABA 级别的自动素材优化部分更新 API：`PATCH /v2/whatsapp/businessAccounts/{wabaId}/automatic-creative-optimizations`。

## 2026-07-07

### 更新

* 更新了 WhatsApp Business 用户名状态文档，针对已被 Meta 预留且可能仍在审核中的商业用户名请求，使用 `reserved`。
* 将 `pending_review` 标记为旧版兼容值。新的商业用户名写入操作请使用 `reserved`。

### 新增

* 在 WhatsApp Business 用户名状态枚举中新增了 `reserved`。
* 新增了将 `businessUsernameStatus` 设置为 `reserved` 的 `whatsapp.phone_number.business_username_updated` Webhook 示例。

## 2026-06-10

### 更新

* 回滚了先前于 2026-05-25 引入并记录的 WhatsApp 商业账户 `removed` 状态。
* 合作伙伴移除事件现在由 `whatsapp.business_account.deleted` Webhook 载荷表示，不再使用 `whatsapp.business_account.updated`。
* `removedReason`、`removedInitiatedBy` 和 `removedTime` 作为可选的移除元数据，保留在已删除的 WhatsApp 商业账户 Webhook 载荷中。

### 新增

* 在 `WhatsappBusinessAccountUpdateEventEnum` 中新增了 `PARTNER_APP_UNINSTALLED`。

## 2026-06-08

### 新增

* WhatsApp 电话号码对象新增字段：
  * `updateEvent`
* 在 `whatsapp.phone_number.quality_updated` Webhook 载荷中新增了 `updateEvent`，用于标识触发电话号码状态变更的账户更新事件，例如 `ACCOUNT_OFFBOARDED` 或 `ACCOUNT_RECONNECTED`。

## 2026-06-01

### 新增

* 新增用于查询、更新、删除及获取 WhatsApp Business 用户名建议的 API。
* WhatsApp 电话号码对象新增字段：
  * businessUsername
  * businessUsernameStatus
  * requestedBusinessUsername
  * businessUsernameUpdatedAt
* 新增 Webhook 事件类型：whatsapp.phone\_number.business\_username\_updated。

## 2026-05-25

* 在 `whatsapp.business_account.updated` Webhook 中支持 WhatsApp 商业账户合作伙伴移除（Partner Removed）更新。
  * 在 WhatsApp 商业账户 Webhook 载荷中新增了 `removed`、`removedReason`、`removedInitiatedBy` 和 `removedTime`。
  * 在 WhatsApp 商业账户 `updateEvent` 中新增了 `PARTNER_REMOVED`。
  * 记录了已知的合作伙伴移除原因：`ACCOUNT_DISCONNECTED`、`BUSINESS_DOWNGRADE`、`CHANGE_NUMBER`、`COMPANION_INACTIVITY`、`PRIMARY_INACTIVITY` 和 `USER_RE_REGISTERED`。
  * 记录了已知的合作伙伴移除发起方：`USER` 和 `SYSTEM`。

## 2026-05-19

<Note>
  历史公告：此条目不代表当前群组消息
  Webhook 的可用性。请参阅当前的 [群组指南](/zh/api-reference/guides/whatsapp-platform/manage-whatsapp-groups)
  以及已发布的 Webhook 目录，了解支持的操作和事件。
</Note>

* 支持 WhatsApp 群组 API。
* 支持 WhatsApp 群组邀请链接、加入请求、群成员以及设置等操作。
* 在 WhatsApp 模板组件参数中新增了 `group_id`。
* 新增了 WhatsApp 群组 Webhook 事件类型和 `whatsappGroup` 载荷。另请参阅 [Webhook 事件与载荷](/zh/api-reference/guides/examples/webhook-examples/webhook-payload-examples) 以及 [Webhook 载荷示例](/zh/api-reference/guides/examples/webhook-examples/webhook-payload-examples)。
* 在群组消息的 WhatsApp 入站消息载荷中新增了 `groupId`。

## 2025-05-08

<Note>
  原始变更日志中记录的日期为 2025-05-08。此处保留其在
  2026 年各条目间的位置，未对其推断或修改为其他发布日期。
</Note>

* 支持 WhatsApp [入站不支持消息（inbound-unsupported-message）](/zh/api-reference/guides/examples/webhook-examples/whatsapp-inbound-message-webhook-examples#inbound-unsupported-message)  `UNSUPPORTED_TYPE`

## 2026-04-29

* 在 WhatsApp 模板 `status` 中新增了 `ARCHIVED`。
* 在 WhatsApp 模板 `statusUpdateEvent` 中新增了 `ARCHIVED` 和 `UNARCHIVED`。
* 新增了 WhatsApp 模板归档与取消归档事件的 Webhook 示例。另请参阅 [WhatsApp 模板审核 Webhook 示例](/zh/api-reference/guides/examples/webhook-examples/whatsapp-template-reviewed-webhook-examples)。
* 在获取模板列表 (`GET /v2/whatsapp/templates`) 接口中新增了 `filter.status`，用于按状态筛选模板，包括 `ARCHIVED`。

## 2026-03-13

* 为支持 Meta 自 2026 年 3 月 31 日起推行的 BSUID，YCloud 更新了多个与消息收发及用户身份相关的 Webhook 载荷。请参阅 [BSUID 相关 Webhook 更新](/zh/api-reference/guides/whatsapp-platform/use-business-scoped-user-ids)

## 2026-03-04

* 支持 WhatsApp [带快速回复按钮的交互式媒体轮播消息](/zh/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#interactive-media-carousel-messages-with-quick-reply-buttons)

## 2026-01-28

* 支持 WhatsApp [创建 Gif 模板](/zh/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#marketing-template-with-gif)/[发送 Gif 模板消息](/zh/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#gif-template-message)

## 2025-12-15

* 支持 WhatsApp [深度链接模板](/zh/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#android-deep-link-template)

## 2025-12-03

* 支持 WhatsApp [交互式媒体轮播消息](/zh/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#interactive-media-carousel-messages)。
* 获取联系人 (`GET /v2/contact/contacts/{id}`) / 更新联系人 (`PATCH /v2/contact/contacts/{id}`) / 删除联系人 (`DELETE /v2/contact/contacts/{id}`) 接口支持电话号码。

## 2025-11-06

* 新增 Webhook 事件类型： **whatsapp.user.preferences**

## 2025-10-22

* 在获取退订者列表 (`GET /v2/unsubscribers`) 接口的响应中新增了 source 字段
* 在按客户获取所有退订者列表 (`GET /v2/unsubscribers/{customer}`) 接口的响应中新增了 source 字段
* 在获取单个退订者 (`GET /v2/unsubscribers/{customer}/{channel}`) 接口的响应中新增了 source 字段
* 新增 Webhook 事件类型： **contact.unsubscribe.created**、 **contact.unsubscribe.deleted** 。另请参阅：
  * [联系人退订创建 Webhook 示例](/zh/api-reference/guides/examples/webhook-examples/contact-unsubscribe-created-webhook-examples)
  * [联系人退订删除 Webhook 示例](/zh/api-reference/guides/examples/webhook-examples/contact-unsubscribe-deleted-webhook-examples)

## 2025-10-20

* 向多个端点添加了 `whatsappBusinessManagerMessagingLimit` 字段：
  * 列出 WABA (`GET /v2/whatsapp/businessAccounts`) 和获取单个 WABA (`GET /v2/whatsapp/businessAccounts/{id}`) 端点
  * 列出电话号码 (`GET /v2/whatsapp/phoneNumbers`) 和获取单个电话号码 (`GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}`) 端点
  * [whatsapp.phone\_number.quality\_updated](/zh/api-reference/guides/examples/webhook-examples/webhook-payload-examples) Webhook 有效负载

## 2025-10-10

* 在列出 WABA (`GET /v2/whatsapp/businessAccounts`) 端点和获取单个 WABA (`GET /v2/whatsapp/businessAccounts/{id}`) 端点的响应中添加了 `businessId`、`businessStatus` 和 `businessName`

## 2025-09-24

* 支持 [更新电话号码显示名称](/zh/api-reference/guides/whatsapp-platform/manage-whatsapp-phone-numbers) 端点
* 在列出电话号码 (`GET /v2/whatsapp/phoneNumbers`) 端点和获取单个电话号码 (`GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}`) 端点的响应中添加了 `newName`。
* 在获取电话号码资料 (`GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/profile`) 的响应中添加了 `verifiedName`、`nameStatus` 和 `newName`
* 在 [whatsapp.phone\_number.quality\_updated](/zh/api-reference/guides/examples/webhook-examples/webhook-payload-examples) Webhook 的有效负载中添加了 `whatsappBusinessManagerMessagingLimit` 字段

## 2025-09-01

* 新增对 WhatsApp Flow 端点重定向功能的支持
  * 在创建 Flow API (`POST /v2/whatsapp/flows`) 中添加 endpointUri 参数以指定 Flow 端点 URI
  * 在更新 Flow 元数据 API (`PATCH /v2/whatsapp/flows/{flowId}/metadata`) 中添加 endpointUri 参数用于端点配置
  * 在 Flow 详情 API (`GET /v2/whatsapp/flows/{flowId}`) 返回的结果中添加 endpointUrl 资源

## 2025-08-28

* 新增 WhatsApp Smb Webhook
  * [WhatsAppSmbAppStateSync-webhook-examples](/zh/api-reference/guides/examples/webhook-examples/webhook-payload-examples)

## 2025-08-20

* 新增 WhatsApp 通话 API
  * 发起 WhatsApp 外呼通话 (`POST /v2/whatsapp/calls/connect`)
  * 预接听 WhatsApp 呼入通话 (`POST /v2/whatsapp/calls/preAccept`)
  * 接听 WhatsApp 呼入通话 (`POST /v2/whatsapp/calls/accept`)
  * 终止 WhatsApp 通话 (`POST /v2/whatsapp/calls/terminate`)
  * 拒绝 WhatsApp 呼入通话 (`POST /v2/whatsapp/calls/reject`)
* 新增配置通话设置 API
  * 获取商业电话号码通话设置 (`GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/settings`)
  * 配置商业电话号码通话设置 (`POST /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/settings`)
* 新增 WhatsApp 通话 Webhook
  * [whatsapp-calling-connect-webhook-examples](/zh/api-reference/guides/examples/webhook-examples/whatsapp-calling-connect-webhook-examples)
  * [whatsapp-calling-status-update-webhook-examples](/zh/api-reference/guides/examples/webhook-examples/whatsapp-calling-status-update-webhook-examples)
  * [whatsapp-calling-terminate-webhook-examples](/zh/api-reference/guides/examples/webhook-examples/whatsapp-calling-terminate-webhook-examples)
* WhatsApp 通话使用指南：[whatsapp-calling-examples](/zh/api-reference/guides/whatsapp-platform/manage-whatsapp-calls)

## 2025-08-04

* 支持 WhatsApp Flow 预览 (`GET /v2/whatsapp/flows/{flowId}/preview`) 网页

## 2025-07-24

* 在创建模板 (`POST /v2/whatsapp/templates`) 中添加了新的 `supported_apps` 数组字段，用于在单个 OTP 模板（一键验证 / 零点击验证）中定义多个应用包名和签名密钥哈希（最多 5 个应用）。
  * 弃用了现有的 `package_name` 和 `signature_hash` 字段，改用新的 `supported_apps ` 数组结构

## 2025-07-10

* 支持列出联系人属性 (`GET /v2/contact/contacts/attributes`)，用于查询所有已定义的联系人属性。
* 新增 Webhook 事件类型：`contact.created`、`contact.deleted` 和 `contact.attributes_changed`。另请参阅：
  * [联系人创建 Webhook 示例](/zh/api-reference/guides/examples/webhook-examples/contact-created-webhook-examples)
  * [联系人删除 Webhook 示例](/zh/api-reference/guides/examples/webhook-examples/contact-deleted-webhook-examples)
  * [联系人属性变更 Webhook 示例](/zh/api-reference/guides/examples/webhook-examples/contact-attributes-changed-webhook-examples)
* 在以下 Webhook 端点 API 中添加了新属性 `eventProperties`：
  * 创建 Webhook 端点 (`POST /v2/webhookEndpoints`)
  * 更新 Webhook 端点 (`PATCH /v2/webhookEndpoints/{id}`)
  * 列出 Webhook 端点 (`GET /v2/webhookEndpoints`)
  * 获取单个 Webhook 端点 (`GET /v2/webhookEndpoints/{id}`)
* 向 Contact 对象添加了新字段，用于跟踪联系人来源信息：
  * `sourceType`：联系人来源类型枚举 (`WHATSAPP`、`GROWTH_TOOL`、`MANUALLY_ADDED`、`FILE_IMPORT`、`SHOPIFY`、`API`、`AD`、`POST`、`CALLING`、`SMB`、`UNKNOWN`)
  * `sourceId`：用于跟踪联系人创建来源的来源标识符
  * `sourceUrl`：创建联系人的来源 URL

## 2025-07-01

* 新增 WhatsApp Flow API (`POST /v2/whatsapp/flows`) 支持，包含以下端点：
  * 创建 Flow、列出 Flow、更新 Flow 元数据、更新 Flow 结构、删除 Flow、获取单个 Flow、发布 Flow、弃用 Flow

## 2024-10-10

* 支持 WhatsApp [订单详情消息](/zh/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#order-details-template-message)和[订单状态消息](/zh/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#order-status-template-message)。
* 新增 Webhook 事件类型 `whatsapp.payment.updated`。另请参阅 [WhatsApp 支付更新 Webhook 示例](/zh/api-reference/guides/examples/webhook-examples/whatsapp-payment-updated-webhook-examples)。

## 2024-09-12

* 支持 [WhatsApp Flows](https://developers.facebook.com/docs/whatsapp/flows)。另请参阅[Flow 模板](/zh/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#flow-template)、[Flow 模板消息](/zh/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#flow-template-message)、[交互式 Flow 消息](/zh/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#interactive-flow-message)以及[呼入交互式 Flow 响应消息](/zh/api-reference/guides/examples/webhook-examples/whatsapp-inbound-message-webhook-examples#inbound-interactive-flow-response-message)。

## 2024-08-22

* 新增 **自定义事件** API。请参阅发送事件 (`POST /v2/event/events`)。

## 2024-08-02

* 在 Contact 对象中添加了 `lastMessageToPhoneNumber`。请参阅获取联系人 (`GET /v2/contact/contacts/{id}`)。

## 2024-07-18

* 在入队 WhatsApp 消息 (`POST /v2/whatsapp/messages`) 端点中添加了 `filterBlocked`。如果设置为 `true`，我们将不会向您黑名单中的用户发送消息。

## 2024-05-24

* 自 2024 年 6 月 1 日起，WhatsApp 在印度尼西亚和印度推出新的身份验证国际费率。请参阅 [国际身份验证费率](https://developers.facebook.com/docs/whatsapp/pricing/authentication-international-rates)。
* 在 WhatsApp 消息对象中新增 `pricingCategory`。如果身份验证对话按国际身份验证费率计费，则 [whatsapp.message.updated](/zh/api-reference/guides/examples/webhook-examples/webhook-payload-examples) Webhook 的 `pricingCategory` 属性将被设置为 `authentication_international`。
* 在 WhatsApp 商业账户对象中新增了 `authIntlRateEligibilityCountries` 和 `primaryBusinessLocation`。订阅 [Authentication-International Rate Eligibility](/zh/api-reference/guides/examples/webhook-examples/whatsapp-business-account-updated-webhook-examples#authentication-international-rate-eligibility) 和 [Primary Business Location Update](/zh/api-reference/guides/examples/webhook-examples/whatsapp-business-account-updated-webhook-examples#primary-business-location-update) Webhook 即可接收通知。

## 2024-04-03

* 在 WhatsApp 消息对象中新增 `regionCode`。

## 2024-02-22

* 新增 WhatsApp 将消息标记为已读（`POST /v2/whatsapp/inboundMessages/{id}/markAsRead`）端点。

## 2024-01-30

* 支持 WhatsApp [交互式位置请求消息](/zh/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#interactive-location-request-message)。
* 支持 WhatsApp [入站请求欢迎消息](/zh/api-reference/guides/examples/webhook-examples/whatsapp-inbound-message-webhook-examples#inbound-request-welcome-message)。
* 若未设置身份验证模板消息的有效生存时间（TTL）（即 `messageSendTtlSeconds` 为 `-1`），则将其从 24 小时更改为 30 天。

## 2024-01-17

* 在发起验证（`POST /v2/verify/verifications`）端点中添加参数 `externalId`。

## 2024-01-05

* 新增注册电话号码（`POST /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/register`）端点。
* 向 WhatsApp 电话号码对象添加 `id`。
* 在 WhatsApp 商业账户对象中新增 `paymentMethodAttached`。

## 2023-12-21

* 添加 [退订者 (Unsubscribers)](/zh/api-reference/guides/customer-data-and-operations/manage-unsubscribers) 端点。

## 2023-12-13

* 在将 WhatsApp 消息加入队列（`POST /v2/whatsapp/messages`）接口中新增请求参数 `filterUnsubscribed`。如果设置为 `true`，则消息将不会发送给已退订您账户的用户。

## 2023-11-24

* 支持 WhatsApp [目录模板](/zh/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#catalog-template)和[目录模板消息](/zh/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#catalog-template-message)。
* 支持 WhatsApp [多商品消息模板（Multi-Product Message template）](/zh/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#multi-product-message-template)和 [MPM 模板消息](/zh/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#mpm-template-message)。
* 支持 WhatsApp [交互式目录消息](/zh/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#interactive-catalog-message)。
* 新增更新商业设置（`PATCH /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/whatsappCommerceSettings`）接口，用于为特定商业电话号码启用或禁用购物车或产品目录。

## 2023-11-02

* 支持 WhatsApp [零点击（Zero-Tap）身份验证模板](/zh/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#zero-tap-authentication-template)。
* 为身份验证模板添加消息有效时间（TTL）。对于新创建的身份验证模板，默认值为 600 秒。

## 2023-10-27

* 支持 WhatsApp [限时优惠模板](/zh/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#limited-time-offer-template)和[限时优惠模板消息](/zh/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#limited-time-offer-template-message)。
* 支持 WhatsApp [轮播模板](/zh/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#carousel-template)和[轮播模板消息](/zh/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#carousel-template-message)。

## 2023-10-18

* 支持 WhatsApp 交互式 CTA URL 按钮消息。另请参阅 [交互式 CTA URL 消息示例](/zh/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#interactive-cta-url-message)。

## 2023-10-12

* 新增 Webhook 事件类型 [whatsapp.business\_account.deleted](/zh/api-reference/guides/examples/webhook-examples/webhook-payload-examples) 和 [whatsapp.phone\_number.deleted](/zh/api-reference/guides/examples/webhook-examples/webhook-payload-examples)。
* 支持 WhatsApp [优惠券模板](https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates/coupon-templates)。更多示例请参见[优惠券模板](/zh/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#coupon-template)和[优惠券模板消息](/zh/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#coupon-template-message)。

## 2023-09-07

* 新增联系人 API `/v2/contact/contacts`。可用于创建、更新或删除联系人。

## 2023-07-05

* 在 WhatsApp Message 对象中添加了 `conversation.type`。如果存在，可能的值包括 `FREE_ENTRY`、`FREE_TIER` 和 `REGULAR`。
* 向 WhatsApp 电话号码对象添加 `isOfficialBusinessAccount`。

## 2023-06-01

* 在每个响应中添加速率限制标头。另请参阅 [Rate Limits](/zh/api-reference/guides/api-fundamentals/rate-limits)。

## 2023-05-26

* 新增 Webhook 事件类型 `whatsapp.template.quality_updated`，帮助您跟踪 WhatsApp [模板质量评级](https://developers.facebook.com/docs/whatsapp/message-templates/guidelines/#quality-rating)更新。请参阅 [Webhook 事件与载荷](/zh/api-reference/guides/examples/webhook-examples/webhook-payload-examples)。
* 向 WhatsApp 模板对象添加 `qualityRating`。

## 2023-05-16

* 新增 WhatsApp 消息发送 API `/v2/whatsapp/messages/sendDirectly`。有关错误处理，另请参阅[WhatsApp 错误](/zh/api-reference/guides/whatsapp-platform/handle-whatsapp-errors)。
* 新增 WhatsApp 模板删除 API `DELETE /v2/whatsapp/templates/{wabaId}/{name}/{language}`。
* 在响应体 `error` 对象中添加 `whatsappApiError`。
* 在 WhatsApp 电话号码对象中添加 `qualityUpdateEvent`。
* 在 WhatsApp 消息对象中新增 `sendTime`、`deliverTime` 和 `readTime`。
* 向 WhatsApp 电话号码 `messagingLimit` 添加新的枚举值 `TIER_NOT_SET`。

## 2023-03-24

* **WhatsApp 会话在首条消息状态变为**`delivered`\*\* 时计费，而不是 **`sent`**. 因此，WhatsApp 消息对象的 **`totalPrice`** 字段在消息送达前仅表示预估费用；当 **`status`** 为 **`delivered`** 或 **`read`** 时，该字段才表示最终费用。已发送但尚未送达的消息占用的余额，在这些消息被丢弃之前不可使用 (已发送但 30 天内未送达的消息会被丢弃).\*\* 在该会话首条消息状态变为 `delivered` 或 `read` 之前，`conversation.expireTime` 也只是预估的到期时间。
* 新增 Webhook 事件类型 `whatsapp.template.category_updated`，帮助您跟踪 WhatsApp 模板类别的变化。请参阅 [WhatsApp 模板类别更新载荷](/zh/api-reference/guides/examples/webhook-examples/webhook-payload-examples)。有关模板类别迁移的更多信息，请参阅 [首次模板类别迁移](https://developers.facebook.com/docs/whatsapp/updates-to-pricing/launch-timeline#first-template-category-migration)。
* 新增 WhatsApp 会话来源类型：`authentication`、`marketing`、`utility` 和 `service`。将于 2023 年 6 月 1 日切换到新的计费模式。另请参阅于 2023 年 6 月 1 日生效的 [新会话费率](https://developers.facebook.com/docs/whatsapp/updates-to-pricing/launch-timeline#new-conversation-rates)。
* 支持创建 [带有一次性密码按钮的身份验证模板](https://developers.facebook.com/docs/whatsapp/business-management-api/authentication-templates)。此功能将于 2023 年 5 月 1 日开放，并从 2023 年 5 月 29 日起强制使用。

## 2023-03-09

* 为每个请求新增响应标头 `YCloud-Request-ID`。请参阅 [请求 ID](/zh/api-reference/guides/api-fundamentals/handle-errors#request-correlation)。
* 在响应的 `error` 对象中新增 `requestId`。请参阅 [错误处理](/zh/api-reference/guides/api-fundamentals/handle-errors#request-correlation)。
* 新增 WhatsApp 模板类别：`AUTHENTICATION` 和 `UTILITY`。另请参阅 [计费变更上线时间表](https://developers.facebook.com/docs/whatsapp/updates-to-pricing/launch-timeline#new-template-categories)。

<br />


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.