ThunderPhone v3 พร้อมให้ใช้งานแล้วเริ่มใช้งานได้ด้วยตัวเอง ราคาเริ่มต้น 2 เซนต์ต่อนาที.อ่านประกาศเปิดตัว

Getting Started

ThunderPhone CLI

เข้าสู่ระบบ จัดการเอเจนต์เสียงและการโทร กำหนดค่าไคลเอ็นต์ MCP และสร้างโครงร่างโปรเจกต์จากเทอร์มินัล

CLI ต้องใช้ Node.js 18.18 หรือใหม่กว่า เรียกใช้ด้วย npx หรือติดตั้งแบบโกลบอล:

npm install -g thunderphone
thunderphone --help

เข้าสู่ระบบ

npx thunderphone login
thunderphone whoami --json

การเข้าสู่ระบบจะแสดงรหัสยืนยัน เปิดเบราว์เซอร์ และรอการอนุญาต ใช้ --no-browser บนเครื่องแบบ headless และเปิด URL ที่แสดงในที่อื่น การเข้าสู่ระบบด้วยอุปกรณ์ต้องอาศัยการเปิดใช้ OAuth device flow ของ API คีย์ API ขององค์กรใน THUNDERPHONE_API_KEY สามารถใช้ยืนยันคำสั่งได้เช่นกัน และมีลำดับความสำคัญเหนือข้อมูลรับรองการเข้าสู่ระบบที่บันทึกไว้

ข้อมูลรับรองจะจัดเก็บแยกตามโปรไฟล์ใน ~/.config/thunderphone/credentials.json โดยใช้โหมดไฟล์ 0600 ค่า XDG_CONFIG_HOME และ THUNDERPHONE_CONFIG_DIR จะแทนที่ ไดเรกทอรี โทเค็นการเข้าถึงจะรีเฟรชโดยอัตโนมัติ และโทเค็นรีเฟรชแบบหมุนเวียนจะ ถูกบันทึกแบบอะตอมมิก การเข้าสู่ระบบจะไม่แสดงโทเค็น

thunderphone login --profile work
thunderphone agents list --profile work --json
thunderphone logout --profile work

THUNDERPHONE_PROFILE กำหนดโปรไฟล์เริ่มต้น การออกจากระบบจะลบข้อมูลรับรองในเครื่อง แต่จะไม่เพิกถอนสิทธิ์อนุญาตบนเซิร์ฟเวอร์ การเปลี่ยนหรือรีเซ็ตรหัสผ่าน หรือ การเปลี่ยนอีเมลบัญชี จะเพิกถอนสิทธิ์อนุญาตนั้น ให้เรียกใช้ thunderphone login อีกครั้ง API เริ่มต้นคือ https://api.thunderphone.com ใช้ --api-base-url หรือ THUNDERPHONE_API_BASE_URL สำหรับ API อื่น โทเค็นของโปรไฟล์หนึ่ง ไม่สามารถส่งไปยัง URL ของ API ที่กำหนดค่าไว้ต่างกันได้ ให้เข้าสู่ระบบ URL นั้นด้วยโปรไฟล์แยกต่างหาก

คำสั่ง

ทุกคำสั่งรองรับ --json ข้อมูลที่สำเร็จจะส่งไปยัง stdout ส่วนข้อผิดพลาดจะส่งไปยัง stderr พร้อมรหัสออกที่ไม่ใช่ศูนย์ หากไม่ใช้ --json ผลลัพธ์จะเป็นตารางหรือรายการฟิลด์แบบกระชับ JSON จะคงโครงสร้างการตอบกลับของ API โดยปกปิดฟิลด์ข้อมูลรับรอง MCP จะสงวน stdout ไว้สำหรับโปรโตคอล MCP

