# 接入WhatsApp Business应用用户-“共存”

使用现有的 WhatsApp Business 应用⁠账户和电话号码接入。成功接入后将能够使用您的账户向用户大规模发送消息，同时仍可通过 WhatsApp Business 应用一对一发送消息，且两个应用之间的消息记录保持同步。

## 一、绑定流程

### **1. 访问InnpPaaS 平台**

进入到Sender菜单，点击WhatsApp Business App

<figure><img src="https://2201452154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtZIe9DCfJsGdG2Apng7d%2Fuploads%2F4WodhWLo4t87oCIjCgbW%2Fimage.png?alt=media&#x26;token=25a40b3a-d7ad-4f24-8af8-0242b2593684" alt=""><figcaption></figcaption></figure>

### **2. 使用 FaceBook 账号登录**

登录授权页面，点击继续

<figure><img src="https://2201452154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtZIe9DCfJsGdG2Apng7d%2Fuploads%2F61Nrzyvctgfc0cJvFgL7%2Fimage.png?alt=media&#x26;token=e1705a53-8efd-459c-8066-4893b7bb1214" alt="" width="375"><figcaption></figcaption></figure>

### **3. 选择业务资产组合**

有可以选择创建资产组合

<figure><img src="https://2201452154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtZIe9DCfJsGdG2Apng7d%2Fuploads%2Fn15xC7KNh62zupUug2Kc%2Fimage.png?alt=media&#x26;token=3d3f0daa-ce65-41f1-a3fd-63486d818663" alt="" width="283"><figcaption></figcaption></figure>

### **4. 选择关联WhatsApp Business 应用**

<figure><img src="https://2201452154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtZIe9DCfJsGdG2Apng7d%2Fuploads%2FonjUbJPDXYeBicgNkuPV%2Fimage.png?alt=media&#x26;token=562cbebc-cc1d-4198-b996-d2d947df54f2" alt="" width="375"><figcaption></figcaption></figure>

### 5. 输入**WhatsApp Business**号码

输入号码，并点击【继续】

<figure><img src="https://2201452154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtZIe9DCfJsGdG2Apng7d%2Fuploads%2F80aWa3zYDTmzyk9TCLHK%2Fimage.png?alt=media&#x26;token=56856697-3ab3-4614-ae34-1873253a0ca9" alt="" width="375"><figcaption></figcaption></figure>

### 6. 显示二维码

此时需要打开手机，登录WhatsApp business App 扫描此码

<figure><img src="https://2201452154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtZIe9DCfJsGdG2Apng7d%2Fuploads%2FMqhftouRdEgdZAxOKq3D%2Fimage.png?alt=media&#x26;token=917b7279-93b8-4f17-aa66-1c0eaa417d6e" alt="" width="375"><figcaption></figcaption></figure>

### 7.  打开手机 **WhatsApp Business App**

1. 打开下面图标应用，打开应用右上角像机，扫描上面二维码
2. 等待弹出右侧界面后，点击手机 Connect to the Business Platform

<figure><img src="https://2201452154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtZIe9DCfJsGdG2Apng7d%2Fuploads%2FMjhEmfaHX9y5pODFoIqG%2Fimage.png?alt=media&#x26;token=7f05b6a1-e606-49f0-85f0-a58653323d9f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2201452154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtZIe9DCfJsGdG2Apng7d%2Fuploads%2Fr5s7nGV9zTtaQIMFdRYs%2Fimage.png?alt=media&#x26;token=00e0c5e4-65a6-4ad8-84fa-94a22df75a21" alt="" width="375"><figcaption></figcaption></figure>

### 8. 选择是否分享聊天记录

选择分享，系统会同步最近 180 天内发送或接收的所有消息。

* 群聊中的消息不会包含在内
* 媒体消息将不包含媒体素材编号；但是，将单独发送包含媒体消息素材编号的其他历史记录 Webhook，但仅限于接入后 14 天内发送的媒体消息
* 限时消息不包含

选择不分享，则不会同步聊天消息。

<figure><img src="https://2201452154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtZIe9DCfJsGdG2Apng7d%2Fuploads%2Fr6raIcPKWbd8Cl2W6Ebo%2Fimage.png?alt=media&#x26;token=2bdf45dc-c035-434a-aaa0-12c8e92a6adb" alt="" width="375"><figcaption></figcaption></figure>

