মূল ধারণাসমূহ

ThunderPhone হলো AI ভয়েস এজেন্ট তৈরি, পরিচালনা এবং উন্নত করার একটি পূর্ণাঙ্গ প্ল্যাটফর্ম। এই পৃষ্ঠাটি একটি মানচিত্র: আপনি যেসব ধারণার মুখোমুখি হবেন, প্রতিটির জন্য একটি সংক্ষিপ্ত অংশ, সঙ্গে ড্যাশবোর্ডের সংশ্লিষ্ট অংশ এবং সেটির পেছনের API। একবার দ্রুত দেখে নিন, তারপর কোনো শব্দের ব্যাখ্যা দরকার হলে আবার ফিরে আসুন।

ড্যাশবোর্ডের সাইডবার এই কাঠামোটিই অনুসরণ করে:

সংস্থাসমূহ

একটি সংস্থা হলো টেন্যান্সির একক। অন্যান্য প্রতিটি রিসোর্স — এজেন্ট, ফোন নম্বর, কল, কী — ঠিক একটি সংস্থার অন্তর্ভুক্ত। আপনার অ্যাকাউন্ট একাধিক সংস্থার অন্তর্ভুক্ত হতে পারে; প্রতিটির নিজস্ব ব্যালান্স, নিজস্ব কী এবং নিজস্ব সদস্য তালিকা রয়েছে।

সংস্থা → কীসমূহ-এর অধীনে আপনার তৈরি করা sk_live_ API কী একটি সংস্থার সঙ্গে আবদ্ধ থাকে। এই আবদ্ধতাই REST API-কে এত সরল করে: আপনাকে কখনও URL পাথে org id দিতে হয় না, কারণ আপনার কী ইতিমধ্যেই এটি শনাক্ত করে।

ড্যাশবোর্ডে: সংস্থা সুইচার (সাইডবার ফুটার) এবং সংস্থা সেটিংস — আমার অ্যাকাউন্ট, সাধারণ, কীসমূহ, সতর্কতা, বিলিং সেটিংস এবং বিলিং ইতিহাসের ট্যাব। দেখুন সংস্থা সেটিংস রেফারেন্স।

API-তে: /v1/orgs, /v1/developer/api-keys।

এজেন্ট

একটি এজেন্ট হলো সেই AI কনফিগারেশন যা একটি কল পরিচালনা করে। এতে অন্তর্ভুক্ত থাকে:

• একটি prompt, যা এজেন্ট কী বলবে এবং কীভাবে আচরণ করবে তা নিয়ন্ত্রণ করে — ট্রান্সফার, কীপ্যাড প্রেস এবং কল শেষ করার মতো কল অ্যাকশনসহ, যেগুলো আলাদা কনফিগারেশনের পরিবর্তে সাধারণ prompt লাইন।
• একটি ইঞ্জিন টিয়ার (spark, bolt, storm-*): Spark খরচের জন্য অপ্টিমাইজ করা, Bolt গতির জন্য, এবং Storm জটিল prompt-এ বুদ্ধিমত্তার জন্য।
• একটি ভয়েস, একটি প্রাথমিক ভাষা এবং ঐচ্ছিক অতিরিক্ত ভাষা — কলার ভাষা পরিবর্তন করলে এজেন্ট স্বয়ংক্রিয়ভাবে পরিবর্তন করে। দেখুন সমর্থিত ভাষাসমূহ।
• সংযুক্ত সক্ষমতা: সংযুক্ত অ্যাপ, API সংযোগ, জ্ঞানভান্ডার, MCP সার্ভার, এবং ইনলাইন ফাংশন টুল।
• আচরণের নিয়ন্ত্রণ: কথনের ক্রম, স্বীকৃতি মোড, ব্যাকগ্রাউন্ড ট্র্যাক, হোল্ড টাইমআউট।

