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 ব্যবহার করুন এবং অন্য কোথাও প্রদর্শিত URL খুলুন।
ডিভাইস লগ ইন-এর জন্য API-এর OAuth ডিভাইস-ফ্লো রোলআউট প্রয়োজন। THUNDERPHONE_API_KEY-এ থাকা একটি সংস্থার API
কী দিয়েও কমান্ড প্রমাণীকরণ করা যায় এবং এটি সংরক্ষিত লগ ইন শংসাপত্রের চেয়ে অগ্রাধিকার পায়।
শংসাপত্র প্রোফাইল অনুযায়ী ~/.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-এর জন্য --api-base-url বা THUNDERPHONE_API_BASE_URL ব্যবহার করুন। একটি প্রোফাইলের টোকেন
ভিন্ন কনফিগার করা API URL-এ পাঠানো যায় না; আলাদা প্রোফাইল দিয়ে সেই URL-এ লগ ইন করুন।
কমান্ড
প্রতিটি কমান্ড --json গ্রহণ করে। সফল ডেটা stdout-এ যায়; ত্রুটি শূন্য-বহির্ভূত এক্সিট কোডসহ stderr-এ যায়।
--json ছাড়া, আউটপুট একটি সংক্ষিপ্ত টেবিল বা ফিল্ড তালিকা হয়।
JSON API প্রতিক্রিয়ার কাঠামো বজায় রাখে, তবে ক্রেডেনশিয়াল ফিল্ডগুলো গোপন করা থাকে। MCP সার্ভিং
MCP প্রোটোকলের জন্য stdout সংরক্ষিত রাখে।
| কমান্ড | উদ্দেশ্য |
|---|---|
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 | একটি US ইনবাউন্ড নম্বর প্রভিশন করুন |
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-এর জন্য আপনার সংযুক্ত Twilio বা Telnyx অ্যাকাউন্টে SMS-সক্ষম একটি নম্বরও প্রয়োজন। এটি কখনোই ThunderPhone-এর মালিকানাধীন নম্বর থেকে পাঠায় না। একই প্রেরক, প্রাপক এবং বডি পুনরায় পাঠানোর সময়ই কেবল একটি আইডেমপোটেন্সি কী পুনর্ব্যবহার করুন।
ইমপোর্ট 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-এর জন্য user স্কোপ প্রয়োজন।
প্রজেক্ট থেকে একটি একক ক্লায়েন্ট শনাক্ত করতে --client বাদ দিন; শনাক্তকরণ অস্পষ্ট হলে
ইন্টারঅ্যাকটিভভাবে prompt দেখায় অথবা নন-ইন্টারঅ্যাকটিভ সেশনে নির্দেশনাসহ ব্যর্থ হয়।
সেটআপ যে ফাইলটিতে লিখেছে তা দেখায় এবং সম্পর্কহীন সার্ভারগুলো সংরক্ষণ করে। বিদ্যমান JSON
অবশ্যই বৈধ কঠোর JSON হতে হবে; Codex TOML মান সংরক্ষণ করা হয়, তবে মন্তব্য পুনর্বিন্যস্ত হতে পারে।
সেটআপ সরাসরি রিমোট HTTP-কে অগ্রাধিকার দেয়। --api-key-env ব্যবহার করলে এটি কখনোই কী নয়,
একটি ভেরিয়েবল রেফারেন্স লেখে। এই বিকল্প ছাড়া, সরাসরি HTTP ক্লায়েন্টের
OAuth সমর্থনের ওপর নির্ভর করে; এটি CLI ক্রেডেনশিয়াল ফাইল ব্যবহার করে না। যেকোনো stdio-সক্ষম ক্লায়েন্টে
thunderphone login ক্রেডেনশিয়াল পুনরায় ব্যবহার করতে, ব্যবহার করুন:
{
"mcpServers": {
"thunderphone": {
"command": "npx",
"args": ["-y", "@thunderphone/mcp"]
}
}
}র্যাপার প্রথমে THUNDERPHONE_API_KEY, তারপর বর্তমান CLI প্রোফাইল পরীক্ষা করে (প্রয়োজনে রিফ্রেশ করে),
তারপর OAuth mcp-remote-এ অর্পণ করে। THUNDERPHONE_MCP_URL এন্ডপয়েন্ট ওভাররাইড করে।
এটি কোনো টেলিমেট্রি পাঠায় না। স্বতন্ত্র সেটআপ npx -y @thunderphone/mcp setup --client cursor অথবা
@thunderphone/mcp গ্লোবালি ইনস্টল করার পর thunderphone-mcp setup দিয়েও উপলব্ধ।
একটি প্রজেক্ট তৈরি করুন
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, ডিপ্লয় স্ক্রিপ্ট, Claude Code, Cursor এবং VS Code-এর জন্য MCP কনফিগারেশন,
এজেন্ট নির্দেশনা, .env.example, এবং একটি README অন্তর্ভুক্ত থাকে।
স্ক্যাফোল্ডিং অফলাইন এবং খালি নয় এমন ডিরেক্টরি ওভাররাইট করতে অস্বীকার করে।
ডিপ্লয়ের আগে ব্যবসায়িক তথ্য সম্পাদনা করুন। তৈরি হওয়া README-তে নথিভুক্ত অনুযায়ী API কী, সংযুক্ত কলার
নম্বর এবং আপনার পরীক্ষার প্রাপক এক্সপোর্ট করুন। npm run deploy
অথবা python deploy.py এজেন্ট তৈরি বা আপডেট করে, এর ড্রাফট ডিপ্লয় করে এবং একটি
বিলযোগ্য পরীক্ষামূলক কল করে। স্ক্রিপ্টগুলো API-কী প্রমাণীকরণ ব্যবহার করে; CLI এবং stdio MCP
র্যাপার ডিভাইস লগইনও সমর্থন করে। Python স্ক্রিপ্টের জন্য Python 3.9 বা পরবর্তী সংস্করণ প্রয়োজন।