1: Phlo WhatsApp 概述
Phlo WhatsApp 是 Phlo 平台的 WhatsApp 层。它允许 Phlo 应用通过一个小型网关发送和接收 WhatsApp 消息，同时您的应用代码保持普通的 Phlo：一个接收的 route，使用 WhatsApp resource 发送消息。
1.1: 网关模型
Phlo WhatsApp 为每个 WhatsApp 号码运行一个 gateway 进程（基于 whatsapp-web.js 构建）。该 gateway 拥有与 WhatsApp 的连接，并在 localhost 上暴露一个小型的、秘密保护的 HTTP API。您的 Phlo 应用程序从不直接与 WhatsApp 通信；它与 gateway 进行通信。
- 每个号码一个进程，通过扫描二维码链接一次。
- 入站：gateway 将每条传入消息通过 POST 发送到您应用中的 webhook route。
- 出站：您的应用通过
WhatsAppresource 调用 gateway 的 HTTP API。
这种分离使得长期存在的、有状态的 WhatsApp 会话不在您的请求周期内。您的应用保持无状态和短暂；gateway 持有会话。
1.2: 两个方向
| 方向 | 您编写 | 传递 |
|---|---|---|
| 接收 | 一个 POST route，经过密钥检查 |
入站消息 |
| 发送 | %WhatsApp(url, secret)->... |
文本、媒体、投票、位置 |
1.3: 你连接了什么
WhatsApp资源（它需要HTTP）。security/creds以便网关 URL 和密钥来自data/creds.ini或环境，而不是代码。- 一个用于接收消息的 webhook 路由。
phlo-demo-whatsapp 仓库是一个完整的、保护凭证的参考，适用于双向通信。没有凭证时，它保持静止，因此可以安全地在任何地方运行。