বিল্ডারে করা সম্পাদনাগুলো স্বয়ংক্রিয়ভাবে একটি ড্রাফটে সংরক্ষিত হয়; আপনি মোতায়েন করুন ক্লিক না করা পর্যন্ত কিছুই লাইভ হয় না। প্রতিটি মোতায়েন বিল্ডারের ইতিহাস ট্যাবে স্ন্যাপশট হিসেবে সংরক্ষিত হয়, যাতে আপনি আগের যেকোনো সংস্করণ পরিদর্শন ও পুনরুদ্ধার করতে পারেন।

ড্যাশবোর্ডে: ভয়েস এজেন্টসমূহ → এজেন্ট বিল্ডার (/dashboard/agents)। দেখুন আপনার প্রথম ভয়েস এজেন্ট তৈরি করুন।

API-তে: /v1/agents — CRUD, ডুপ্লিকেট, ট্রান্সফার, সংস্করণ ইতিহাস এবং prompt সহায়ক।

ভয়েস

ভয়েস লাইব্রেরিতে এজেন্ট ব্যবহার করতে পারে এমন ভয়েস, সেগুলোর প্লে করা যায় এমন নমুনা, সামঞ্জস্যপূর্ণ ভাষা, লিঙ্গ ও উচ্চারণভিত্তিক গ্রুপিং, এবং যেকোনো প্রিমিয়াম ভয়েস/ভাষার অতিরিক্ত মূল্য থাকে। আপনি বেছে নেওয়ার আগে একটি পেইড স্যাম্পলার আপনার নিজস্ব 1–500 অক্ষরের বাক্য সংশ্লেষ করতে পারে।

যোগ্য সংস্থাগুলো একটি ছোট WAV বা MP3 নমুনা থেকে কাস্টম ভয়েসও তৈরি করতে পারে। কাস্টম ভয়েসের একটি কোটা এবং অ্যাসিঙ্ক্রোনাস তৈরির অবস্থা থাকে; প্রস্তুত হলে, সেগুলো লাইব্রেরি ভয়েসের মতো একই এজেন্ট পিকারে দেখা যায়।

ড্যাশবোর্ডে: ভয়েস (/dashboard/voices)। দেখুন ভয়েস লাইব্রেরি এবং কাস্টম ভয়েস।

API-তে: /v1/voices, ভয়েস নমুনা, এবং কাস্টম ভয়েস।

ফোন নম্বর

একটি ফোন নম্বর একটি সংস্থার অন্তর্গত এবং ইনবাউন্ড কল একটি এজেন্টের কাছে রুট করে (এবং আউটবাউন্ড কল বহন করতে পারে)। দুটি উৎস:

• ডেমো নম্বর — ThunderPhone-এর পুল থেকে প্রভিশন করা বাস্তব মার্কিন নম্বর, কয়েক সেকেন্ডের মধ্যে লাইভ হয়। শুধু ইনবাউন্ডের জন্য, এগুলো একটি সংক্ষিপ্ত কথ্য ডিসক্লেইমার দিয়ে উত্তর দেয়, এবং ড্যাশবোর্ড একটি সংস্থার জন্য সর্বোচ্চ 10টি সীমাবদ্ধ রাখে। প্রথম পরীক্ষার জন্য উপযুক্ত; প্রোডাকশনের জন্য নয়।
• VoIP নম্বর — একটি VoIP সংযোগ-এর মাধ্যমে আপনার নিজস্ব প্রোভাইডার থেকে আনা। Twilio এবং Telnyx সরাসরি সংযুক্ত হয় (Telnyx-এ একটি নির্দেশিত সেটআপ রয়েছে); SignalWire এবং Vonage শিগগিরই আসছে — আজ আপনি ম্যানুয়াল SIP কনফিগারেশনের মাধ্যমে সেগুলোতে পৌঁছাতে পারেন, যা যেকোনো SIP ট্রাঙ্ক গ্রহণ করে। ইমপোর্ট ও যাচাই হয়ে গেলে, VoIP নম্বর ইনবাউন্ড এবং আউটবাউন্ড সমর্থন করে।

প্রতিটি নম্বর সারি আপনাকে একটি রাউটিং মোড সেট করতে, ইনবাউন্ড এজেন্ট বেছে নিতে, এবং নম্বরটিতে লেবেল দিতে দেয়।