### &#x20;9. 确认业务账号

再次扫描二维码，此时InnoPaaS平台会显示确认业务账号信息，如果时区为空，请选择你号码所在国家的【时区】（时区必选，负责将影响后续InnoPaaS平台授信，平台API将无法发送消息）

<figure><img src="https://2201452154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtZIe9DCfJsGdG2Apng7d%2Fuploads%2FLy9yDLQcK5EGkvsWIbuJ%2Fimage.png?alt=media&#x26;token=7794d7a9-3b3e-409a-b294-9d583debc981" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="https://2201452154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtZIe9DCfJsGdG2Apng7d%2Fuploads%2Fou0Uj13IzDjT3ShD3Crj%2Fimage.png?alt=media&#x26;token=e9c74b8b-ecd7-41c4-95ce-ab50d3037337" alt="" width="375"><figcaption></figcaption></figure>

### 10. 点击【确认】，等待Meta绑定账户

<figure><img src="https://2201452154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtZIe9DCfJsGdG2Apng7d%2Fuploads%2FAXeBk9kfC7f7Y5gABajt%2Fimage.png?alt=media&#x26;token=712ead17-b7a5-48b0-8805-a2c43c522125" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="https://2201452154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtZIe9DCfJsGdG2Apng7d%2Fuploads%2FdwH2mRiWBT3Bcyrtck66%2Fimage.png?alt=media&#x26;token=2ccc2efd-e787-4b01-819f-9cb0f334f5ab" alt="" width="375"><figcaption></figcaption></figure>

### **11. 点击【完成】，完成InnoPaaS 信息绑定**

点击完成按钮，完成最后 InnoPaaS 将授权号码与平台账号绑定。

<figure><img src="https://2201452154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtZIe9DCfJsGdG2Apng7d%2Fuploads%2Fb1zWFAnpnNYey7Pls6pF%2Fimage.png?alt=media&#x26;token=16965b40-67a1-4084-87d4-234372b2c21b" alt="" width="375"><figcaption></figcaption></figure>

同时手机也将显示绑定完成。

<figure><img src="https://2201452154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtZIe9DCfJsGdG2Apng7d%2Fuploads%2FG2w3e2bIPb33uuA6luBw%2Fimage.png?alt=media&#x26;token=3f4a0fba-1e79-445d-9ced-60356ef77a16" alt="" width="375"><figcaption></figcaption></figure>

## 二、要求与注意事项

### 要求

