Voice Call (Twilio)

🚀 音声通話 MCP サーバー

このプロジェクトは、Twilio と OpenAI を用いて構築されたリアルタイム音声通話サーバーです。多言語対応の通話をサポートし、複雑な電話業務ロジックを処理できると同時に、詳細な通話記録と分析を提供します。

🚀 クイックスタート

音声通話 MCP サーバーは、Twilio と OpenAI を活用して、リアルタイムの音声通話を実現するサーバーです。多言語対応や複雑な業務ロジックの処理が可能で、通話記録と分析も提供します。

✨ 主な機能

• 多言語対応：複数の言語のリアルタイム音声認識と生成をサポートします。
• スマートルーティング：ルールに基づいて自動的に通話を異なる処理ノードにルーティングします。
• 録音機能：すべての通話の録音ファイルを保存します。
• データ分析：通話時間、ユーザーの意図などの詳細な分析レポートを提供します。

📦 インストール

システム要件

• オペレーティングシステム：Linux（推奨）または macOS
• メモリ：少なくとも 4GB
• CPU：デュアルコア以上

依存関係

1. Node.js (>=16.0)
2. PostgreSQL またはその他のサポートされるデータベース
3. Twilio アカウント
4. OpenAI API キー

インストール手順

# リポジトリをクローンする
git clone https://github.com/your-repo.git
cd your-repo

# 依存関係をインストールする
npm install

# 環境変数を設定する
export TWILIO_ACCOUNT_SID=your_sid
export TWILIO_AUTH_TOKEN=your_token
export OPENAI_API_KEY=your_key

📚 ドキュメント

シーケンス図

通話フロー

1. ユーザーが通話を開始：Twilio を介して音声通話を開始します。
2. AI が応答：OpenAI のリアルタイム音声モデルが通話内容の処理を開始します。
3. スマートな対話：AI が事前に設定された業務ロジックに基づいてユーザーと対話します。
4. 記録とアーカイブ：すべての通話内容が自動的にローカルデータベースに保存されます。

設定ガイド

環境変数の設定

プロジェクトのルートディレクトリに .env ファイルを作成し、以下の内容を追加します。

TWILIO_ACCOUNT_SID=your_account SID
TWILIO_AUTH_TOKEN=your_auth token
OPENAI_API_KEY=your_openai key
DB_URI=postgresql://localhost:5432/voip_calls

業務ロジックの設定

config/businessLogic.js ファイルを編集し、カスタムの通話ルールを追加します。

module.exports = {
    languageSupport: ['zh-CN', 'en-US', 'de-DE'],
    fallbackLanguage: 'zh-CN',
    callTimeout: 30000 // 30秒のタイムアウト
};

なぜ MCP を選ぶのか

• 高性能：Twilio の信頼性の高い通信プラットフォームと OpenAI の強力な AI 機能に基づいています。
• 拡張性が高い：新しい言語や業務ロジックを迅速に追加できます。
• 高可用性：組み込みの障害許容メカニズムにより、サービスの安定した動作が保証されます。

💻 使用例

基本的な使用法

// カスタマーサービスのロジック設定
const { createVoiceCall } = require('voip-service');

createVoiceCall({
    fromNumber: '1234567890',
    toNumber: '0987654321',
    language: 'zh-CN',
    callbackUrl: 'http://localhost:3000/api/call-back'
}).then(call => {
    console.log('通話が作成されました:', call.sid);
});

🔧 技術詳細

注意事項

1. 電話番号の形式：すべての番号は E.164 標準（例：+1234567890）を使用する必要があります。
2. レート制限：Twilio と OpenAI アカウントのレート制限と課金状況に注意してください。
3. 音声対話：AI がリアルタイムで自然な対話を処理します。
4. 通話時間：費用を節約するために通話時間を管理してください。
5. 公開暴露：ngrok トンネルのランダムな URL が公開されるため、セキュリティに注意してください。

トラブルシューティング

一般的な問題

1. 「電話番号は E.164 形式でなければなりません」

   • 番号が「+」で始まり、国番号を含んでいることを確認してください。

2. 「無効な資格情報」

   • TWILIO_ACCOUNT_SID と TWILIO_AUTH_TOKEN が正しいことを確認してください。

3. 「OpenAI API エラー」

   • OPENAI_API_KEY が有効で、十分なクォータがあることを確認してください。

4. 「ngrok トンネルの起動に失敗しました」

   • NGROK_AUTHTOKEN が有効で、期限切れでないことを確認してください。

貢献ガイド

ご貢献いただけることを歓迎します！以下は改善が必要な領域です。

• より多くの AI モデルをサポートする
• 会話履歴を保存するためのデータベース統合を追加する
• 通話体験を向上させるために遅延と応答時間を改善する
• エラー処理と回復メカニズムを強化する
• より多くの事前設定された会話テンプレートを追加する

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。

詳細情報が必要な場合は、ドキュメントページ をご覧いただくか、開発者コミュニティ に参加してください。