ড্যাশবোর্ডে: ফোন নম্বর (/dashboard/phone-numbers)। দেখুন একটি ফোন নম্বর নিন।

API-তে: /v1/phone-numbers, /v1/voip-connections, /v1/phone-number-labels।

কল

প্রতিটি ইনবাউন্ড কল, আউটবাউন্ড কল, সিমুলেশন এবং উইজেট সেশন একটি কল লগে পরিণত হয়। একটি কলে সম্পূর্ণ ভূমিকা-ট্যাগযুক্ত ট্রান্সক্রিপ্ট, কাঠামোবদ্ধ টার্ন ইতিহাস (টুল কলসহ), একটি রেকর্ডিং, বিলিংয়ের মোট পরিমাণ, এবং ঐচ্ছিক AI গ্রেডিং ও সমস্যা প্রতিবেদন থাকে।

একটি কল লাইভ থাকা অবস্থায়, আপনি এটি খুলে নিঃশব্দে শুনতে পারেন — আপনি নিঃশব্দে যুক্ত হন, এবং কলে থাকা কেউ আপনাকে শুনতে পায় না। শোনা শুরু করার পর, আপনি ফিসফিস করতে পারেন: কলের মাঝখানে সরাসরি আপনার এজেন্টের কাছে যাওয়া একটি নির্দেশ লিখুন; কলার এটি কখনও শুনতে পায় না, এবং এজেন্ট লাইভ অবস্থায় এটি অনুসরণ করে।

ড্যাশবোর্ডে: আর্কাইভ এবং প্রতিটি কলের বিস্তারিতের জন্য কলের ইতিহাস (/dashboard/call-history); চলমান কলের জন্য লাইভ। দেখুন আপনার কল পর্যালোচনা করুন, শুনুন এবং নির্দেশনা দিন।

API-তে: /v1/calls — তালিকা, ট্রান্সক্রিপ্ট, ইতিহাস, অডিও, গ্রেডিং, এক্সপোর্ট; /v1/issue-reports।

ক্লায়েন্ট পোর্টাল

একটি ক্লায়েন্ট পোর্টাল হলো বাহ্যিক ক্লায়েন্টের জন্য ব্র্যান্ডযুক্ত, শুধু-পঠনযোগ্য কল-ইতিহাস ভিউ। সংস্থার অ্যাডমিনরা যেসব এজেন্টের কল দেখা যাবে সেগুলো বেছে নেন, অনুমোদিত ভিউয়ার ইমেল যোগ করেন, একটি লোগো ও অ্যাকসেন্ট রং আপলোড করেন, এবং ঐচ্ছিকভাবে একটি কাস্টম ডোমেইন যাচাই করেন। পোর্টাল ভিউয়াররা ড্যাশবোর্ডে প্রবেশাধিকার না পেয়েও কলের বিস্তারিত, ট্রান্সক্রিপ্ট এবং উপলভ্য রেকর্ডিং পরিদর্শন করতে পারেন।

ড্যাশবোর্ডে: ক্লায়েন্ট পোর্টাল (/dashboard/client-portals)। দেখুন ক্লায়েন্ট পোর্টাল।

API-তে: অ্যাডমিন ব্যবস্থাপনা পৃষ্ঠের জন্য /v1/client-portals।

ওয়েব উইজেট

ওয়েব উইজেট আপনার সাইটের দর্শকদের এজেন্টের সঙ্গে মাইক-ভিত্তিক কথোপকথনের সুবিধা দেয় — কোনো ফোন নম্বরের প্রয়োজন নেই। এটি একটি প্রকাশযোগ্য কী (pk_live_...) দিয়ে প্রমাণীকরণ করে, যা আপনার অনুমোদিত ডোমেইনের জন্য অরিজিন-লক করা থাকে, তাই এটি ক্লায়েন্ট-সাইড কোডে ব্যবহার করা নিরাপদ।

