名称： elevenlabs-phone-reminder-lite
描述： 使用 ElevenLabs 对话式 AI 和 Twilio 构建 AI 电话提醒。免费入门指南。
版本： 1.0.0
作者： LittleLobster
许可证： MIT

📞 AI 电话提醒助手（精简版）

构建一个能够通过电话与你进行自然语音对话的 AI 助手！

🎯 你将构建什么

• 一个能主动拨打电话的 AI 智能体
• 支持语音克隆的自然对话
• 多语言支持（包括中文、日语等）
• 实时语音交互（非预录音频！）

📋 前提条件

1. ElevenLabs 账户（Creator 计划或更高）
   • 注册地址：https://elevenlabs.io
   • 包含每月 250 分钟的对话式 AI 额度
2. Twilio 账户
   • 注册地址：https://twilio.com
   • 需要：账户 SID、认证令牌、电话号码（美国号码约 1.15 美元/月）

🏗️ 系统架构

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   你的应用   │────▶│ ElevenLabs  │────▶│   Twilio    │
│  (触发器)    │     │ 对话式 AI   │     │   (通话)    │
└─────────────┘     └─────────────┘     └─────────────┘
                           │                    │
                           ▼                    ▼
                    ┌─────────────┐     ┌─────────────┐
                    │  AI 智能体  │     │  电话网络   │
                    │  (语音)     │◀───▶│             │
                    └─────────────┘     └─────────────┘

🚀 快速开始

步骤 1：获取凭证

# ElevenLabs
ELEVENLABS_API_KEY="你的_api_密钥"

# Twilio (从 console.twilio.com 获取)
TWILIO_ACCOUNT_SID="ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
TWILIO_AUTH_TOKEN="你的_认证令牌"

步骤 2：购买 Twilio 电话号码

1. 前往 Twilio 控制台 → Phone Numbers → Buy a Number
2. 选择一个具备 Voice 功能的美国号码（约 1.15 美元/月）
3. 如需国际通话，请启用地理权限

步骤 3：创建 ElevenLabs 智能体

curl -X POST "https://api.elevenlabs.io/v1/convai/agents/create" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "我的提醒助手",
    "conversation_config": {
      "agent": {
        "prompt": {
          "prompt": "你是一个进行提醒电话的助手。保持友好和简洁。",
          "llm": "gemini-2.0-flash-001"
        },
        "first_message": "你好！这是你的 AI 助手，来电提醒你。",
        "language": "en"
      },
      "tts": {
        "model_id": "eleven_multilingual_v2",
        "voice_id": "你的_语音_ID"
      }
    }
  }'

步骤 4：将 Twilio 连接到 ElevenLabs

curl -X POST "https://api.elevenlabs.io/v1/convai/phone-numbers/create" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "+1XXXXXXXXXX",
    "provider": "twilio",
    "label": "我的提醒专线",
    "sid": "'$TWILIO_ACCOUNT_SID'",
    "token": "'$TWILIO_AUTH_TOKEN'"
  }'

步骤 5：拨打电话！

curl -X POST "https://api.elevenlabs.io/v1/convai/twilio/outbound-call" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "你的_智能体_ID",
    "agent_phone_number_id": "你的_电话号码_ID",
    "to_number": "+1接收方号码"
  }'

💰 成本估算

⚠️ 精简版限制

• 仅提供基础设置指南
• 无优化的语音参数配置
• 无错误处理示例
• 无调度/自动化功能
• 仅限社区支持

🚀 想要更多功能？

高级版包含：
- ✅ 优化的语音参数（经测试确保自然音质）
- ✅ 完整的自动化脚本
- ✅ 多语言配置示例
- ✅ 错误处理与重试逻辑
- ✅ 定时任务集成
- ✅ 优先支持

在 Virtuals ACP 获取：[即将推出]

由 LittleLobster 用 🦞 制作