mcpField
T
twilio

twilio

github.com/hyperfx-ai生産性107137 回インストール4 日前に更新
リポジトリ

twilio について

twilioは、チャットからTwilioの通信タスクを実行するスキルです。メッセージ、通話、電話番号認証を扱うチーム向けに、SMSやWhatsApp、音声通話、番号照会、OTP認証を提供します。

主な機能

  1. 01SMSとMMSの送信
  2. 02WhatsAppメッセージの送信
  3. 03通話の発信と履歴確認
  4. 04電話番号の一覧表示と検証
  5. 05認証コードの送信と確認

活用シーン

  1. 01確認済みの送信番号でSMSを送信
  2. 02サンドボックスでWhatsApp送信をテスト
  3. 03メッセージの配信状況や通話記録を確認
  4. 04OTPでユーザーの電話番号を認証

MCP 対応

Hyper MCPの導入とTwilio連携が必要です。MCPクライアントとHyper CLIから、Twilioツールの検索、説明確認、実行ができます。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/hyperfx-ai/marketing-skills --skill twilio

インストール後、Claude Code で/twilioを入力して読み込まれたか確認します。

詳細

Twilio コミュニケーション

SMS、WhatsApp、音声通話、認証など、Twilio に関するすべてのタスクでこのスキルを使用してください。

要件

このスキルのツールの実行方法

このスキルの各ツールは、正規のツール名で指定されています。利用するインターフェースに応じた呼び出し方法で実行してください。

インターフェースツールを探す実行する
MCP クライアント（Claude、Cursor、Codex、ChatGPT）search("<what you want to do>")、次に describe("<name>")call("<name>", {...})
Hyper CLIhyperai 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. 確認後、from_number を "+14155238886" に設定して twilio_whatsapp_send を使用します。

WhatsApp メッセージが「有効な WhatsApp 対応番号ではありません」などのエラーで失敗した場合：

  • ユーザーがまだサンドボックスに参加していない可能性があります。
  • 上記の手順を案内してください。

ツールのクイックリファレンス

メッセージング
  • twilio_sms_send - SMS／MMS メッセージを送信します
  • twilio_whatsapp_send - WhatsApp メッセージを送信します（サンドボックスでは、from_number に +14155238886 を使用）
  • 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 とコードの確認を明示的かつ監査可能な状態にしてください。

コメント

Markdown 対応