কীগুলো দুটি মোডের একটিতে কাজ করে: agent (একটি এজেন্টের সঙ্গে স্থিরভাবে সংযুক্ত) অথবা webhook (আপনার সার্ভার প্রতি দর্শকের জন্য কনফিগারেশন নির্বাচন করে — দেখুন প্রতি-কলে ডায়নামিক কনফিগারেশন)। উইজেট সেশনগুলো ফোন কলের মতো একই কল অবকাঠামোর মাধ্যমে পরিচালিত হয়।

ড্যাশবোর্ডে: ওয়েব উইজেট (/dashboard/web-widgets) — উইজেট তৈরি করুন, মোড ও এজেন্ট সেট করুন, অনুমোদিত ডোমেইন পরিচালনা করুন এবং এমবেড স্নিপেট কপি করুন। দেখুন একটি ওয়েব উইজেট তৈরি করুন।

API-তে: /v1/publishable-key, /v1/mic-session, এবং উইজেট SDK ডকুমেন্টেশন।

জ্ঞানভান্ডার

একটি জ্ঞানভান্ডার হলো এমন নথির সমষ্টি যা আপনার এজেন্ট কল চলাকালে উত্তরকে প্রাসঙ্গিক করতে অনুসন্ধান করতে পারে — ফাইল আপলোড করুন, টেক্সট পেস্ট করুন বা URL দিয়ে ওয়েব পৃষ্ঠা ইমপোর্ট করুন, তারপর বিল্ডারে জ্ঞানভান্ডারটি একটি এজেন্টের সঙ্গে সংযুক্ত করুন। কথোপকথনের প্রয়োজন হলে এজেন্ট অন্তর্নির্মিত সার্চ টুল ব্যবহার করে এতে অনুসন্ধান করে।

ড্যাশবোর্ডে: নথি লাইব্রেরির জন্য জ্ঞান (/dashboard/knowledge); এজেন্টের সঙ্গে সংযুক্ত করার জন্য বিল্ডারের জ্ঞান বিভাগ। দেখুন আপনার এজেন্টকে একটি জ্ঞানভান্ডার দিন।

সংযোগ

সংযোগের মাধ্যমে এজেন্ট বাইরের বিশ্বের সঙ্গে যুক্ত হয়। চার ধরনের সংযোগ, একটিই সাইডবার গ্রুপ:

• অ্যাপ (/dashboard/app-connections) — Slack, HubSpot, Salesforce, Google Calendar, Google Sheets এবং Cal.com-এর সঙ্গে OAuth সংযোগ। একবার সংযুক্ত করুন, তারপর প্রতি-অপারেশন টুল (একটি Slack বার্তা পোস্ট করা, একটি HubSpot কনট্যাক্ট আপসার্ট করা, একটি Cal.com স্লট বুক করা…) যেকোনো এজেন্টে টগল করুন। দেখুন অ্যাপ সংযুক্ত করুন।
• API (/dashboard/api-connections) — যেকোনো HTTP API-কে এজেন্ট অ্যাকশনে রূপান্তর করুন। একটি cURL কমান্ড পেস্ট করুন এবং AI উইজার্ড টুলের সংজ্ঞার খসড়া তৈরি করবে, অথবা নিজে তৈরি করুন; পাঠানোর আগে একটি পরীক্ষামূলক অনুরোধ বোতাম স্যান্ডবক্স কল চালায়। দেখুন API সংযোগ — এটি /v1/integrations-এর ড্যাশবোর্ড সংস্করণ।
• MCP (/dashboard/mcp-connections) — URL দিয়ে একটি মডেল কনটেক্সট প্রোটোকল সার্ভার যোগ করুন এবং এজেন্টকে এর উন্মুক্ত করা টুলগুলো ব্যবহার করতে দিন। দেখুন একটি MCP সার্ভার যোগ করুন।
• VoIP (/dashboard/voip-connections) — নিজস্ব ফোন নম্বর ব্যবহারের জন্য প্রোভাইডার শংসাপত্র। দেখুন একটি VoIP প্রোভাইডার সংযুক্ত করুন।

