一键接入官方 WhatsApp 商业号(WABA)图文教程

FCT CRM 是 Meta 认证的 Tech Provider,可以用「一键接入(Embedded Signup)」的方式, 帮你几分钟内把一个官方 WhatsApp Business Platform(WABA) 号接进 App —— 不用自己 从零走 Meta 的开发者流程。

开始前必须知道:QR 号和 WABA 号互斥

一个手机号只能是 WhatsApp 二维码(QR)扫码号,或者 官方 WABA 号,不能同时是两者。 千万不要拿现有的、正在用的 QR 扫码号去转 WABA —— 硬转会让那个号在 WhatsApp 里"假死"。 接入 WABA 必须用一个全新的手机号。

例外:号码已经在手机的 WhatsApp Business App 上用了? 可以用「保留手机 App,一起接入」 (Coexistence),不用换新号,手机照常用。见下方 已经在手机用 WhatsApp Business App 的号码。

开始前准备

1. 一个全新手机号 —— 从没在 WhatsApp / WhatsApp Business App 里注册、登录过,真实 SIM 卡 (能收短信或语音验证码;虚拟号/VoIP 号 Meta 经常拒)。如果这个号以前注册过 WhatsApp, 先在手机 App 里删除那个账号、等几分钟再用。
2. 一个 Facebook 账号 —— 建议用你常用的、老的 personal 账号登录做接入(老号不容易被 Meta 风控标记;临时小号反而容易被拦)。
3. 企业基本资料 —— 公司名称、地址(国家)、网站、行业类别。
4. 一个企业显示名(Display name) —— 客户会看到的 WhatsApp 商业号名字,Meta 会审核, 要跟真实业务相关(参考下方注意事项)。
5. 一张信用卡 —— 用来绑定 Meta 的 WhatsApp 对话计费,这笔钱由 Meta 直接跟你收, 跟我们的软件订阅费是分开的两笔账。可以现在加,也可以接入完成后再补。

图文步骤

1. 在 FCT CRM 打开一键接入入口

在 设备 页点击右上角 ☁️ 官方一键接入 WABA,弹窗会给你一个「打开官方授权页」的按钮, 点击后浏览器会打开 Meta 的官方接入页面。App 这边会一直等着:你在 Meta 那边走完流程后,它会自动接入。

2. Meta 弹窗:确认连接

浏览器打开后,Meta 会先弹出确认框,说明这个接入流程能做什么。点 Continue 继续。

点之前先看一眼弹窗右上角的头像,确认现在登录的是你打算用来做接入的那个 Facebook 账号。不想继续就点 Cancel。

3. 选择要共享的业务资产(Business assets)

接下来选择 Business portfolio(业务组合)—— 如果你已经有现成的、有完整控制权的 Business portfolio,可以直接选;没有的话,建议直接新建一个干净的,避免跟其它业务混在一起。

1. 点 Business portfolio 下面的下拉框,列表会展开。
2. 要新建,就选最上面的 Create a Business portfolio;要用现成的,就点它前面的圆圈。
3. 变成灰色、下面写着 "You need full control of this business portfolio" 的那些选不了,不用理会。

选好后,画面变成「新建 Business portfolio」+「新建 WhatsApp Business account」两项都是 Create...,点击 Next。

4. 填写企业资料

填 Name(公司名)、Email、Category(行业类别)、Country(国家,选 Malaysia)、 Website(网站)、Time zone(时区)。

从上到下一栏一栏填。Category 和 Country 是下拉框,点开后选;表格比窗口长,要往下滚才看得到后面几栏。截图里还没填完,右下角的 Next 是浅色的。

行业类别要如实选,避开敏感类别

下拉列表里有 Alcoholic Beverages(酒类)、Finance and Banking(金融)、 Government(政府)、Medical and Health(医疗)、Online / Non-Online Gambling & Gaming(博彩) 等敏感类别。除非你的业务真的属于这些类别,否则不要选 —— 这类账号 更容易被 Meta 拒绝或限流。

点开 Choose a business category 后,列表很长,第一屏先看到 Automotive、Beauty, Spa and Salon、Education 这些。点类别前面的圆圈就是选中。

在列表里继续往下滚,会经过 Finance and Banking、Alcoholic Beverages、Government、Medical and Health 这几个敏感类别,不属于就直接跳过。

滚到最后,是 Professional Services、Shopping and Retail、Travel and Transportation、Restaurant 这些常见类别。选最贴近你生意的一个;都不合适,就选最下面的 Other。

reCAPTCHA 容易过期

