twilio

Twilio 通信

将此技能用于所有 Twilio 任务，包括 SMS、WhatsApp、语音通话和验证。

要求

• 已安装并连接 Hyper MCP。 https://app.hyperfx.ai/mcp
• 已在 https://app.hyperfx.ai/apps 启用 Twilio 集成。

如何运行此技能中的工具

此技能中的每个工具都以其规范工具名称命名。使用你的操作界面提供的调用方式运行：

操作界面	查找工具	运行工具
MCP 客户端（Claude、Cursor、Codex、ChatGPT）	search("<what you want to do>")，然后 describe("<name>")	call("<name>", {...})
Hyper CLI	hyperai search "<what you want to do>"，然后 hyperai describe <name>	hyperai call <name> --json '{...}'

如果找不到某个工具，说明该工作区未连接或未启用对应集成：请停止操作，并告知用户需要连接哪个集成。

WhatsApp 沙盒设置（测试时必需）

在沙盒/测试模式下发送 WhatsApp 消息前，用户必须加入沙盒：

1. 用户访问：https://console.twilio.com/us1/develop/sms/try-it-out/whatsapp-learn
2. 找到其专属加入码（例如“join happy-turtle”）
3. 从 WhatsApp 向 +14155238886 发送该消息
4. 确认加入后，使用 twilio_whatsapp_send，并将 from_number 设为 "+14155238886"

如果 WhatsApp 消息发送失败，并提示“not a valid WhatsApp-enabled number”或类似错误：

• 用户很可能尚未加入沙盒
• 引导用户完成上述步骤

工具速查

消息

• twilio_sms_send - 发送 SMS/MMS 消息
• twilio_whatsapp_send - 发送 WhatsApp 消息（沙盒中将 +14155238886 用作 from_number）
• twilio_messages_list - 列出消息历史记录
• twilio_messages_delivery_status_check - 检查消息是否已送达

语音通话

• twilio_calls_create - 发起外呼（需要 TwiML URL 或内联 TwiML）
• twilio_calls_list - 列出通话历史记录
• twilio_recordings_list - 列出通话录音

电话号码

• twilio_phone_numbers_list - 列出账户中的号码（用于查找有效的 from_number）
• twilio_phone_numbers_lookup - 验证电话号码并获取运营商信息

验证（OTP）

• twilio_verification_services_create - 先创建验证服务
• twilio_verifications_send - 发送 OTP 验证码
• twilio_verifications_check - 验证用户的验证码

常见模式

发送 SMS/WhatsApp 前： 先调用 twilio_phone_numbers_list，查找有效的发送方号码。

WhatsApp 沙盒流程：

1. 确认用户已加入沙盒（如果尚未加入，请提供操作说明）
2. 使用以下参数调用 twilio_whatsapp_send：

{
  "to": "+1XXXXXXXXXX",
  "body": "Hello from the assistant",
  "from_number": "+14155238886"
}

电话验证流程：

步骤 1 -- 使用以下参数调用 twilio_verification_services_create：

{
  "friendly_name": "My App"
}

步骤 2 -- 使用以下参数调用 twilio_verifications_send：

{
  "service_sid": "<service_sid_from_step_1>",
  "to": "+1XXXXXXXXXX",
  "channel": "sms"
}

步骤 3 -- 使用以下参数调用 twilio_verifications_check：

{
  "service_sid": "<service_sid>",
  "to": "+1XXXXXXXXXX",
  "code": "<user_provided_code>"
}

安全规则

• 切勿假定发送方号码有效；务必使用 twilio_phone_numbers_list 进行验证。
• 失败后不要悄无声息地继续操作；请报告确切错误，并询问用户如何继续。
• 对于验证流程，应明确记录服务 SID 和验证码检查过程，确保可审计。