ThunderPhone নিজস্ব MCP এন্ডপয়েন্টও সরবরাহ করে, যাতে একটি বাহ্যিক MCP ক্লায়েন্ট এজেন্টের তালিকা দেখতে, কল ও ট্রান্সক্রিপ্ট পরিদর্শন করতে এবং কল করতে পারে। দেখুন ThunderPhone-কে MCP সার্ভার হিসেবে ব্যবহার করুন।

API-তে: /v1/integrations, /v1/mcp-servers, এবং /v1/voip-connections; আরও দেখুন একটি টুল ইন্টিগ্রেশন তৈরি করুন।

ক্যাম্পেইন

একটি ক্যাম্পেইন বৃহৎ পরিসরে আউটবাউন্ড কল করে: কনট্যাক্টের একটি CSV আপলোড করুন, এজেন্ট ও প্রেরক নম্বর নির্বাচন করুন, এবং কলের সময়সীমা (দিন ও ঘণ্টা, টাইমজোন-সচেতন), সমকালীনতা এবং পুনরায় চেষ্টার নীতি (সর্বোচ্চ প্রচেষ্টা ও কোন ফলাফল — উত্তর নেই, ভয়েসমেল, ব্যর্থ — পুনরায় চেষ্টা করা হবে) সেট করুন। ক্যাম্পেইন তালিকাটি ধরে এগোয় এবং কল ইতিহাসে প্রতিটি কল রেকর্ড করে।

ড্যাশবোর্ডে: ক্যাম্পেইন (/dashboard/campaigns)। দেখুন একটি আউটবাউন্ড কলিং ক্যাম্পেইন চালান।

এককালীন প্রোগ্রাম্যাটিক কলের জন্য: আউটবাউন্ড কল API।

লাইভ মনিটরিং

লাইভ প্রতিষ্ঠানের জুড়ে চলমান প্রতিটি কল দেখায় এবং আপনাকে সেগুলোর যেকোনোটি খুলে রিয়েল টাইমে কল শুনতে এবং ফিসফিস করতে দেয়। এটি তত্ত্বাবধানের ইন্টারফেস: একটি নতুন prompt-এর প্রথম বাস্তব ট্র্যাফিক দেখুন, অথবা চলমান একটি ক্যাম্পেইনের ওপর নজর রাখুন।

ড্যাশবোর্ডে: লাইভ (/dashboard/live)। দেখুন লাইভ কল পর্যবেক্ষণ ও তত্ত্বাবধান করুন।

সিমুলেশন

একটি সিমুলেশন হলো একজন AI কলার আপনার এজেন্টের সঙ্গে বাস্তব কথোপকথন করছে — একই টেলিফোনি পথ, বাস্তব ট্রান্সক্রিপ্ট, বাস্তব গ্রেডিং — যাতে আপনি প্রকাশের আগে (এবং পরে) পরীক্ষা করতে পারেন। এটি একটি এজেন্ট বা ফোন নম্বর লক্ষ্য করে সেট করুন, কলার সিনারিও নিজে লিখুন অথবা এজেন্টের prompt থেকে AI দিয়ে সিনারিও তৈরি করুন (আপনি চাইলে এজ কেসসহ), এবং কলটি লাইভ দেখুন।

সিনারিওগুলো স্যুটে গোষ্ঠীবদ্ধ হয়, যা একটি ন্যূনতম পাস রেট স্থির করে এবং CI-তে রিলিজ আটকে দিতে পারে; গৃহীত বেসলাইনের তুলনায় রিগ্রেশন প্রতিটি সিনারিও অনুযায়ী রিপোর্ট করা হয়।

ড্যাশবোর্ডে: সিমুলেশন (/dashboard/simulations), পাশাপাশি এজেন্ট বিল্ডারের ভেতরে সিমুলেশন বোতাম। দেখুন একটি কল সিমুলেট করুন।

API-তে: /v1/test-calls এবং স্যুট রানার — দেখুন একটি এজেন্টকে এন্ড-টু-এন্ড পরীক্ষা করুন।

