twilio

Twilio API 的 OpenClaw 技能：消息传递、WhatsApp、语音、对话、验证，以及 Studio、查找、代理、同步、TaskRouter 和 Segment/Engage。

# Twilio API Skill (Advanced)

## Purpose
Provide a production-oriented guide for Twilio API workflows across messaging and communications channels using direct HTTPS requests.

## Best fit
- You need SMS/MMS, WhatsApp, Voice, or Verify flows.
- You want reliable webhook handling and operational guardrails.
- You prefer direct HTTP requests rather than SDKs.

## Not a fit
- You require a full SDK or complex multi-service orchestration.
- You need advanced campaign management across multiple ESPs.

## Quick orientation
- Read `references/twilio-api-overview.md` for core surfaces and base endpoints.
- Read `references/twilio-auth-and-webhooks.md` for auth and webhook validation.
- Read `references/twilio-messaging-sms-mms.md` for SMS/MMS workflows.
- Read `references/twilio-whatsapp.md` for WhatsApp messaging specifics.
- Read `references/twilio-voice.md` for call/IVR basics.
- Read `references/twilio-conversations.md` for omni-channel threads.
- Read `references/twilio-verify.md` for OTP/verification flows.
- Read `references/twilio-sendgrid.md` for email sending.
- Read `references/twilio-studio.md` for low-code flow orchestration.
- Read `references/twilio-lookup.md` for phone intelligence.
- Read `references/twilio-proxy.md` for masked communications.
- Read `references/twilio-sync.md` for real-time state.
- Read `references/twilio-taskrouter.md` for routing and queues.
- Read `references/twilio-segment-engage.md` for CDP and audience activation.

## Required inputs
- Account SID and Auth Token (or API Key/Secret).
- Sender identity (phone number, messaging service, WhatsApp sender).
- Webhook URLs for callbacks.
- Compliance constraints (opt-in, regional regulations).

## Expected output
- A clear workflow plan, method checklist, and operational guardrails.

## Operational notes
- Validate webhook signatures on every inbound request.
- Keep outbound rate limits in mind and retry safely.
- Store secrets in a vault and rotate regularly.

## Security notes
- Never log credentials.
- Use least-privilege API keys where possible.

---

## 中文说明

# Twilio API 技能（高级）

## 用途
通过直接的 HTTPS 请求，为跨消息传递和通信渠道的 Twilio API 工作流程提供面向生产环境的指南。

## 适用场景
- 你需要 SMS/MMS、WhatsApp、语音或 Verify 流程。
- 你想要可靠的 webhook 处理和操作防护措施。
- 你倾向于使用直接的 HTTP 请求而非 SDK。

## 不适用场景
- 你需要完整的 SDK 或复杂的多服务编排。
- 你需要跨多个 ESP 的高级营销活动管理。

## 快速导览
- 阅读 `references/twilio-api-overview.md` 了解核心功能面和基础端点。
- 阅读 `references/twilio-auth-and-webhooks.md` 了解认证和 webhook 验证。
- 阅读 `references/twilio-messaging-sms-mms.md` 了解 SMS/MMS 工作流程。
- 阅读 `references/twilio-whatsapp.md` 了解 WhatsApp 消息传递的具体细节。
- 阅读 `references/twilio-voice.md` 了解通话/IVR 基础知识。
- 阅读 `references/twilio-conversations.md` 了解全渠道会话串。
- 阅读 `references/twilio-verify.md` 了解 OTP/验证流程。
- 阅读 `references/twilio-sendgrid.md` 了解电子邮件发送。
- 阅读 `references/twilio-studio.md` 了解低代码流程编排。
- 阅读 `references/twilio-lookup.md` 了解电话情报。
- 阅读 `references/twilio-proxy.md` 了解掩码通信。
- 阅读 `references/twilio-sync.md` 了解实时状态。
- 阅读 `references/twilio-taskrouter.md` 了解路由和队列。
- 阅读 `references/twilio-segment-engage.md` 了解 CDP 和受众激活。

## 必需输入
- Account SID 和 Auth Token（或 API Key/Secret）。
- 发送方身份（电话号码、消息服务、WhatsApp 发送方）。
- 用于回调的 Webhook URL。
- 合规约束（选择加入、区域法规）。

## 预期输出
- 清晰的工作流程计划、方法检查清单和操作防护措施。

## 操作说明
- 对每个入站请求验证 webhook 签名。
- 牢记出站速率限制并安全地重试。
- 将密钥存储在保险库中并定期轮换。

## 安全说明
- 切勿记录凭据。
- 尽可能使用最小权限的 API 密钥。