WhatsApp Business 管理 API

範本轉移

本文件介紹如何在 WhatsApp Business 帳戶之間轉移範本。請注意，轉移時系統並不會移動範本，只是在目的地 WhatsApp Business 帳戶中重新建立有關範本。

限制

  • 範本只能在由同一個 Meta 商家擁有的 WhatsApp Business 帳戶之間轉移。
  • 只有狀態為 APPROVED 且 quality_score 為 GREEN 或 UNKNOWN 的範本才符合資格轉移。

要求語法

使用 WhatsApp Business 帳戶 > 轉移訊息範本端點來在 WhatsApp Business 帳戶之間轉移範本。

POST /<DESTINATION_WABA_ID>/migrate_message_templates
  ?source_waba_id=<SOURCE_WABA_ID>
  &page_number=<PAGE_NUMBER>

參數

預留位置說明範例值

<DESTINATION_WABA_ID>

WhatsApp Business 帳戶編號

此為必要項目。

目的地 WhatsApp Business 帳戶編號。

104996122399160

<SOURCE_WABA_ID>

WhatsApp Business 帳戶編號

此為必要項目。

來源 WhatsApp Business 帳戶編號。

102290129340398

<PAGE_NUMBER>

整數

此為選用項目。

指明要轉移的範本數量，以 2,500 個為一組。索引從零開始。例如，如要轉移 5,000 個範本，請同時傳送一個將此值設為 0 的要求，以及一個將此值設為 1 的要求。

0

回應

{
  "migrated_templates": [<MIGRATED_TEMPLATES>],
  "failed_templates": [<FAILED_TEMPLATES>]
}

回應屬性

預留位置說明範例值

<MIGRATED_TEMPLATES>

清單

在目的地 WhatsApp Business 帳戶中成功複製的範本編號之清單。

"1473688840035974","6162904357082268","6147830171896170"

<FAILED_TEMPLATES>

對應

用以確認哪些範本未能複製至目的地 WhatsApp Business 帳戶的對應。


鍵為範本編號，值為失敗原因。

"1019496902803242":"Incorrect category","259672276895259":"Formatting error - dangling parameter","572279198452421":"Incorrect category"

要求範例

curl -X POST 'https://graph.facebook.com/v20.0/104996122399160/migrate_message_templates?source_waba_id=102290129340398&page_number=0' \
-H 'Authorization: Bearer EAAJB...'

回應範例

{
  "migrated_templates": [
    "1473688840035974",
    "6162904357082268",
    "6147830171896170"
  ],
  "failed_templates": {
    "1019496902803242": "Incorrect category",
    "259672276895259": "Formatting error - dangling parameter",
    "572279198452421": "Incorrect category"
  }
}