คำสั่งวัตถุประสงค์
login [--no-browser] [--scope "scopes"]อนุญาตสิทธิ์ผ่านรหัสอุปกรณ์
logout, whoamiลบข้อมูลรับรองในเครื่อง แสดงรายการองค์กรที่เข้าถึงได้
agents list, agents get IDอ่านข้อมูลเอเจนต์
agents create --file agent.jsonสร้างเอเจนต์
agents update ID --file agent.jsonบันทึกฉบับร่างเอเจนต์
agents deploy ID, agents delete IDปรับใช้ฉบับร่าง ลบเอเจนต์
numbers listอ่านข้อมูลหมายเลขโทรศัพท์
numbers provision --country US --area-code 415จัดเตรียมหมายเลขรับสายเข้าในสหรัฐอเมริกา
numbers assign NUMBER_ID --agent IDกำหนดเอเจนต์สำหรับสายเรียกเข้า
sms send TO --from FROM --body TEXT --idempotency-key KEYส่ง SMS ผ่านหมายเลขผู้ให้บริการเครือข่ายที่ลูกค้าเชื่อมต่อ พร้อมการเล่นซ้ำอย่างปลอดภัย
sms list [--limit N], sms get UUIDแสดงรายการหรือตรวจสอบระเบียน SMS
call TO --agent ID --from FROM [--wait]โทรออก โดยเลือกที่จะรอทรานสคริปต์ได้
calls list [--limit N] [--agent ID]แสดงรายการสาย (จำกัด 1–200)
calls get ID, calls transcript IDอ่านข้อมูลสายหนึ่งสายหรือทรานสคริปต์ของสาย
test run AGENT_ID [--scenario ID] --consent-to-chargeเรียกใช้สถานการณ์ที่บันทึกไว้และมีค่าใช้จ่ายผ่านช่องทางเว็บ
test status RUN_ID [--agent ID]ตรวจสอบแบตช์ พร้อมรายละเอียดสถานการณ์เมื่อระบุเอเจนต์
import VENDOR export.jsonเตรียมการนำเข้า JSON จากผู้ให้บริการเพื่อตรวจสอบ
imports get UUID, imports commit UUIDตรวจสอบการนำเข้า ยืนยันเอเจนต์ที่เลือกหลังการตรวจสอบ
mcp setup, mcp serveกำหนดค่าลูกข่าย เริ่มต้นบริดจ์ stdio
init [directory]สร้างโครงร่างโปรเจ็กต์

การโทรออกต้องใช้หมายเลขที่เปิดใช้การโทรออก THUNDERPHONE_FROM_NUMBER สามารถ ระบุค่าให้ --from ได้ หมายเลข VoIP ของลูกค้ายังคงรองรับการโทรออก หมายเลขที่ ThunderPhone จัดเตรียมจะเริ่มต้นเป็นแบบรับสายเข้าเท่านั้น ผู้ดูแลองค์กรสามารถ ขอเปิดใช้การโทรออกได้จากหน้าหมายเลขโทรศัพท์ โดยคำขอแต่ละรายการจะได้รับการ ตรวจสอบด้วยตนเอง --wait มีค่าเริ่มต้นเป็นระยะหมดเวลาหนึ่งชั่วโมง ให้ตั้งค่า --timeout SECONDS เพื่อเปลี่ยนแปลง การหมดเวลาจะหยุดการรอโดยไม่วางสาย

SMS ต้องใช้หมายเลขที่รองรับ SMS ในบัญชี Twilio หรือ Telnyx ที่เชื่อมต่อของคุณด้วย ระบบจะไม่ส่งจากหมายเลขที่ ThunderPhone เป็นเจ้าของ ใช้คีย์ idempotency ซ้ำ เฉพาะเมื่อลองส่งซ้ำโดยมีผู้ส่ง ผู้รับ และเนื้อหาข้อความเดิมทุกประการ

การนำเข้ารองรับ vapi, retell, elevenlabs และ bland อาร์กิวเมนต์ที่สองคือ พาธไปยังไฟล์ส่งออก JSON ของผู้ให้บริการ ไม่ใช่ ID ระยะไกลของผู้ให้บริการ API จะเตรียมการแมป แบบอะซิงโครนัส ให้ตรวจสอบด้วย imports get UUID และยืนยันเฉพาะหลังจากพร้อมแล้ว และคุณได้ตรวจสอบฟิลด์ที่แมปและคำเตือนแล้ว ดู การนำเข้าเอเจนต์

การตั้งค่า MCP

thunderphone mcp setup --client cursor --api-key-env THUNDERPHONE_API_KEY
thunderphone mcp setup --client codex --scope user --api-key-env THUNDERPHONE_API_KEY
thunderphone mcp setup --client claude-desktop --scope user