勾选 "I'm not a robot" 之后如果隔了一会儿才点 Next,可能会看到 "Verification expired. Check the checkbox again."(验证过期)—— 这不是 bug, 重新勾一次「I'm not a robot」再点 Next 就行。

5. 添加全新手机号 + 设置显示名

填入准备好的全新手机号(注意区号,马来西亚选 MY +60),以及 WhatsApp Business display name(客户看到的商业号名字),选择用短信还是语音接收验证码。

1. 在 Phone number 左边的下拉里选好区号,右边填手机号。
2. 在 WhatsApp Business display name 里填客户会看到的名字。
3. 在下面选 Text message(短信)或 Phone call(语音电话)来接收验证码,然后点 Next。

收到验证码后,输入 6 位数字完成验证。

把收到的 6 位数字逐格填进 Verification code,再点 Next。页面上有一行倒计时,写着时间到了以后可以重新获取验证码、也可以换一种接收方式。号码填错了,点蓝色的 enter a different number 回去改。

6. 确认授权范围

Meta 会列出 FCT CRM 将获得的权限(管理 WhatsApp 账号、收发对话、代发送事件给 Meta 等), 确认无误后点 Confirm。

确认前核对一下:Business 和 WhatsApp Business account 下面显示的,应该是你刚才填的公司名。不对就点 Back 回去改。

系统会显示「Connecting your account...」,等几秒即可。

7. 接入成功,资产已创建

看到 "Your account is connected to Feibe Creation Trading",说明 Business 和 WhatsApp Account 两个资产都建好了。底部两个「Improve your experience」勾选项(开启 insights / 自动上报 order-lead 事件)可以按需取消。这里可以先点 Add payment method 现在就绑卡,也可以先点 Finish、以后再去 Meta Business 后台补卡 —— 不影响接入本身。

8.(可选)现在就绑定信用卡

如果上一步选了「Add payment method」,会进入 Meta Business 的 Billing & payments 页面。

在这一页中间的 Payment methods 一栏,点右边的 Add payment method,开始添加付款资料。

先选国家和币种(马来西亚 / Malaysian Ringgit)—— 注意一旦设定以后不能改。

在 Country/region 选国家,在 Currency 选币种,下面一栏是时区。窗口里有一行小字提醒:地区和币种一旦设定就不能再改。确认无误再点 Next。

确认地区币种后,选择付款方式(Debit or credit card)。

这里最上面会显示你刚才选的地区和币种。确认 Debit or credit card 右边的圆点已经选中,再点 Next。

填入卡号、有效期、CVV,点 Save 完成绑卡。

四栏依次是:Name on card(卡上的姓名)、Card number(卡号)、MM/YY(有效期的月和年)、CVV(安全码)。全部填好后点右下角的 Save。

9. 回到 FCT CRM —— 自动接入,或手动输入接入码

完成 Meta 那边的流程后,浏览器会回到 FCT CRM 自己的授权页面 —— 这个页面会显示 一个 8 位接入码(有效期 15 分钟),把它记下来或直接复制。

回到 FCT CRM 客户端,授权完成后一般会自动接入,不用再做什么。如果没有自动接入, 在「官方一键接入 WABA」弹窗里把接入码粘贴进输入框,点击 接入。

1. 回到 FCT CRM,「官方一键接入 WABA」的弹窗应该还开着。如果已经关掉,在「设备」页再点一次「官方一键接入 WABA」。
2. 把 8 位接入码填进弹窗下方的输入框。
3. 点绿色的「接入」。成功后会提示「接入成功,账号已创建」。
4. 接入码已经超过 15 分钟的话,点「打开官方授权页」重新走一次。

10. 完成!WABA 号出现在设备列表

接入成功后,设备列表会多出一个 WABA 账号,状态显示 已连接,并带有 「🔒 官方号」 的标记(WABA 号跟普通 QR 号在权限上是分开管理的)。

已经在手机用 WhatsApp Business App 的号码(Coexistence)

如果这个号码已经在手机的 WhatsApp Business App 里用着,不用换新号:选「保留手机 App,一起接入」, 同一个号码手机 App 照常用,FCT CRM 同时自动回复。

接入后会怎样

	手机 WhatsApp Business App	FCT CRM
收消息	照常收	同样收到,照常自动回复 / 工作流
发消息	老板手机上发的免费,不受 24 小时限制	自动发的照 WABA 规则(24 小时窗口外要用模板,Meta 收费)。老板手机上发的也会显示在 CSW 里
联系人	不变	手机通讯录会同步进来(CRM 里已有的名字不覆盖)
聊天记录	不变	最近 180 天 的一对一聊天会同步进来(只是记录,不会对旧消息自动回复)

