Skip to main content
文档指南WhatsApp

WhatsApp 商业 API

将你的 WhatsApp 号码连接到 BeeCastly，即可与客户聊天、让 AI 替你回复并群发消息。你可以通过扫描二维码连接，也可以使用官方 Meta WhatsApp Cloud API。

先决条件

BeeCastly 帐户（免费套餐）
元商业帐户 (business.facebook.com)
使用 Cloud API 方式需要：一个 Meta Business 账号（business.facebook.com）和一个用于向 Meta 注册的电话号码

两种连接方式

扫描二维码

关联你正在使用的号码（包括 WhatsApp Business App 号码），就像 WhatsApp 网页版一样。免费，无需 Meta 审批。最适合用于回复和自动回复。请勿用于大规模群发：WhatsApp 可能会封禁该号码。

WhatsApp Cloud API (Meta)

Meta 提供的官方方式。需要 Meta Business 账号和已获批准的消息模板。群发和营销活动应使用这种方式。

设置指南

1在 BeeCastly 中连接 WhatsApp

前往 集成 → 渠道 → WhatsApp。
二维码：选择 WhatsApp QR。在手机上打开 WhatsApp → 已关联的设备 → 关联设备，然后扫描二维码。你的手机仍可正常使用。
Cloud API：选择 WhatsApp Cloud API (Meta)，然后点击 使用 Facebook 连接。选择你的 Meta Business 账号和电话号码。如果你想手动设置，分步向导会要求你填写 Meta App ID、WhatsApp Business Account ID、Phone Number ID 和访问令牌。

2创建消息模板

在 Cloud API 上，只有在客户最后一条消息后的 24 小时内，你才能发送自由文本。超出这个时间窗口，你就需要一个经 Meta 批准的模板。
前往 营销活动 → 模板，创建一个模板。
选择类别：Marketing、Utility 或 Authentication。
为姓名和其他信息添加变量，如 {{1}} 和 {{2}}。
提交。Meta 会进行审核，状态会在 BeeCastly 中更新。

3发送广播活动

转到广告系列 → 广播 → 创建。
选择 WhatsApp 作为渠道。
选择您批准的模板和受众（联系人、标签或细分）。
将模板变量映射到联系人字段（姓名、电话、自定义字段）。
预览消息，然后点击立即发送或安排。

4管理对话

收到的 WhatsApp 消息会出现在 消息 → WhatsApp（以及 全部消息）中。
在收件箱中回复，对常发的回答使用 快捷回复，并把聊天分配给团队成员。
开启 AI 回复，让你的聊天机器人依据知识库回答常见问题，并在需要时转交给真人。

5更多 WhatsApp 工具

消息 → Status Studio：发布 WhatsApp 状态。
消息 → wa.me 链接：为你的网站和海报生成点击即聊的链接或二维码。
集成 → 渠道 → WhatsApp：编辑你的商家资料和商品目录（Cloud API）。

最佳实践

维持高质量评级

避免垃圾邮件，保持较高的邮件质量评级。 如果用户阻止您或举报消息，Meta 可能会限制您的发送限制。

获得选择加入同意

在发送营销消息之前，请先获得明确的许可，例如通过表单、网站聊天或当面征得同意。

明智地使用人工智能自动回复

当你的知识库包含价格、营业时间和政策时，AI 回复的效果最好。请始终为客户保留联系真人的途径。

重要提示：24 小时窗口（Cloud API）

在 WhatsApp Cloud API 上，只有在客户最后一条消息后的 24 小时内才能发送自由文本。超出此窗口，你必须使用已获批准的模板。

API Examples

Send a WhatsApp message from your own software with an API key. See the Messages API for details.

bash
curl -X POST https://beecastly.com/api/v1/messages/send \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"channel":"WHATSAPP","to":"+919876543210","content":"Hello from BeeCastly!"}'
javascript·send-message.js
const response = await fetch('https://beecastly.com/api/v1/messages/send', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    channel: 'WHATSAPP',
    to: '+919876543210',
    content: 'Hello from BeeCastly!',
  }),
});

const data = await response.json(); // { success: true, data: { messageId, status: "queued" } }

Troubleshooting

Template not approved

If your template is rejected by Meta, check that it follows WhatsApp's guidelines: no promotional content in utility templates, proper formatting, and clear call-to-action buttons.

Messages not delivering

QR method: check that your phone is online and still shows BeeCastly under Linked devices. Cloud API: check that the customer has opted in and that your number's status is healthy in Meta Business Manager.

Rate limits

Meta limits how many people a new Cloud API number can message per day, and the limit grows as you send good-quality messages. Start with small broadcasts and schedule larger ones in Campaigns → Broadcasts.

Frequently Asked Questions

Can I use my WhatsApp Business App number?
Yes. With the QR method you link the number you already use, the same way WhatsApp Web works, and you keep using the app on your phone. For the Cloud API, you connect a number through Meta's sign-up steps.
Do I need Meta approval?
Not for the QR method. The Cloud API needs a Meta Business account, and Meta must approve your message templates before you can use them.
Which method should I use for broadcasts?
The Cloud API. Sending bulk messages over the QR method can get your number banned by WhatsApp, so use QR for replies and auto-replies to people who message you.
WhatsApp Guide - BeeCastly Documentation | BeeCastly