ไคลเอนต์: claude-code, codex, cursor, vscode, gemini, claude-desktop และ windsurf ขอบเขตโปรเจกต์เป็นค่าเริ่มต้น Desktop และ Windsurf ต้องใช้ขอบเขตผู้ใช้ ละ --client เพื่อค้นหาไคลเอนต์เดียวจากโปรเจกต์ การตรวจพบที่ไม่ชัดเจน จะแจ้งให้เลือกแบบโต้ตอบ หรือไม่สำเร็จพร้อมคำแนะนำในเซสชันแบบไม่โต้ตอบ การตั้งค่าจะแสดงไฟล์ที่เขียนและคงเซิร์ฟเวอร์ที่ไม่เกี่ยวข้องไว้ JSON ที่มีอยู่ ต้องเป็น strict JSON ที่ถูกต้อง ค่า TOML ของ Codex จะถูกคงไว้ แต่ความคิดเห็นอาจถูกจัดรูปแบบใหม่

การตั้งค่าจะเลือกใช้ remote HTTP โดยตรงเป็นอันดับแรก เมื่อใช้ --api-key-env ระบบจะเขียน การอ้างอิงตัวแปร ไม่เขียนคีย์โดยเด็ดขาด หากไม่มีตัวเลือกนี้ HTTP โดยตรงจะใช้การรองรับ OAuth ของไคลเอนต์ และจะไม่ใช้ไฟล์ข้อมูลรับรองของ CLI หากต้องการใช้ข้อมูลรับรองจาก thunderphone login ซ้ำในไคลเอนต์ใดก็ตามที่รองรับ stdio ให้ใช้:

{
  "mcpServers": {
    "thunderphone": {
      "command": "npx",
      "args": ["-y", "@thunderphone/mcp"]
    }
  }
}

ตัวครอบจะตรวจสอบ THUNDERPHONE_API_KEY จากนั้นตรวจสอบโปรไฟล์ CLI ปัจจุบัน (รีเฟรช เมื่อจำเป็น) แล้วมอบหมาย OAuth ให้ mcp-remote THUNDERPHONE_MCP_URL จะแทนที่ endpoint ระบบจะไม่ส่ง telemetry นอกจากนี้ยังตั้งค่าแบบสแตนด์อโลนได้ผ่าน npx -y @thunderphone/mcp setup --client cursor หรือ thunderphone-mcp setup หลังจาก ติดตั้ง @thunderphone/mcp แบบ global

สร้างโปรเจกต์

npx create-thunderphone-agent my-receptionist
npx create-thunderphone-agent my-outbound --template python --agent-type outbound
# Equivalent:
thunderphone init my-receptionist --template node --agent-type receptionist

เทมเพลตคือ node และ python ประเภทเอเจนต์คือ receptionist, outbound และ custom เอเจนต์เริ่มต้นคือพนักงานต้อนรับคลินิกทันตกรรมภาษาอังกฤษ/สเปนที่มี ข้อเท็จจริงสำหรับเดโมอย่างชัดเจน โปรเจกต์ประกอบด้วย agent.json สคริปต์ deploy การกำหนดค่า MCP สำหรับ Claude Code, Cursor และ VS Code คำสั่งสำหรับเอเจนต์ .env.example และ README การสร้างโครงโปรเจกต์ทำงานแบบออฟไลน์และจะไม่เขียนทับไดเรกทอรีที่ไม่ว่าง

แก้ไขข้อมูลธุรกิจก่อน deploy ส่งออก API key หมายเลขผู้โทรที่เชื่อมต่อแล้ว และผู้รับสำหรับทดสอบของคุณตามที่ระบุใน README ที่สร้างขึ้น npm run deploy หรือ python deploy.py จะสร้างหรืออัปเดตเอเจนต์ deploy ฉบับร่าง และโทรทดสอบที่มีค่าใช้จ่าย สคริปต์ใช้การยืนยันตัวตนด้วย API key ส่วน CLI และตัวครอบ MCP แบบ stdio รองรับการเข้าสู่ระบบด้วยอุปกรณ์เช่นกัน สคริปต์ Python ต้องใช้ Python 3.9 หรือใหม่กว่า