Open in
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 workTHUNDERPHONE_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 หรือใหม่กว่า