WhatsApp 侧边聊天

WhatsApp side chats

---

summary: "WhatsApp side-chat setup and media capabilities"

read_when:

- User wants to talk to Muse on WhatsApp

- User asks to connect or disconnect WhatsApp

- User wants messages or scheduled replies on WhatsApp

- User asks about WhatsApp attachments or group support

title: "WhatsApp"

---

WhatsApp 连接让用户可以直接在 WhatsApp 里与 Muse 对话。该对话在 Muse 中呈现为一个持久的侧边聊天(side chat),标题为 `WhatsApp`。从它发出的回复和安排的任务都会回到那里。它的历史不会复制到主聊天中。用户消息来自 WhatsApp;Muse 不接受应用编造的消息进入这个提供方(provider)对话。

这个个人一对一连接不会读取用户的其他 WhatsApp 对话,不会以用户的个人账户发送,也不会让 Muse 加入群组。其他账户集成有各自的约定。给导航指引时要区分 Muse 应用和 WhatsApp。

---

summary: "WhatsApp side-chat setup and media capabilities"

read_when:

- User wants to talk to Muse on WhatsApp

- User asks to connect or disconnect WhatsApp

- User wants messages or scheduled replies on WhatsApp

- User asks about WhatsApp attachments or group support

title: "WhatsApp"

---

The WhatsApp connection lets the user talk directly to Muse from WhatsApp.

That conversation appears in Muse as one durable side chat titled `WhatsApp`.

Replies and tasks scheduled from it return there. Its history is not copied

into main chat. Incoming user messages originate in WhatsApp; Muse does not

accept app-authored messages into this provider conversation.

This personal one-to-one connection does not read the user's other WhatsApp

conversations, send as their personal account, or let Muse join a group.

Other account integrations have their own contracts. Distinguish the Muse app

from WhatsApp when giving navigation instructions.

连接与断开
Connect and disconnect

先用 `provider: whatsapp` 调用 `chat.connection_status`。结果包含 `chat_id`、`provider`、`status` 和 `connect: null`。已连接时可能包含 `chat_url`——一个现有的聊天链接,可以作为 **Open WhatsApp Chat** 提供。状态绝不会返回配对令牌(pairing bearer)。

当状态为 `unlinked` 或 `link_pending` 且用户请求连接时,提供:

[Connect WhatsApp](https://agent.meta.ai/connect/channel?service=whatsapp)

二维码、Connect 按钮和安全绑定流程归应用所有。不要编造电话号码、wa.me 链接、二维码、配对 URL 或链接码。如果已连接,直接说明已连接。`link_pending` 表示用户应完成应用内的流程。如果是 `checking`,先重新读取状态再做决定。如果是 `unavailable`,解释这是临时故障,不要提供链接,也不要说它不支持。

对于用户在自己的 Muse 聊天中明确提出的断开请求,先查看状态,再用 `provider: whatsapp` 调用 `chat.disconnect`。先澄清模糊的意图。来自 WhatsApp 的轮次和后台工作不能自行断开。断开会保留历史,并撤销旧链接的投递权限。已经断开的连接无需进一步拆除。

Start with `chat.connection_status` with `provider: whatsapp`.

The result carries `chat_id`, `provider`, `status`, and `connect: null`.

When linked, it can include `chat_url`, an existing chat link that may be

offered as **Open WhatsApp Chat**. Status never returns a pairing bearer.

For a requested connection when `unlinked` or `link_pending`, offer:

[Connect WhatsApp](https://agent.meta.ai/connect/channel?service=whatsapp)

The app owns the QR code or Connect button and secure linking flow. Do not

invent a phone number, wa.me link, QR code, pairing URL, or link code. If linked,

say so instead. `link_pending` means the user should finish the app flow.

If `checking`, read status again before deciding. If `unavailable`, explain

the temporary failure without offering a link or calling it unsupported.

For an explicit disconnect request in the user's own Muse chat, inspect status

and use `chat.disconnect` with `provider: whatsapp`. Clarify ambiguous intent

first. WhatsApp-origin turns and background work cannot disconnect themselves.

Disconnection retains history and revokes delivery authority from the old link.

An already unlinked connection needs no further teardown.

附件与批准
Attachments and approvals

用户可以向 Muse 发送图像、文档和语音消息/录音。Muse 可以发送图像、视频、音频、文档和自包含的 HTML 文件。回复由发起的侧边聊天自动投递。

权限提示可以出现在 WhatsApp 中,用户可以通过其结构化控件回答。决策归 Sentinel;绝不要从自由文本或模型输出推断决策。

入站轮询按现有的配对连接节奏运行。游标、加密材料、链接身份和媒体状态对运行时保持私有。没有可编辑的 WhatsApp 连接偏好。用状态排查故障,用安全的应用流程重连。

The user can send images, documents, and voice messages/recordings to Muse.

Muse can send images, video, audio, documents, and self-contained HTML files.

Replies are delivered automatically by the originating side chat.

Permission prompts can appear in WhatsApp and the user can answer through its

structured controls. Decisions belong to Sentinel; never infer one from free

text or model output.

Inbound polling runs on the existing paired-connection cadence. Cursors,

encryption material, link identity, and media state remain private to the

runtime. There are no editable WhatsApp connection preferences. Use status for

troubleshooting and the secure app flow to reconnect.