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

প্ল্যাটফর্মের সবকিছুর একটি মানচিত্র — প্রতিটি অবজেক্ট কী করে, ড্যাশবোর্ডে এটি কোথায় থাকে এবং কোন API এটিকে ব্যবহার করে।

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 নম্বর — ThunderPhone-এর পুল থেকে প্রভিশন করা প্রকৃত মার্কিন নম্বর, যা কয়েক সেকেন্ডে চালু হয়, $1/মাস এবং 1¢/মিনিট অতিরিক্ত চার্জ। শুধু ইনবাউন্ড; আউটবাউন্ডের জন্য আপনার নিজস্ব ক্যারিয়ার প্রয়োজন। একটি সংস্থা ডিফল্টভাবে 25টি রাখতে পারে।
• 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_...) দিয়ে প্রমাণীকরণ করে, যা আপনার অনুমোদিত ডোমেনগুলোর জন্য origin-locked থাকে, তাই ক্লায়েন্ট-সাইড কোডে এটি নিরাপদ।

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

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

API-তে: /v1/publishable-key, /v1/mic-session, এবং Widget 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 দিয়ে একটি Model Context Protocol সার্ভার যোগ করুন এবং এজেন্টকে এর উন্মুক্ত করা টুলগুলো ব্যবহার করতে দিন। দেখুন একটি 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 দিয়ে পরিস্থিতি তৈরি করুন (আপনি চাইলে edge case-সহ), এবং কলটি লাইভ দেখুন।

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

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

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

ভ্যালিডেশন সেট#

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

ড্যাশবোর্ডে: সংস্থার ডেটাসেটের জন্য ভ্যালিডেশন সেট (/dashboard/validation) এবং রানগুলোর জন্য এজেন্ট বিল্ডারের ভ্যালিডেশন ট্যাব। দেখুন ভ্যালিডেশন সেট।

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

পরীক্ষাসমূহ#

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

ড্যাশবোর্ডে: পরীক্ষাসমূহ (/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 করব" এবং এটি এই ডকুমেন্টেশন থেকে উত্তর দেয়, প্রকৃত নিয়ন্ত্রণগুলোকে হাইলাইট করে ক্লিক-ধাপে-ধাপে নির্দেশনা দেয়, এবং যেকোনো গাইডেড ট্যুর পুনরায় চালাতে পারে। এই পৃষ্ঠায় উল্লেখ করা কোনো নিয়ন্ত্রণ খুঁজে পাওয়ার এটি সবচেয়ে দ্রুত উপায়। দেখুন অ্যাপের ভেতরের কোপাইলটকে জিজ্ঞাসা করুন。

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