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 ব্যবহার করুন এবং অন্য কোথাও প্রদর্শিত 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 work

THUNDERPHONE_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 UUIDSMS রেকর্ডের তালিকা দেখুন বা পরিদর্শন করুন
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 বা পরবর্তী সংস্করণ প্রয়োজন।