যাচাইকরণ সেট

একটি যাচাইকরণ সেট বাস্তব কলের মুহূর্তগুলোকে পুনরাবৃত্তিযোগ্য, একক-টার্ন রিগ্রেশন যাচাইয়ে রূপান্তর করে। প্রতিটি উদাহরণ কথোপকথনের প্রসঙ্গ, প্রাসঙ্গিক কলার অডিও, মূল প্রতিক্রিয়া এবং প্রত্যাশিত আচরণ স্থিরভাবে সংরক্ষণ করে। অন্য কোনো কল না করেই বর্তমান এজেন্ট ড্রাফটের বিপরীতে রিপ্লে চালানো হয়, এবং ডিপ্লয় ডায়ালগ দেখাতে পারে যে সর্বশেষ রানটি এখনও সেই ড্রাফটের সঙ্গে মেলে কি না।

ড্যাশবোর্ডে: প্রতিষ্ঠান ডেটাসেটের জন্য যাচাইকরণ সেট (/dashboard/validation) এবং রানগুলোর জন্য এজেন্ট বিল্ডারের যাচাইকরণ ট্যাব। দেখুন যাচাইকরণ সেট।

API-তে: /v1/validation-sets এবং একই রেফারেন্স পৃষ্ঠায় এজেন্ট/উদাহরণ রিপ্লে এন্ডপয়েন্ট।

পরীক্ষা

একটি পরীক্ষা লাইভ ট্র্যাফিকে এজেন্ট কনফিগারেশনের A/B পরীক্ষা করে: ভ্যারিয়েন্ট নির্ধারণ করুন (ভিন্ন prompt, ইঞ্জিন বা সেটিংস), তাদের মধ্যে ট্র্যাফিক ভাগ করুন এবং প্রতি ভ্যারিয়েন্টে ফলাফল তুলনা করুন। webhook-এ নিজে বাকেট লজিক তৈরি করার পরিবর্তে এটি ব্যবহার করুন।

ড্যাশবোর্ডে: পরীক্ষা (/dashboard/experiments) এবং এজেন্ট বিল্ডারের A/B ট্যাব। দেখুন পরীক্ষা (A/B টেস্টিং)।

সমস্যা

একটি সমস্যা হলো নির্দিষ্ট একটি কলে চিহ্নিত সমস্যা — মানব পর্যালোচক দ্বারা দাখিল করা বা AI গ্রেডিং দ্বারা শনাক্ত করা। সমস্যাগুলোতে তীব্রতা, উৎস এবং স্থিতি থাকে, আর সমস্যা পৃষ্ঠাটি হলো ট্রায়াজ সারি: ফিল্টার করুন, সমস্যাযুক্ত কল পরীক্ষা করুন এবং সমাধান ট্র্যাক করুন।

ড্যাশবোর্ডে: সমস্যা (/dashboard/issues), পাশাপাশি কল ইতিহাসে প্রতি-কলে ফ্ল্যাগ করার সুবিধা। দেখুন সমস্যা ট্রায়াজ।

API-তে: /v1/issue-reports।

রিপোর্ট

একটি রিপোর্ট আপনার কল ডেটা সম্পর্কে একটি স্বাভাবিক ভাষার প্রশ্নের ("গত সপ্তাহে কলাররা একজন মানুষের সঙ্গে কথা বলতে চাওয়ার শীর্ষ তিনটি কারণ কী ছিল?") উত্তর দেয় AI-লিখিত বিশ্লেষণের মাধ্যমে, যা আপনার বেছে নেওয়া এজেন্ট ও তারিখ পরিসরে সীমাবদ্ধ থাকে।

ড্যাশবোর্ডে: রিপোর্ট (/dashboard/reports)। দেখুন রিপোর্ট।

অবজারভেবিলিটি

অবজারভেবিলিটি হলো মেট্রিক্স ইন্টারফেস: সময়ের সঙ্গে কলের পরিমাণ, ফলাফল এবং গুণমান, যা এজেন্ট ও সময় উইন্ডো অনুযায়ী ফিল্টার করা যায় এবং পরবর্তী বিশ্লেষণের জন্য এক্সপোর্ট করা যায়।

