WhatsApp Business 管理 API

模板迁移

本文件说明如何在 WhatsApp Business 商业帐号 (WABA) 之间迁移模板。请注意，迁移操作不会移动模板，只是在目标 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 个。索引以 0 开始。例如，如要迁移 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"
  }
}