开始前准备

1. 号码已经在 WhatsApp Business App(不是普通 WhatsApp)里真实使用至少 7 天(越久越稳,刚注册的号会被 Meta 拒)。
2. 手机 App 更新到 2.24.17 或以上。
3. 这个号码没有接在别家平台(别的 CRM / API 服务商)。接过的话先在手机上断开(方法见下方「怎样停用」)。
4. 一个能管理你 Business portfolio 的 Facebook 账号。
5. 手机放在旁边,接入过程中要用手机扫码。

同一个号码不要再在 FCT CRM 用 QR 扫码接入

Coexistence 号已经通过官方接口接进 FCT CRM 了,不要再用「扫码登录」把同一个号码加成 QR 号。 接入时 Meta 会断开手机 App 原有的「已连接设备」,之后可以重新连接 WhatsApp Web / Mac 版; Windows 版 WhatsApp 不支持,在 Windows 版里发的消息不会出现在 FCT CRM。

图文步骤

1. 在 FCT CRM 设备 页点 ☁️ 官方一键接入 WABA → 打开官方授权页。
2. 在授权页点下面的 「保留手机 App,一起接入」(不是上面绿色那个按钮)。
3. Meta 弹窗:确认登录的 Facebook 账号,点 Continue / Get started。
4. 选择 Business portfolio,点 Next。
5. 选 Connect your existing WhatsApp Business App,点 Next。
6. 输入手机 WhatsApp Business App 上的那个号码,点 Next。电脑上会出现一个 QR 码,不要关这个画面。
7. 拿起手机,打开 WhatsApp Business App,扫电脑上的 QR 码。
8. 手机上会收到 Facebook 发来的消息,点 Connect,再点 Continue on Business Platform。
9. 选择分享聊天记录:选 Share all chats(分享全部聊天)并确认。这个选项以后改不了, 选了不分享,FCT CRM 就看不到以前的聊天。
10. 回到电脑,确认企业名称和时区,点 Next → 确认权限 → Finish。
11. 授权页会显示「接入成功」和接入码,FCT CRM 一般会自动接入(没有的话,把接入码粘贴进 App)。
12. 设备列表出现新的 WABA 账号,带绿色 「📱 手机同时在用」 标记,就完成了。

同步要几分钟到几小时,手机 App 保持打开

联系人和聊天记录是接入后才开始同步的。手机保持解锁、WhatsApp Business App 开着、网络稳定, 记录多的号可能要几个小时。同步期间新消息照常收发,不受影响。

一定要记住:每 14 天至少打开一次手机 App

手机上的 WhatsApp Business App 大约 14 天没打开,Meta 会自动断开和 FCT CRM 的连接 (号码不会被封,手机照常能用,只是 FCT CRM 收不到消息)。断开时账号卡片会出现红字 「已和手机 App 断开」。处理方法:在手机上打开 WhatsApp Business,然后在 FCT CRM 重新走一次 上面的接入步骤。

不能用的功能

Meta 的 Coexistence 文档列出接入后不支持的功能:群发列表(Broadcast lists,原有的变只读、不能新建)、 自动问候 / 离开消息、快速回复、标签、商品目录 / 订单、限时消息、阅后即焚、实时位置、语音 / 视频通话。 群组聊天不会进 FCT CRM,只有一对一聊天。这些在 FCT CRM 里大多有替代(群发、自动回复、工作流等)。

怎样停用 / 换回只用手机

停用必须在手机上操作(在 FCT CRM 删除账号只会让 FCT CRM 不再收消息,号码仍算连接着):

1. 打开手机的 WhatsApp Business App。
2. 进入 设置(Settings) → 账号(Account) → Business Platform (有的版本叫 Connected platform / 已连接的平台)。
3. 点当前连接的平台(FCT CRM 接入用的 Meta 应用),看完说明点 Next,再点 Disconnect(断开)。
4. 回到 FCT CRM,在设备页把这个 WABA 账号删除。

断开后:号码和手机上的聊天、联系人都保留,手机 App 照常用,变回普通的 WhatsApp Business App。 FCT CRM 里已经同步的聊天记录也会留在电脑上。

不要用删除 App / 重装来「断开」

不要卸载或删除手机上的 WhatsApp Business 账号来解决问题 —— 那样会清掉号码的使用记录, 之后可能要再用几个星期才能重新接入。断开请用上面的「设置 → 账号 → Business Platform」。

