Open in
Slack বা চ্যাট অ্যাপ থেকে কল চালান
পাবলিক API ব্যবহার করে আপনার নিজস্ব Slack, Teams বা ওয়েব-চ্যাট বট তৈরি করুন, যা কল শুরু করে, লাইভে সেগুলো অনুসরণ করে, এজেন্টকে নির্দেশনা দেয় এবং তার প্রশ্নের উত্তর দেয়।
আপনার টিম যে চ্যাট অ্যাপ ইতিমধ্যেই ব্যবহার করে, সেখান থেকে আপনি একটি এজেন্ট পরিচালনা করতে পারেন। একটি বার্তা কল শুরু করে। কলটি একটি থ্রেডে লাইভ চলতে থাকে। থ্রেডে একটি উত্তর এজেন্টকে নির্দেশনা দেয়। এজেন্টের কোনো সিদ্ধান্ত প্রয়োজন হলে, সে সেখানে আপনাকে জিজ্ঞাসা করে এবং আপনার উত্তরের জন্য অপেক্ষা করে।
ThunderPhone আপনার জন্য এই বটটি হোস্ট করে না। আপনি (বা আপনার কোডিং এজেন্ট) একটি ছোট সার্ভার তৈরি করেন যা আপনার চ্যাট অ্যাপকে পাবলিক API-এর সঙ্গে সংযুক্ত করে। এই পৃষ্ঠায় অংশগুলো দেখানো হয়েছে। Slack, Microsoft Teams, Discord বা একটি ব্যক্তিগত ওয়েব চ্যাট পৃষ্ঠার জন্য এগুলো একই; উদাহরণগুলোতে Slack ব্যবহার করা হয়েছে।
এটি কীভাবে একসঙ্গে কাজ করে
| আপনি চ্যাটে এটি করেন | আপনার বট এটি কল করে | কী ঘটে |
|---|---|---|
| "Comcast-এ কল করুন এবং বিভ্রাটের ETA জানুন" পাঠান | বার্তাটি context হিসেবে দিয়ে POST /v1/call | এজেন্ট ডায়াল করে। আপনার বট কলটির জন্য একটি থ্রেড খোলে |
| থ্রেড দেখুন | telephony.turn webhook গ্রহণ করে | এজেন্ট বা অপর ব্যক্তি যা বলেন, তার প্রতিটি লাইন থ্রেডে দেখা যায় |
| কল চলাকালে থ্রেডে উত্তর দিন | POST /v1/calls/{call_id}/whisper | এজেন্ট আপনার নোটটি ব্যক্তিগতভাবে পায় এবং সেটি অনুযায়ী কাজ করে। অপর ব্যক্তি কখনও এটি শোনেন না |
| এজেন্টের প্রশ্নের উত্তর দিন | আপনার টুল এন্ডপয়েন্ট আপনার উত্তর ফেরত দেয়, অথবা পরে POST /v1/calls/{call_id}/tool-results দিয়ে তা পাঠায় | এজেন্ট তা নিয়ে কল চালিয়ে যায়; হোল্ড মোডে এ সময় অপর ব্যক্তি হোল্ড মিউজিক শোনেন |
| ফলাফল পড়ুন | telephony.complete গ্রহণ করে | আপনার বট সারসংক্ষেপ ও ফলাফল পোস্ট করে |
আপনার বট একটি ম্যাপিং রাখে: কোন চ্যাট থ্রেডটি কোন call_id-এর অন্তর্গত।
শুরু করার আগে
- একটি API কী, যা আপনার সার্ভারে রাখা হবে, কখনও ব্রাউজার বা চ্যাটে নয়। প্রতিষ্ঠানের সেটিংস → কীসমূহ-এর অধীনে একটি তৈরি করুন (দেখুন কীসমূহ)।
- কল করার জন্য একটি আউটবাউন্ড-সক্ষম নম্বর এবং একটি এজেন্ট। বার্তাটি
প্রতি-কলে
contextহয়ে যায়, তাই একটি সাধারণ এজেন্ট সব কাজ পরিচালনা করে। - একটি সার্ভার যা webhook গ্রহণ করতে পারে, যেমন Railway, Fly.io, Render অথবা আপনার নিজস্ব হোস্ট।
- একটি webhook এন্ডপয়েন্ট যা সেই সার্ভারের দিকে নির্দেশ করে এবং
telephony.turnওtelephony.complete-এ সাবস্ক্রাইব করা। টার্ন ইভেন্ট কেবল সেই এন্ডপয়েন্টগুলোতে পাঠানো হয় যেগুলো সেগুলো তালিকাভুক্ত করে। দেখুন Webhook। টার্ন ইভেন্টের জন্য এজেন্টের কল রেকর্ডিং চালু থাকতে হবে, এবং কল-শেষেরsummary-এর জন্য এজেন্টের কলের সারসংক্ষেপ তৈরি করুন সেটিং প্রয়োজন; এগুলো ছাড়া সেই ফিল্ডগুলো খালি থাকবে। - আপনার নিজস্ব চ্যাট অ্যাপ। Slack-এর জন্য, আপনার ওয়ার্কস্পেসে api.slack.com/apps-এ একটি অ্যাপ তৈরি করুন।
1. একটি বার্তা থেকে কল শুরু করুন
আপনার বট যখন একটি বার্তা পায় (একটি সরাসরি বার্তা বা একটি @mention),
তখনই Slack-এর অনুরোধ স্বীকার করুন (Slack 3 সেকেন্ডের মধ্যে স্বীকার না করা
যেকোনো কিছু পুনরায় চেষ্টা করে) এবং বাকি কাজ ব্যাকগ্রাউন্ডে করুন। প্রেরক কল
করার অনুমতি পেয়েছে কি না যাচাই করুন, তারপর বার্তাটিকে context হিসেবে ব্যবহার
করে কল শুরু করুন:
curl -X POST https://api.thunderphone.com/v1/call \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"from_number": "+15551234567",
"to_number": "+18005550100",
"agent_id": 12,
"context": "Matthew asked: get the outage ETA for account 4471. Wait on hold if needed.",
"idempotency_key": "slack-D012AB3CD-1731000000.000100"
}'ফেরত পাওয়া call_id-টি Slack থ্রেডের সঙ্গে সংরক্ষণ করুন (channel এবং
বার্তার ts) এবং থ্রেডে উত্তর দিন ("কল করা হচ্ছে…")। idempotency_key-টি
চ্যানেল এবং বার্তার ts থেকে তৈরি করুন (একটি ts কেবল তার চ্যানেলের মধ্যেই
অনন্য), যাতে পুনরায় চেষ্টা করা Slack ইভেন্ট দ্বিতীয় কল না করে। অনুরোধে নম্বরের
পরিবর্তে কোনো ব্যক্তির নাম থাকলে, আপনার বট আগে নম্বরটি খুঁজে নেয়। ThunderPhone
শুধু আপনার পাঠানো to_number-এ ডায়াল করে।
2. থ্রেডে কল অনুসরণ করুন
প্রতিটি telephony.turn ওয়েবহুকে থাকে call_id, বক্তা (role:
এজেন্টের জন্য assistant, অন্য ব্যক্তির জন্য user), text এবং
টার্নের position। call_id দিয়ে থ্রেডটি খুঁজে বের করুন এবং
লাইনটি পোস্ট করুন।
- কোনো পদক্ষেপ নেওয়ার আগে প্রতিটি ওয়েবহুক যাচাই করুন। দেখুন ওয়েবহুক স্বাক্ষর যাচাই করুন।
- খামের
event_idদিয়ে ডুপ্লিকেট বাদ দিন এবংpositionঅনুযায়ী সাজান। ডেলিভারি অন্তত একবার হয় এবং টার্নগুলো ক্রমবহির্ভূতভাবে আসতে পারে। - ব্যস্ত কল থ্রেড ভরিয়ে ফেললে লাইনগুলো ব্যাচ করুন; প্রতি লাইনে একটি বার্তার চেয়ে কয়েক সেকেন্ড পরপর পোস্ট করা পড়তে ভালো লাগে।
telephony.complete এলে, কলটি কীভাবে শেষ হয়েছে (status এবং
end_reason), summary, এবং নিষ্কাশিত যেকোনো ডেটা পোস্ট করুন ও থ্রেডটি
বন্ধ করুন। ফিল্ডগুলোর জন্য কল সম্পন্ন দেখুন।
3. থ্রেড থেকে কল পরিচালনা করুন
কেউ লাইভ কলের থ্রেডে উত্তর দিলে, উত্তরটিকে ফিসফিস হিসেবে পাঠান, যদি না এজেন্ট কোনো প্রশ্নের উত্তরের জন্য অপেক্ষা করে (ধাপ 4), যে ক্ষেত্রে উত্তরটিই উত্তর:
curl -X POST https://api.thunderphone.com/v1/calls/987654321/whisper \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text": "Ask whether they can waive the late fee."}'এজেন্ট এটি ব্যক্তিগতভাবে শোনে এবং পরবর্তী টার্নে অন্তর্ভুক্ত করে; অন্য ব্যক্তি
কখনো ফিসফিসটি নিজে শোনে না। একটি ফিসফিস 1 থেকে 1000 অক্ষরের হয়। 409-এর
অর্থ কলটি আর লাইভ নেই: থ্রেডকে জানান যে কলটি শেষ হয়েছে।
4. এজেন্টকে আপনাকে জিজ্ঞাসা করতে দিন
এজেন্টকে একটি টুল দিন, উদাহরণস্বরূপ একটি question
প্যারামিটারসহ ask_owner, যা আপনার সার্ভারকে কল করে। এটিকে একটি
API সংযোগ হিসেবে তৈরি করুন এবং এজেন্টের সঙ্গে লিঙ্ক করুন।
প্রতিটি টুল অনুরোধ তার X-ThunderPhone-Call-ID হেডারে কলটি বহন করে।
উত্তর ফেরত পাওয়ার তিনটি উপায় আছে।
কল হোল্ডে রাখুন (সর্বোচ্চ 10 মিনিট)। টুলটিকে হোল্ড মোডে সেট করুন: spec.wait_mode
"hold" এবং spec.timeout সর্বোচ্চ 600 সেকেন্ড (টাইমআউট ছাড়া একটি হোল্ড
20 সেকেন্ড স্থায়ী হয়), API-এর মাধ্যমে
(ড্যাশবোর্ড এডিটরে এখনও কোনো ফিল্ড নেই)। আপনার এন্ডপয়েন্ট প্রশ্নটি কলের থ্রেডে পোস্ট করে এবং
সঙ্গে সঙ্গে একটি অপেক্ষমাণ ফলাফল দিয়ে উত্তর দেয়:
{"status": "pending", "request_id": "q-C012AB3CD-1731000042.000300"}অপর ব্যক্তি এজেন্টের কাছ থেকে একটি লাইন শোনেন, তারপর হোল্ড মিউজিক। ফোন
মেনু বা ভয়েসমেইলে এজেন্ট এর বদলে কথ্য আপডেট ব্যবহার করে, এবং একটি
ফুল-ডুপ্লেক্স এজেন্ট হোল্ডে রাখে না: এটি অপেক্ষমাণ উত্তরটিকে ফলাফল হিসেবে পায়। থ্রেডে
উত্তর এলে, এটি পাঠান
POST /v1/calls/{call_id}/tool-results-এর মাধ্যমে:
curl -X POST https://api.thunderphone.com/v1/calls/987654321/tool-results \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"request_id": "q-C012AB3CD-1731000042.000300", "result": {"answer": "Yes, book Tuesday at 10."}}'মিউজিক ধীরে ধীরে থেমে যায় এবং এজেন্ট আপনার উত্তর অনুযায়ী এগিয়ে যায়। timeout-এর
আগে কেউ উত্তর না দিলে, এজেন্টকে জানানো হয় যে কোনো উত্তর আসেনি এবং সে
অপর ব্যক্তিকে পরবর্তী পদক্ষেপ প্রস্তাব করে। কোনো কলের জন্য প্রশ্ন অপেক্ষমাণ থাকলে, তার
থ্রেডের পরবর্তী উত্তরটি সেটির উত্তর দেয়: এটিকে টুল ফলাফল হিসেবে পাঠান এবং
এটিকে ফিসফিস হিসেবে পাঠাবেন না (টুল রিটার্ন করার পরেই একটি ফিসফিস শুধু এজেন্টের কাছে পৌঁছায়)।
দেখুন
দীর্ঘ অপেক্ষা।
অনুরোধে অপেক্ষা করুন (সর্বোচ্চ 3 মিনিট)। আপনার এন্ডপয়েন্ট প্রশ্নটি পোস্ট করে,
একটি উত্তরের জন্য অপেক্ষা করে এবং তা ফেরত দেয়, যেমন {"answer": "Yes, book Tuesday at 10."}।
API-এর মাধ্যমে টুলের spec.timeout সর্বোচ্চ 180 সেকেন্ডে সেট করুন (ডিফল্ট
20)। আপনার এন্ডপয়েন্টের নিজস্ব ডেডলাইন কয়েক সেকেন্ড কম দিন
(উদাহরণস্বরূপ 170 সেকেন্ড), যাতে কেউ উত্তর না দিলেও এটি এজেন্টের কাজে লাগার মতো
কিছু ফেরত দেয়, যেমন
{"answer": null, "note": "No reply yet. Offer to take a message."}। যে টুলটি তার
timeout-এ পৌঁছায় তা এজেন্টের কাছে একটি ত্রুটি হিসেবে পৌঁছায়, এবং আপনার হোস্টকে
ততক্ষণ একটি অনুরোধ খোলা রাখতে হবে। অপেক্ষার সময় এজেন্ট অপর ব্যক্তিকে বলে যে সে
যাচাই করছে, প্রায় 12 সেকেন্ড পরে বলে যে সে এখনও কাজ করছে, এবং
তারপর প্রতি প্রায় 15 সেকেন্ডে একটি সংক্ষিপ্ত আপডেট দেয়। এখানেও হোল্ড মোড কাজ করে:
spec.wait_mode-কে "hold" সেট করুন, তাহলে অপর ব্যক্তি আপডেটের বদলে মিউজিক শুনবেন।
ফিসফিসের মাধ্যমে উত্তর দিন। আপনার এন্ডপয়েন্ট প্রশ্নটি পোস্ট করে এবং সঙ্গে সঙ্গে ফেরত দেয়,
উদাহরণস্বরূপ {"status": "asked", "note": "Matthew has been asked; his answer will come as guidance."}।
উত্তর এলে, এটিকে ফিসফিস হিসেবে পাঠান (ধাপ 3), এবং এজেন্ট
সঙ্গে সঙ্গে এর উত্তর দেয়। 10 মিনিটের বেশি সময় লাগতে পারে এমন উত্তরের জন্য এটি ব্যবহার করুন।
কলটি হোল্ডে রাখা হয় না: আপনার prompt-এ এজেন্টকে বলে দেওয়া উচিত
মাঝের সময়ে কী করতে হবে, যেমন ব্যক্তির সঙ্গে কথা চালিয়ে যাওয়া বা
তাকে পরে কল ব্যাক করার প্রস্তাব দেওয়া।
প্রতিটি ক্ষেত্রেই, এজেন্টের prompt-এ বলুন কখন টুলটি ব্যবহার করতে হবে এবং অপেক্ষার সময় অপর ব্যক্তিকে কী বলতে হবে:
When you need Matthew's decision, use ask_owner with a short question.
Tell the person you're checking with Matthew and it may take a minute.
If there's no answer, offer to take a message or have Matthew call back.পরিকল্পনার জন্য সীমা
- আপনার endpoint-কে টুলের
timeout-এর মধ্যে, সর্বোচ্চ 180 সেকেন্ডে উত্তর দিতে হবে। হোল্ড মোডে থাকা একটি টুল মুলতুবি ফলাফলসহ কলটি সর্বোচ্চ 600 সেকেন্ড হোল্ডে রাখতে পারে। - একটি টুল অপেক্ষা করার সময়, এজেন্ট অন্য ব্যক্তিকে উত্তর দেয় না। হোল্ড মোডে তারা সঙ্গীত শোনে; অন্যথায়, সংক্ষিপ্ত কথ্য আপডেট শোনে।
- একটি ফিসফিস সর্বোচ্চ 1000 অক্ষরের হতে পারে।
telephony.turnডেলিভারি অন্তত একবার হয় এবং ক্রমের বাইরে হতে পারে।
নিরাপত্তা চেকলিস্ট
- API key আপনার সার্ভারে রাখুন।
- webhook এবং টুল অনুরোধে ThunderPhone-এর স্বাক্ষর, এবং Slack অনুরোধে Slack-এর signing secret যাচাই করুন। দুটি ThunderPhone স্বাক্ষরে ভিন্ন secret ব্যবহৃত হয়: webhook ডেলিভারিতে webhook endpoint-এর নিজস্ব secret ব্যবহৃত হয়, এবং টুল অনুরোধে
GET /v1/webhookথেকে পাওয়া আপনার প্রতিষ্ঠানের webhook secret ব্যবহৃত হয়। - কারা কল শুরু করতে পারবে তা নির্ধারণ করুন: কল করার আগে Slack user ID পরীক্ষা করুন।
- আউটবাউন্ড কল অন্য সব কলের মতো একই নিয়ম অনুসরণ করে। দেখুন আউটবাউন্ড কলিং আইন।
একটি কোডিং এজেন্ট দিয়ে তৈরি করুন
আপনার কোডিং এজেন্টকে ডকস MCP সার্ভার এবং এই পেজের দিকে নির্দেশ করুন, এবং বলুন, "আমার ThunderPhone এজেন্টের জন্য এই গাইড অনুসরণ করে এমন একটি Slack বট তৈরি করুন"। ThunderPhone অ্যাপের সহকারী Zeus এজেন্টের দিকটি সেট আপ করতে পারে (webhook endpoint, টুল এবং prompt লাইনগুলো) এবং চ্যাটে বটের জন্য প্রাথমিক কোড লিখতে পারে।