用途：把 WhatsApp 接入 swarm，处理真人入站消息并回复。Kapso（https://kapso.ai）代理 Meta Cloud API，每个号码可接原生入站处理器或按消息派发任务的 workflow。
主要能力：
- 读取入站 webhook payload（v2），含 message 与 conversation 结构；必须过滤 message.kapso.direction == "inbound"，因为自身发出的消息、送达、已读、失败也会触发 webhook。测试载荷带 "test": true 与 wamid.TEST_ 前缀，不要对测试载荷发真实回复。
- 支持文本及 image/audio/video/document/sticker/location/contacts/reaction 等类型，媒体消息携带 Meta media id。
- 媒体下载为两步：GET $API_BASE/meta/whatsapp/v24.0/<MEDIA_ID> 取临时 URL，再下载二进制，lookaside URL 会很快过期。
- 读取会话：GET $API_BASE/platform/v1/whatsapp/conversations、messages 列表（用 query-param 形式，按 conversation_id 与 limit），消息列表最新在前。
- 发送：24 小时窗口内可发自由文本，POST $API_BASE/meta/whatsapp/v24.0/$PHONE_NUMBER_ID/messages；加 context.message_id 可引用回复。
- 媒体发送先上传 POST .../media，再按 id 发送；宽图需先填充为约 1:1 或 4:5 画布再以 image 发送，避免被压缩；type:document 只用于真实文件。语音条需 audio/ogg + Opus 才有 PTT 播放条。
- 已读 + 输入状态：同端点 POST status: "read" 与 typing_indicator，约 25 秒后自动消失。
- 表情回应：reaction 类型，每条消息仅一个表情，新表情替换旧表情，"emoji": "" 可清除。
- 模板消息：窗口外必须使用预先批准的模板，可先 GET .../templates 列出。
- Webhook 签名：X-Webhook-Signature 为 HMAC-SHA256，原生处理器与 workflow 触发器会自动验证，也可用 openssl 手动比对。
配置：需 KAPSO_API_BASE_URL、KAPSO_API_KEY、KAPSO_PHONE_NUMBER_ID、KAPSO_WEBHOOK_HMAC_SECRET；worker 容器未安装 Kapso CLI，可用直接 HTTP 或克隆 gokapso/agent-skills。
限制：24 小时窗口外不能发自由文本；联系人与用户映射需先 resolve-user，未匹配时由 Lead 创建用户，worker 不应自行创建；回复应简短、使用入站消息相同语言。其余未在资料中说明的能力暂未提供。