Tools
发送 WhatsApp 消息
【手动内容开始：简介】 WhatsApp 是一个全球流行的消息平台，能够在个人和企业之间实现安全、可靠的通信。
WhatsApp Business API 为组织提供了强大的功能，可以：
- 吸引客户：直接向客户首选的消息应用发送个性化消息、通知和更新
- 自动化对话：为常见问题创建交互式聊天机器人和自动响应系统
- 增强支持：通过支持丰富媒体的熟悉界面提供实时客户服务
- 推动转化：在安全、合规的环境中促进交易和跟进客户
在 Mandala 中，WhatsApp 集成使您的代理能够将这些消息功能作为其工作流程的一部分。这为复杂的客户参与场景创造了机会，例如预约提醒、验证码、警报和交互式对话。该集成弥合了您的 AI 工作流程与客户通信渠道之间的差距，使您的代理能够直接向用户的移动设备传递及时、相关的信息。通过将 Mandala 与 WhatsApp 连接，您可以构建智能代理，通过客户首选的消息平台与他们互动，在自动化常规消息任务的同时提升用户体验。 【手动内容结束】
使用说明
将 WhatsApp 集成到工作流程中。可以发送消息。
工具
whatsapp_send_message
发送 WhatsApp 消息
输入
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
phoneNumber | string | 是 | 带国家代码的接收者电话号码 |
phoneNumberId | string | 是 | WhatsApp Business 电话号码 ID |
accessToken | string | 是 | WhatsApp Business API 访问令牌（支持 {{WHATSAPP_ACCESS_TOKEN}} 这类环境变量引用） |
mode | string | 否 | 模式：text, interactive, image, video, audio, document, sticker, location, contacts, reaction, raw（兼容：media + media.type） |
message | string | 否 | 文本内容（仅在 mode=text 时必需） |
media | object | 否 | 用于 image/video/audio/document/sticker（需要 link；可选 caption/filename） |
interactive | object | 否 | 交互式消息负载（列表/按钮） |
location | object | 否 | 位置（latitude, longitude，可选 name, address） |
contacts | object | 否 | 联系人（Cloud API contacts 数组） |
reaction | object | 否 | 表情回应（message_id, emoji） |
rawPayload | object | 否 | 发送原始 WhatsApp Cloud API payload（高级） |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
success | boolean | 发送是否成功 |
messageId | string | WhatsApp 消息 ID（可用时返回） |
httpStatus | number | WhatsApp/Graph API 返回的 HTTP 状态码 |
error | string | 错误信息（如有） |
rawResponse | json | 完整 API 响应（便于排查问题） |
媒体注意事项
- 对于媒体模式（
image/video/audio/document/sticker），media.link必须是可直接下载的公开文件 URL（例如https://.../file.mp4并返回真实字节内容）。 - YouTube 链接不是直接文件，请改为发送 文本。
- 贴纸必须为 WebP（
image/webp）。 - 如果上传时报 “File too large”，请减小文件大小/码率，或改为发送链接文本。
注意事项
- 类别：
tools - 类型：
whatsapp