ড্যাশবোর্ডে: অবজারভেবিলিটি (/dashboard/observability)। দেখুন অবজারভেবিলিটি।

সতর্কতা

একটি সতর্কতা নিয়ম একটি সময় উইন্ডো জুড়ে একটি মেট্রিক (সাফল্যের হার, ব্যর্থতার হার, গড় স্কোর, কলের পরিমাণ, স্যুট রিগ্রেশন) পর্যবেক্ষণ করে এবং সেটি আপনার থ্রেশহোল্ড অতিক্রম করলে ট্রিগার হয়। বিজ্ঞপ্তি ইমেইল ও Slack-এ যায় এবং আপনার webhook এন্ডপয়েন্টে একটি alert.triggered ইভেন্ট ট্রিগার করে।

ড্যাশবোর্ডে: প্রতিষ্ঠান → সতর্কতা। দেখুন সতর্কতা。

ওয়েবহুক

কলে চলাকালীন এবং কলের পরে কিছু ঘটলে ThunderPhone আপনার সার্ভারে HTTP POST ওয়েবহুক পাঠায়। দুটি ডেলিভারি মডেল:

• ওয়েবহুক এন্ডপয়েন্ট (প্রস্তাবিত): প্রতি-এন্ডপয়েন্ট সিক্রেট এবং প্রতি-এন্ডপয়েন্ট ইভেন্ট সাবস্ক্রিপশনসহ একাধিক URL পরিচালনা করুন /v1/developer/webhook-endpoints-এ।
• লিগ্যাসি একক-URL ওয়েবহুক: প্রতি প্রতিষ্ঠানের জন্য একটি URL। পরিচালিত হয় /v1/webhook-এ অথবা প্রতিষ্ঠান → সাধারণ-এর অধীনে। পশ্চাৎ-সামঞ্জস্যের জন্য রাখা হয়েছে।

ইভেন্ট দুটি শ্রেণিতে বিভক্ত:

• ব্লকিং ইভেন্টে আপনার সার্ভারকে এমন কনফিগারেশনসহ সাড়া দিতে হয় যা চলমান কলকে প্রভাবিত করে — অর্থাৎ ইনকামিং-কল ইভেন্ট (telephony.incoming / web.incoming)। সাড়া দেওয়ার জন্য আপনার কাছে সর্বোচ্চ 10 সেকেন্ড সময় থাকে; সময়সীমা শেষ হলে স্ট্যাটিকভাবে নির্ধারিত এজেন্ট কলটি পরিচালনা করে।
• নন-ব্লকিং ইভেন্ট ফায়ার-অ্যান্ড-ফরগেট নোটিফিকেশন, যা এক্সপোনেনশিয়াল ব্যাকঅফসহ পুনরায় চেষ্টা করা হয় — দেখুন ডেলিভারি সিম্যান্টিকস।

প্রতিটি অনুরোধে X-ThunderPhone-Signature-এ একটি HMAC-SHA256 স্বাক্ষর থাকে। দেখুন স্বাক্ষর যাচাইকরণ।

ফাংশন টুল

একটি ফাংশন টুল হলো এমন একটি HTTP এন্ডপয়েন্ট যা আপনার এজেন্ট কথোপকথনের মাঝখানে কল করতে পারে। আপনি ThunderPhone-কে একটি OpenAI-ধাঁচের ফাংশন স্কিমা এবং একটি এন্ডপয়েন্ট URL দেন; এজেন্ট কখন এটি কল করবে তা নির্ধারণ করে, এবং ThunderPhone তার সার্ভার থেকে স্বাক্ষরিত HTTP অনুরোধ পাঠিয়ে ফলাফলটি এজেন্টের কাছে ফিরিয়ে দেয়।

