登录开始免费试用
Meta Tech Provider

从您自己的系统自动发送 WhatsApp 消息

要从您自己的系统自动发送 WhatsApp 消息,请调用 Meta 的 Cloud API:使用访问令牌向号码的 /messages 端点发送 POST 请求。若对方在过去 24 小时内未发来消息,消息必须是已获批准的消息模板;只有在客户最后一条消息后的 24 小时内,才能发送自由文本。对收到消息的回复可单独实现自动化。

easyCoexistence 通过 Coexistence 将您已在使用的 WhatsApp Business 号码连接到 Meta 的 Cloud API,并在控制台或通过 get_api_credentials 向您提供凭据,因此您的系统可以用该号码发送消息模板和回复,而 WhatsApp Business 应用仍留在手机上。

24 hours

非模板消息只能在客户最后一条消息后的 24 小时内发出;此后只有消息模板能够送达。

20 msg/s

同一号码同时在 WhatsApp Business 应用和 API 中使用时,Cloud API 的吞吐量是固定的。

Mirrored

在 Coexistence 号码上,通过 Cloud API 收发的消息会同步到 WhatsApp Business 应用。

250

新的 Business Portfolio 在滚动 24 小时内、客户服务窗口之外可触达的唯一用户数。

/messages

easyCoexistence 为号码提供的发送端点由三部分组成:Graph API 基础地址、phone number ID,再加上 /messages。

您的系统可以自行发送哪些消息?

分两类,由客户最后一次发消息的时间决定 Meta 接受哪一类。若系统要向今天尚未发过消息的人发送订单确认、预约提醒或付款收据,就需要已获批准的消息模板。若系统回复的是一小时前提出的问题,则可以发送纯文本。Meta 对其收费的消息,会按消息类别和国家或地区,逐条计入企业自己的 WhatsApp Business 账户,easyCoexistence 不加收任何费用。

Approved templateFree-form message
When it is allowedAny time, to a person who opted inWithin 24 hours of the customer's last message
ReviewMeta reviews it first, usually in minutes, up to about 24 hoursNone
Typical useOrder shipped, appointment tomorrow, payment receivedAnswering a question, sending a link they asked for
ContentFixed text with variables filled per personAny text, media or interactive message

从哪里获取发送所需的凭据?

可从 easyCoexistence 控制台中该号码的页面获取,也可通过您的 AI 获取。在“让此号码投入使用”下,“接入您自己的系统”卡片列出 API 基础地址、发送端点、WABA ID 和 Phone number ID,其中“显示访问令牌”可查看令牌,“显示 curl 示例”可生成现成的请求示例。请像对待密码一样保护令牌:任何持有者都能以您的企业身份发送消息。若卡片提示未颁发令牌,请在电脑上点击“重新连接以颁发令牌”;重新连接只会新增一个令牌。在 ChatGPT 或 Claude 中询问“我的号码的 API 凭据”,它会调用 get_api_credentials,返回相同的值。

Send an approved template from your system (curl)
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 限制该账户。

设置方法

  1. Connect the numberConnect your WhatsApp Business number to easyCoexistence through Meta's Coexistence flow; the app keeps working on the phone.
  2. 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.
  3. Copy the credentialsOpen the number in the dashboard, go to "Plug in your own system", copy the Send endpoint and click "Reveal access token".
  4. 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.
  5. 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 状态及其错误代码。
  • 在紧密循环中反复重试失败的发送。单用户限制或营销已停止的错误不会在几秒内清除,重试只会增加错误。
使用 EasyCoexistence 完成这些操作

自动化会回复客户的来信,每个号码都全天候 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,而不是几个月。应用会继续在手机上运行。

开始免费试用

验证时间