从您自己的系统自动发送 WhatsApp 消息
要从您自己的系统自动发送 WhatsApp 消息,请调用 Meta 的 Cloud API:使用访问令牌向号码的 /messages 端点发送 POST 请求。若对方在过去 24 小时内未发来消息,消息必须是已获批准的消息模板;只有在客户最后一条消息后的 24 小时内,才能发送自由文本。对收到消息的回复可单独实现自动化。
easyCoexistence 通过 Coexistence 将您已在使用的 WhatsApp Business 号码连接到 Meta 的 Cloud API,并在控制台或通过 get_api_credentials 向您提供凭据,因此您的系统可以用该号码发送消息模板和回复,而 WhatsApp Business 应用仍留在手机上。
非模板消息只能在客户最后一条消息后的 24 小时内发出;此后只有消息模板能够送达。
同一号码同时在 WhatsApp Business 应用和 API 中使用时,Cloud API 的吞吐量是固定的。
在 Coexistence 号码上,通过 Cloud API 收发的消息会同步到 WhatsApp Business 应用。
新的 Business Portfolio 在滚动 24 小时内、客户服务窗口之外可触达的唯一用户数。
easyCoexistence 为号码提供的发送端点由三部分组成:Graph API 基础地址、phone number ID,再加上 /messages。
您的系统可以自行发送哪些消息?
分两类,由客户最后一次发消息的时间决定 Meta 接受哪一类。若系统要向今天尚未发过消息的人发送订单确认、预约提醒或付款收据,就需要已获批准的消息模板。若系统回复的是一小时前提出的问题,则可以发送纯文本。Meta 对其收费的消息,会按消息类别和国家或地区,逐条计入企业自己的 WhatsApp Business 账户,easyCoexistence 不加收任何费用。
| Approved template | Free-form message | |
|---|---|---|
| When it is allowed | Any time, to a person who opted in | Within 24 hours of the customer's last message |
| Review | Meta reviews it first, usually in minutes, up to about 24 hours | None |
| Typical use | Order shipped, appointment tomorrow, payment received | Answering a question, sending a link they asked for |
| Content | Fixed text with variables filled per person | Any text, media or interactive message |
从哪里获取发送所需的凭据?
可从 easyCoexistence 控制台中该号码的页面获取,也可通过您的 AI 获取。在“让此号码投入使用”下,“接入您自己的系统”卡片列出 API 基础地址、发送端点、WABA ID 和 Phone number ID,其中“显示访问令牌”可查看令牌,“显示 curl 示例”可生成现成的请求示例。请像对待密码一样保护令牌:任何持有者都能以您的企业身份发送消息。若卡片提示未颁发令牌,请在电脑上点击“重新连接以颁发令牌”;重新连接只会新增一个令牌。在 ChatGPT 或 Claude 中询问“我的号码的 API 凭据”,它会调用 get_api_credentials,返回相同的值。
curl -X POST "https://graph.facebook.com/<VERSION>/<PHONE_NUMBER_ID>/messages" \
-H "Authorization: Bearer <ACCESS_TOKEN>" \
-H "Content-Type: application/json" \
-d '{
"messaging_product": "whatsapp",
"to": "5511999998888",
"type": "template",
"template": {
"name": "order_shipped",
"language": { "code": "en_US" },
"components": [{
"type": "body",
"parameters": [
{ "type": "text", "text": "Ana" },
{ "type": "text", "text": "#1042" }
]
}]
}
}'您的 AI 能代替代码发送消息吗?
可以,适用于您现在决定发送的消息。在 ChatGPT 或 Claude 中使用 easyCoexistence 连接器,输入“把 order_shipped 模板发送到 5511999998888,称呼为 Ana,订单号 #1042”即可生成一次 send_template 调用;输入“告诉 Ana 蛋糕已经做好了”则会生成 send_message,且只能在她最后一条消息后的 24 小时内使用。每次调用只发送给一个人,ChatGPT 在运行会写入数据的工具前,可能会请您确认。这种方式适合一次性发送和检查。若某项任务需要自动运行,例如每个新订单都发送消息,则它不在助手内部运行:您的系统或 n8n 工作流可以直接调用 Cloud API,或将对方的号码 POST 到该号码上的 webhook 自动化,由它发送一个已批准的模板,并把订单详情作为变量填入。
哪些事件通常会触发自动发送的 WhatsApp 消息?
通常是您的业务软件中已经发生的事件,转化为一次模板发送。每种情况的模式相同:事件触发 Webhook 或工作流,工作流从记录中填入模板的变量,然后把消息提交到发送端点。这类消息模板通常属于 UTILITY 类别,只要不包含任何优惠内容即可:
- 店铺中的订单已付款或已发货:发送确认或物流跟踪信息,并附上订单号。
- 排期工具中新建了预约,或预约定于明天:发送日期、时间和地址。
- 账单系统中收到了付款,或付款已逾期:发送金额和一个链接。
- 网站上提交了表单,且勾选了 WhatsApp 同意接收选项:发送一条首条消息进行确认。
客户回复自动消息后会发生什么?
回复会像其他消息一样出现在 WhatsApp Business 应用中,并开启一个 24 小时窗口,在此期间可以回复任意文本。若号码设置为“通过 easyCoexistence”,回复还可以启动自动化:常见问题可用关键词自动回复,也可用带按钮的菜单、AI agent,或使用您自己密钥的“用 AI 回复”步骤,还可以使用“调用我的 Webhook”将消息交给您的系统。您还可以添加“转发 URL”,将原始消息和投递状态也接收到您的系统中,并按号码签名。若选择“直接发送到您的系统”,Meta 会把所有内容改为投递到您的端点,自动化则保持关闭。您的团队随时可以用手机回复,系统发出的消息也会出现在同一个聊天中。
系统发送消息时受哪些限制?
这些限制由 Meta 设定,适用于任何服务提供商。请围绕它们规划系统,而不是在失败的状态 Webhook 中才发现:
- 吞吐量:一个 Coexistence 号码每秒最多发送 20 条消息。
- 消息发送上限:滚动 24 小时内、客户服务窗口之外可触达的唯一用户数,按每个 Business Portfolio 设定;新的 Business Portfolio 从 250 起步。
- 付款方式:若 WhatsApp Business 账户未设置付款方式,Meta 会先接受消息模板,随后丢弃;一旦出现这种情况,easyCoexistence 会向您发送电子邮件。
- 质量:用户屏蔽和举报会降低号码的质量评级,评级过低会导致 Meta 限制该账户。
设置方法
- Connect the numberConnect your WhatsApp Business number to easyCoexistence through Meta's Coexistence flow; the app keeps working on the phone.
- Get a template approvedAsk your AI to create a UTILITY template such as order_shipped with create_template, or make it in WhatsApp Manager, and wait until its status is APPROVED.
- Copy the credentialsOpen the number in the dashboard, go to "Plug in your own system", copy the Send endpoint and click "Reveal access token".
- Send from your systemHave your store, CRM or n8n workflow POST the template to the Send endpoint when the event happens, with the variables filled from the record.
- Receive replies and statusesUnder "Where incoming messages go", choose "Through easyCoexistence" with a Forward URL, or "Straight to your system" with your endpoint as the destination, so replies and delivery statuses reach your system.
常见错误
- 向两天前才最后发来消息的人发送自由文本。Meta 会以错误代码 131047 拒绝,请改为发送已获批准的消息模板,待对方回复后再切换为文本。
- 将访问令牌放在网页、应用包或共享电子表格中。任何能看到它的人都能以您的企业身份发送消息;请将它保存在服务器上。
- 把 API 响应中的消息 ID 误认为已送达。Meta 会先接受发送请求,之后却可能失败,因此请留意状态 Webhook 中的 failed 状态及其错误代码。
- 在紧密循环中反复重试失败的发送。单用户限制或营销已停止的错误不会在几秒内清除,重试只会增加错误。
自动化会回复客户的来信,每个号码都全天候 24/7 监控;当 Meta 停止投递消息模板时,会向您发送电子邮件。每个号码每月 US$ 9 起,号码越多越便宜,最低降至 US$ 0.75,并提供 3 天免费试用。
常见问题
我的系统发送的消息会显示在我的 WhatsApp Business 应用中吗?
会。在 Coexistence 号码上,Meta 会在 Cloud API 和应用之间同步消息,因此您的系统发送的消息模板会出现在手机上该客户的聊天中,对方的回复也会在那里显示。您可以在应用中继续对话。
我的系统能自动发送图片或 PDF 吗?
可以,通过同一个端点即可:在客户最后一条消息后的 24 小时内发送媒体消息,或随时发送页眉含图片或文档的消息模板。自动化的“发送图片或文件”步骤也可以在同样的 24 小时内发送您的图片或 PDF,AI agent 也可以自行发送。
我是通过 easyCoexistence 的 API 发送,还是通过 Meta 发送?
通过 Meta。您的系统使用号码自己的访问令牌直接调用 Graph API,因此 easyCoexistence 不转发或存储您发送的消息,也不对 Meta 收取的费用加价。
无代码工具或电子表格能发送 WhatsApp 消息吗?
可以,只要它能发起 HTTP POST 请求即可:n8n、Make、Zapier 以及带 Apps Script 的 Google Sheets 都可以。将其指向发送端点,在 Authorization 标头中传递访问令牌,并发送已获批准的消息模板,每次请求只发给一位收件人。
继续阅读
准备开始了吗?
几分钟即可设置 WhatsApp Coexistence,而不是几个月。应用会继续在手机上运行。
开始免费试用验证时间