এজেন্টে অন্তর্নির্মিত কল সক্ষমতাও থাকে — কল ট্রান্সফার করা, কীপ্যাড (DTMF) ইনপুট পাঠানো, কল শেষ করা, হোল্ডে অপেক্ষা করা — যেগুলো আপনি টুল সংজ্ঞার বদলে সাধারণ prompt লাইনের মাধ্যমে সক্রিয় করেন।

ড্যাশবোর্ডে: বিল্ডারের API সংযোগ বিভাগে (দেখুন সংযোগ)।

API-তে: /v1/integrations এবং ফাংশন টুল স্পেসিফিকেশন।

দল এবং ভূমিকা

প্রতিটি প্রতিষ্ঠানে দুটি ভূমিকা সহ একটি সদস্য তালিকা থাকে: সদস্যরা এজেন্ট তৈরি ও পরিচালনা করেন; অ্যাডমিনরা দল এবং বিলিংও পরিচালনা করেন। ইমেলের মাধ্যমে আমন্ত্রণ জানান — আমন্ত্রণের মেয়াদ 7 দিন পরে শেষ হয় এবং তা বাতিল করা যায়; কোনো সদস্য সারির ⋯ মেনু থেকে ভূমিকা পরিবর্তন বা কাউকে অপসারণ করা যায়। একক সাইন-অন প্রতিষ্ঠানজুড়ে কনফিগার করা যায় — দেখুন SSO।

ড্যাশবোর্ডে: প্রতিষ্ঠান → সাধারণ। দেখুন আপনার দলকে আমন্ত্রণ জানান।

API-তে: /v1/members, /v1/invites।

বিলিং

ThunderPhone প্রিপেইড। প্রতিটি প্রতিষ্ঠানের একটি USD ব্যালেন্স থাকে; এজেন্টের প্রতি-মিনিট রেটে কল থেকে তা কেটে নেওয়া হয় (ইঞ্জিন স্তর এবং সারচার্জ — সেটিংস পরিবর্তনের সঙ্গে বিল্ডার তাৎক্ষণিকভাবে সর্বমোট রেট দেখায়, এবং নির্বাচিত অতিরিক্ত ভাষা 3¢/মিনিট যোগ করে)। ব্যালেন্স শূন্যে পৌঁছালে ইনবাউন্ড কল প্রত্যাখ্যান করা হয় এবং আউটবাউন্ড কল 402 Payment Required ফেরত দেয়।

ম্যানুয়ালি ব্যালেন্স যোগ করুন, অথবা একটি ব্যালেন্স সীমা, রিফিলের পরিমাণ এবং ঐচ্ছিক মাসিক ব্যয়সীমাসহ স্বয়ংক্রিয় ব্যালেন্স যোগ সক্রিয় করুন — যাতে কোনো কল বাক্যের মাঝখানে কখনও বন্ধ না হয়।

ড্যাশবোর্ডে: প্রতিষ্ঠান → বিলিং সেটিংস এবং বিলিং ইতিহাস। দেখুন অর্থ যোগ করুন এবং স্বয়ংক্রিয় ব্যালেন্স যোগ চালু করুন, পাশাপাশি সম্পূর্ণ মূল্যতালিকা রেফারেন্স।

API-তে: /v1/billing।

অ্যাপের অভ্যন্তরীণ কোপাইলট

ড্যাশবোর্ডে একটি অন্তর্নির্মিত কোপাইলট রয়েছে — তাকে জিজ্ঞাসা করুন "আমি কীভাবে X করব" এবং এটি এই ডকুমেন্টেশন থেকে উত্তর দেয়, প্রকৃত নিয়ন্ত্রণগুলোকে হাইলাইট করে এমন ক্লিক-ধাপে নির্দেশনা দেয়, এবং যেকোনো গাইডেড ট্যুর পুনরায় চালাতে পারে। এই পাতায় উল্লেখিত কোনো নিয়ন্ত্রণ খুঁজে পাওয়ার এটিই দ্রুততম উপায়। দেখুন অ্যাপের অভ্যন্তরীণ কোপাইলটকে জিজ্ঞাসা করুন。

সবকিছু একসঙ্গে