1. 首页
  2. 渠道集成
  3. 如何集成 WhatsApp API 账号

如何集成 WhatsApp API 账号

概述

Mixdesk支持快速集成YCloud、NxCloud、Chat App(阿里云)等Meta官方服务商。

通过以下步骤,可以快速集成 WhatsApp Business API (也叫做WhatsApp企业号、API账号),接入后你可以使用 Mixdesk 统一接收和回复 WhatsApp 用户的消息,通过商业账号高效管理与客户的 WhatsApp 通信,提升品牌影响力和客户服务质量。

接入步骤

WhatsApp Business API 通过 API 方式进行系统级访问,也常被称为 “WhatsApp API 账号”。企业可在其 Meta Business Manager(BM) 下创建一个或多个 WhatsApp Business Account(WABA),并绑定多个号码。
通过 API,企业可以实现批量发送消息、自动回复客户、或构建智能聊天机器人,实现大规模、高效的客户沟通。

WhatsApp API 账号需要通过Meta官方服务商进行申请认证,如 YCloud、牛信云、阿里云 Chat App。

WhatsApp 账号类型(官方解释):

一、集成 YCloud 商业API号码

1. 登录Ycloud 平台

① 请先注册 YCloud 后台,并根据 YCloud 侧提供的教程创建 WABA账号。

YCloud官网:https://www.ycloud.com/

② 如果你已经注册YCloud账号,可以直接登录后台:https://www.ycloud.com/console/#/entry/login

2. 创建WhatsApp business API账号

可参考帮助文档:https://helpdocs.ycloud.com/help-center/v/zh/whatsapp-accounts-zhang-hao-guan-li/chuang-jian-whatsapp-api-zhang-hao/tong-guo-qian-ru-shi-zhu-ce-chuang-jian-waba

⚠️在YCloud侧,完成注册和账号配置后,您将获得一个 API Key

3. 获取 API Key

① 在 Ycloud 平台中,点击左侧菜单中的「developer」选项,选择「API key」

② 复制生成的 API Key

3. 将API Key 填写到 Mixdesk 后台

① 登录/注册Mixdesk,进入工作台

② 在左侧导航栏中,点击【接入】,选择「WhatsApp」-「YCloud」,通过左上角「添加平台账号」接入渠道

③ 填入名称、API key,点击「确定」

⚠️名称仅用于内部管理区分使用,可以自定义。

在 YCloud 接入弹窗,填写【名称】和【API Key】,点击【确认】按钮,即可完成 YCloud 商业 API号码的接入。

二、集成 Chat APP 商业API号码

1. 登录阿里云后台

在阿里云服务后台完成注册登录,注册登录需要用企业号。

https://chatapp.console.aliyun.com/dychatapp/whatsapp/list

2. 点击 AccessKey 管理

登录服务后台,点击右上角头像,找到 AccessKey 管理

3. 同意使用 RAM 用户 AccessKey

勾选确认,并点击【使用 RAM 用户AccessKey

4.创建用户

点击【创建用户】-【填入用户账号信息】-【勾选”使用永久 AccessKey 访问”】,最后点击【确定】。

5. 获取 AccessKey ID 和 AccessKey Secret

点击复制,复制 AccessKey ID 和 AccessKey Secret,⚠️ 注意这里只展示一次,一定要复制了保存好。

6. 授权

点击【授权】-【新增授权】,搜索并选择刚刚新建的账号,下方权限搜索”chat”,勾选【只读管理】和【管理 ChatApp 权限】,最后点击【确定】。

7. 复制并填写回调地址

7.1 回调地址在 Mixdesk 复制

登录 Mixdesk 后台,点击【接入】-【WhatsApp API】,选择【Chat APP】,点击【添加平台账号】,将 Webhook 三种回调地址填入 ChatApp 对应的 WABA 账号下,⚠️注意回调地址的类型一一对应填写!

7.2 复制的回调地址填写在 Chat APP

① 再进入 Chat APP 消息服务界面(可在网页顶部搜索”Chat App消息服务”进入)

② 点击【通道管理】,在已经创建好的通道列点击【管理】,需要你提前绑定好 WABA 账号!

③ 在管理界面,点击【WABA管理】,⚠️注意根据 Webhook 类型填写之前在Mixdesk后台复制的链接

  • 点击【通道 Webhook设置】,这里是填写「通知回调地址」
  • 下方每个号码也需要【设置 Webhook 】,这里是填写「状态报告回调地址」和「消息上行回调地址」

8. 在 Mixdesk 后台填入 Key

以上步骤完成后,在 Mixdesk 后台,点击【接入】-【WhatsApp API】-【Chat APP】-【添加平台账号】,

  • 填写名称(方便内部管理区分,可随意填写)
  • 填写 Chat APP 平台的通道 ID(在通道管理页面复制)、AccessKey ID、AccessKey Secret
  • 最后点击【确定】,即可接入成功。

Chat APP 这里设置好 Webhook 后,如果马上接入到 Mixdesk,可能存在延迟,如果测试消息没有立即同步到 Mixdesk后台,可以稍等几分钟再测试。

接入成功后,你可以在 Mixdesk 后台,查看和启用 WABA 下面的号码,不启用号码消息就不会同步到 Mixdesk。

【同步数据】:如果在 Chat APP平台增加、修改或删除了号码,点同步数据即可更新最新数据。

【备注】:你可以给每个号码进行备注名称,以便在 Mixdesk 工作台快速区别不同的号码用途,提高工作效率。

【接触绑定】:WABA 下的号码将全部解绑,请谨慎操作哦。

三、接收WhatsApp API账号的对话

在服务商后台,每个 WABA 账号都可添加多个商业号码,在 Mixdesk 绑定成功后,商业号码的对话就会同步到 Mixdesk 工作台,你可以配置AI员工、自动化工作流等丰富的功能应用,在商业号码的回复。

在Mixdesk工作台,可以接收和回复WhatsApp API商业号码的用户消息,同时广告、用户信息都能详细查看。

以下截图就是用户通过Facebook主页的广告,点击进入商业号码的消息,系统配置了自动化回复和AI智能应答,引导用户开始了解产品并进行试用。

更多功能探索,可以查看其他帮助文档,或与您的商务顾问进行联系!

更新时间 2025年10月31日
这篇文章对您有帮助吗?

相关文档