Voice Call (Twilio)

🚀 語音呼叫 MCP 服務器

這是一個藉助 Twilio 和 OpenAI 構建的即時語音通話服務器項目。它支持多語言通話，可處理複雜的電話業務邏輯，還能提供詳細的通話記錄與分析。

🚀 快速開始

語音呼叫 MCP 服務器結合了 Twilio 的通信能力與 OpenAI 的 AI 實力，能為用戶提供多語言、智能化的語音通話服務。下面為你介紹使用前的安裝與配置步驟。

✨ 主要特性

• 多語言支持：支持多種語言的即時語音識別和生成。
• 智能路由：根據規則自動將呼叫路由到不同處理節點。
• 錄音功能：保存所有通話的錄音文件。
• 數據分析：提供通話時長、用戶意圖等詳細分析報告。

📦 安裝指南

系統要求

• 操作系統：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

📚 詳細文檔

配置指南

環境變量配置

在項目根目錄下創建 .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秒超時
};

序列圖

呼叫流程

1. 用戶發起呼叫：通過 Twilio 發起語音呼叫。
2. AI 接聽：OpenAI 的即時語音模型開始處理通話內容。
3. 智能交互：AI 根據預設的業務邏輯與用戶進行對話。
4. 記錄存檔：所有通話內容自動存儲到本地數據庫。

為什麼選擇 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 created:', 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 文件。

如需更多信息，請訪問我們的 文檔頁面 或加入 開發者社區。