重要提醒

QR 号和 WABA 号互斥

再强调一次:一个手机号只能是 QR 扫码号或 WABA 号,不能两者都是。千万别拿现有正在用的 QR 号去转 WABA,会导致那个号在 WhatsApp 里假死。接入 WABA 请务必用一个全新手机号。

新建的 Business 还需要「企业认证」才能大量发送

刚接入时,Meta 会提示"Before you can begin messaging, ... will need to verify your business"。未认证的 WABA 也能直接用,但每 24 小时只能主动发起 250 个新客户 的对话 (这不是回复数 —— 客户先发给你、你在 24 小时窗口内回复不占这个额度,可以无限回)。 如果要提高额度、加更多号、拿绿标认证,需要另外走 Business Verification (在 business.facebook.com → Settings → Business info / Security Center 里提交企业文件)。 认证通过、发送质量好之后,额度会自动阶梯式上升:250 → 1,000 → 10,000 → 100,000 → 无限。

24 小时客服窗口

只有在客户 24 小时内主动联系过你 的情况下,才能自由发送任意内容的消息回复。 超过 24 小时窗口后再联系客户,必须使用 Meta 审核通过的消息模板(template), 不能随意发普通文本。

对话费用由 Meta 直接收取

WhatsApp 官方号的对话费用是 Meta 按条直接向你收取(绑定在上面的信用卡上), 跟 FCT CRM 的软件订阅费是完全分开的两笔账,我们不会代收这笔钱。

常见问题 / 排错

账号上出现红字「WABA 授权已过期」怎么办?

这表示 Meta 不再接受这个号的授权,所以发不出也收不到。按提示重新走一次 WABA 接入(选同一个号码)即可, 号码和聊天记录都会保留,接好后红字会自己消失。

账号上出现红字「已和手机 App 断开」怎么办?(Coexistence 号)

通常是手机上的 WhatsApp Business App 大约 14 天没打开,Meta 自动断开了。号码没事,手机照常用。 在手机上打开 WhatsApp Business,再在 FCT CRM 重新走一次 Coexistence 接入 即可。 注意:重新接入后,以前的聊天记录不会再同步一次(Meta 每次接入只同步一次),但之前已经同步进 FCT CRM 的记录都还在。

Coexistence 接入时提示 "Your phone number isn't eligible..." 怎么办?

号码在 WhatsApp Business App 上用的时间还不够(至少 7 天,建议一个月以上)。继续正常使用一段时间再试, 不要删除重新注册,那样会从头算。

提示 "This feature isn't available for phone numbers from this region" 怎么办?

这个国家 / 地区的号码 Meta 还没开放 Coexistence,只能用全新号码走普通接入。

提示 "This account is shared with another partner" 或号码已接在别家平台?

先在手机 设置 → 账号 → Business Platform 断开原来的平台,再重新接入。

账号上出现黄字「聊天记录没有同步成功」?

接入时在手机上选了不分享聊天记录,或同步超时。不影响新消息,只是以前的聊天看不到。 想要以前的记录,只能在手机上断开后重新接入,并选 Share all chats。

提示「WABA 名额已用完」怎么办?

每个授权能接入的 WABA 号数量是固定的。要接新号,请先购买 WABA 名额,或先删除一个现有的 WABA 号。 名额在 设置 页的 加购额外 WABA 官方号 购买,在 我的 WABA 官方号 查看;每个号各自到期, 过期只停发,数据保留,续费即恢复。名额从付款那一刻开始算有效期,准备好接入时再买。

提示「这个月更换 WABA 号的次数已到上限」怎么办?

30 天内接入的不同号码太多了。请下个月再试,或购买更多 WABA 名额。

弹窗显示 "... can't onboard customers right now"(无法立即为你开通)怎么办?

这通常是当时 Meta 那边的账号安全验证卡了一下(比如顶部出现过 "Verify that it's you" 之类的提示),导致服务方开通状态暂时没有生效,并不代表你的资料填错了。

• 先刷新页面,或者退出重新登录 Facebook 账号后再试一次。
• 确认下面几项都是"绿色/已完成"状态(一般不需要你自己操作,如果长期不通知我们): App 已经是 Live 状态、Business 已经 Verified、WhatsApp 相关权限已经是 Advanced Access。
• 如果反复出现,先别选「Yes, share my contact information」,把 Session ID 记下来, 联系我们协助排查(这是接入服务方那侧的开通状态问题,不是你号码或资料的问题)。