* 业务客户必须使用 2.24.17 或更高版本的 WhatsApp Business 应用。
* 必须支持业务客户的电话号码国家/地区代码
* 你必须知道如何使用[云端 API](https://developers.facebook.com/documentation/business-messaging/whatsapp/about-the-platform#whatsapp-cloud-api)
* 你必须使用带有[会话记录](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/implementation#session-logging-message-event-listener)的嵌入式注册

### 限制

* 为确保与 WhatsApp Business 应用兼容，同時用于 WhatsApp Business 应用和云端 API 的公司电话号码的吞吐量固定为 20 mps。
* 如果你的业务客户过去与某个合作伙伴合作，且仍在共享之前的额度，则他们在尝试切换到新的合作伙伴时可能会看到错误消息。按照[指南](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/support/business-customer-support)解决错误。

### 不支持的国家/地区

具有以下国家/地区的国家/地区代码的 WhatsApp Business 业务账户电话号码不受支持：

* 尼日利亚
* 南非

### 客户服务窗口期

[客户服务窗口期](https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/send-messages#customer-service-windows)只会在 WhatsApp 用户向已接入云端 API 的业务客户发送消息时开启。如果 WhatsApp 用户在商家接入云端 API 之前向商家发送消息，商家只能使用模板消息进行回复，因为此时还未开放客户服务。如果用户在商家接入云端 API 后向其发送消息，客户服务窗口将照常打开，然后商家可以使用非模板消息进行回复。

### 功能对比

下表介绍了已接入云端 API 的业务客户可用的功能，以及接入后 WhatsApp Business 应用功能的任何变化。

| WhatsApp Business 应用的现有功能                                                                                                                                                                                                                                                                                                                                                                                                            | 接入云端 API 后 WhatsApp Business 应用功能的变化 | WhatsApp Business 应用功能在云端 API 上是否受支持？                              |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------ | ------------------------------------------------------------------ |
| 个人（一对一）聊天                                                                                                                                                                                                                                                                                                                                                                                                                            | 不再支持消息编辑/撤回。                         | 支持。可同步最近 6 个月的所有聊天消息。发送和接收的消息会在云端 API 和 WhatsApp Business 应用之间被镜像。 |
| 联系人                                                                                                                                                                                                                                                                                                                                                                                                                                  | 无变化。                                 | 支持。可同步所有拥有 WhatsApp 电话号码的联系人。                                      |
| 群聊                                                                                                                                                                                                                                                                                                                                                                                                                                   | 无变化。                                 | 不支持。群聊不会同步。                                                        |
| 限时消息                                                                                                                                                                                                                                                                                                                                                                                                                                 | 所有个人（一对一）聊天的限时消息功能都将关闭               | 不支持。                                                               |
| [阅后即删消息](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F1077018839582332%3Ffbclid%3DIwZXh0bgNhZW0CMTAAYnJpZBExeU9aNUV1VU5ENm9uRXRjSXNydGMGYXBwX2lkEDIyMjAzOTE3ODgyMDA4OTIAAR5y-Uzo5ZkmVuFmJF05X-ZodJOFv5qy6Szzn7IuPSpGed9FSd0f1WVItrnnyw_aem_EFfXe3McKhvlgWwNiLWa0A\&h=AT3SVK_ARUEEoQN7fhu_3-2DHOesq1DQiALCsvV3nInsnbJ4hmIQz4iC4Ycg09YNp6gnUr3MErSA90GSzY-fV9qn-ZBIsoB3ERH3HNtcbdVYtSJXsPiZOJguWos3icU5R2ZCu7y2w4A) | 所有个人（一对一）聊天的阅后即删消息功能都将禁用             | 不支持。                                                               |
| 实时位置消息                                                                                                                                                                                                                                                                                                                                                                                                                               | 所有个人（一对一）聊天的实时位置消息功能都将禁用             | 不支持。                                                               |
| 群发列表                                                                                                                                                                                                                                                                                                                                                                                                                                 | 群发列表功能将停用。商家将无法创建新的群发列表。现有群发列表将变为只读。 | 不支持。                                                               |
| 语音和视频通话                                                                                                                                                                                                                                                                                                                                                                                                                              | 无变化。                                 | 不支持。                                                               |
| 业务工具（例如：目录、订单、状态）                                                                                                                                                                                                                                                                                                                                                                                                                    | 无变化。                                 | 不支持。                                                               |
| 消息工具（例如：营销消息、问候消息、离开消息、快速回复、标签）                                                                                                                                                                                                                                                                                                                                                                                                      | 无变化。                                 | 不支持。                                                               |
| 业务主页（例如：商家名称、地址、网站）                                                                                                                                                                                                                                                                                                                                                                                                                  | 无变化。                                 | 不支持。                                                               |
| 频道                                                                                                                                                                                                                                                                                                                                                                                                                                   | 无变化。                                 | 不支持。                                                               |

### 关联的设备

商家可将最多 4 个 WhatsApp“配套”客户端关联至其他设备上的 WhatsApp Business 应用账户（在我们的帮助中心中描述为“[已关联的设备](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F378279804439436%2F%3Ffbclid%3DIwZXh0bgNhZW0CMTAAYnJpZBExeU9aNUV1VU5ENm9uRXRjSXNydGMGYXBwX2lkEDIyMjAzOTE3ODgyMDA4OTIAAR4Uhro-TNkHNaTLVNiZQQ66w6J2MowNlR2xRMpU7QuavkPtoHORgDUBcvW9hQ_aem_0vJ3pXKy1b3nxzHOBMbMcA\&h=AT3SVK_ARUEEoQN7fhu_3-2DHOesq1DQiALCsvV3nInsnbJ4hmIQz4iC4Ycg09YNp6gnUr3MErSA90GSzY-fV9qn-ZBIsoB3ERH3HNtcbdVYtSJXsPiZOJguWos3icU5R2ZCu7y2w4A)”）。所有配套客户端均受支持，[Windows 版 WhatsApp](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F1317564962315842%2F%3Fcms_platform%3Dwindows-desktop%26fbclid%3DIwZXh0bgNhZW0CMTAAYnJpZBExeU9aNUV1VU5ENm9uRXRjSXNydGMGYXBwX2lkEDIyMjAzOTE3ODgyMDA4OTIAAR5pdklF2cUj6pt_ENI_lrGdS6eMFEBonex_yHlPOVjvetKyqW86ke2_ljNYaA_aem_4DNMDwMM14d-eVnVvFkScQ\&h=AT3SVK_ARUEEoQN7fhu_3-2DHOesq1DQiALCsvV3nInsnbJ4hmIQz4iC4Ycg09YNp6gnUr3MErSA90GSzY-fV9qn-ZBIsoB3ERH3HNtcbdVYtSJXsPiZOJguWos3icU5R2ZCu7y2w4A) 和 [WearOS 版 WhatsApp](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F564431798835071%2F%3Ffbclid%3DIwZXh0bgNhZW0CMTAAYnJpZBExeU9aNUV1VU5ENm9uRXRjSXNydGMGYXBwX2lkEDIyMjAzOTE3ODgyMDA4OTIAAR4TjR-GwoRI4X71vLMXP6LXNAasMXRG3aiTfGOd4mVlUuxWFAEqv0shSZer8Q_aem_FiL8OH-sE80hU4rRxY9Mag\&h=AT3SVK_ARUEEoQN7fhu_3-2DHOesq1DQiALCsvV3nInsnbJ4hmIQz4iC4Ycg09YNp6gnUr3MErSA90GSzY-fV9qn-ZBIsoB3ERH3HNtcbdVYtSJXsPiZOJguWos3icU5R2ZCu7y2w4A) 除外。如果业务客户使用现有的 WhatsApp Business 应用账户和电话号码接入云端 API，所有配套应用都将与该账户解除关联，之后该商家可以重新关联任何支持的配套应用。

### 未共享消息历史记录

如果商家选择不与你分享其消息历史记录，系统会触发包含错误代码 `2593109` 的 [history](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/manage-webhooks#history) Webhook。

### 报告转化活动

已接入的业务客户可以投放 WhatsApp 直达广告，因此我们建议你使用转化 API 代表商家报告购买/潜在客户开发信号。请参阅[业务消息的转化 API](https://developers.facebook.com/docs/marketing-api/conversions-api/business-messaging)。

### 业务客户退出

如果某个业务电话号码已在云端 API 和 WhatsApp Business 应用中使用，则无法使用 [POST /\<WHATSAPP\_BUSINESS\_PHONE\_NUMBER\_ID>/deregister](https://developers.facebook.com/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/phone-number-deregister-api#Updating) 端点从云端 API 注销该业务电话号码。取而代之，你的业务客户可以使用 WhatsApp Business 应用与云端 API 解除关联，方法是导航至设置 > 账户 > 商业平台，然后点击解绑账户按钮。当业务客户与云端 API 解除关联时，会触发一个带有 `PARTNER_REMOVED` 事件的 [account\_update](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/manage-webhooks#account-update) Webhook。

### 错误

如果你使用 WhatsApp Business 应用电话号码接入业务客户，之后可能会收到错误代码为 `131060` 的消息 Webhook。可能出现此情况的原因之一是 WhatsApp 用户使用不支持的[配套设备](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/manage-webhooks#linked-devices)向商家发送消息或接收商家发送的消息。如果你收到此 Webhook，请提示商家在 WhatsApp Business 应用中查看消息。

### 聊天记录内容

如果在解决方案提供方请求商家聊天记录时，商家已批准共享聊天记录，则会触发一系列历史记录 Webhook，其中描述自商家接入云端 API 后 180 天内发送或接收的所有消息。

* 群聊中的消息不会包含在内
* 媒体消息将不包含媒体素材编号；但是，将单独发送包含媒体消息素材编号的其他历史记录 Webhook，但仅限于接入后 14 天内发送的媒体消息