ThunderPhone v3 এখন লাইভ।নিজেই ব্যবহার শুরু করুন, 2¢/মিনিট থেকে।ঘোষণাটি পড়ুন

Developer cookbook

ইনবাউন্ড কল পরিচালনা করুন (API)

শুরু থেকে শেষ পর্যন্ত: একটি এজেন্ট কনফিগার করুন, এটিকে একটি ফোন নম্বরে বরাদ্দ করুন, একটি কল নিন এবং ট্রান্সক্রিপ্ট পরিদর্শন করুন।

আপনার টার্মিনাল থেকে AI দিয়ে ফোনের উত্তর দেওয়ার আদর্শ ফ্লো। আপনি করবেন:

  1. একটি prompt এবং ভয়েস দিয়ে একটি এজেন্ট তৈরি করবেন।
  2. একটি ফোন নম্বর প্রভিশন করবেন (অথবা নিয়ে আসবেন) এবং এজেন্টটিকে তার ইনবাউন্ড হ্যান্ডলার হিসেবে বরাদ্দ করবেন।
  3. নম্বরটিতে কল করবেন। কল লগ, ট্রান্সক্রিপ্ট এবং রেকর্ডিং পর্যবেক্ষণ করবেন।

মোট API কল: চারটি। মোট সময়: পাঁচ মিনিটের কম।

1. একটি এজেন্ট তৈরি করুন

একটি এজেন্ট কল পরিচালনার জন্য ব্যবহৃত prompt, ভয়েস এবং পণ্যের স্তর একত্র করে। এজেন্টে max_call_duration_seconds এবং ring_duration_seconds-এর মতো কল সীমাও সেট করতে পারেন। আউটবাউন্ড কলের জন্য, কল শেষ করার আগে এজেন্ট কতক্ষণ হোল্ডে অপেক্ষা করবে তা সীমিত করতে max_hold_seconds-ও সেট করতে পারেন। Bolt এজেন্টে audio_tier, endpointing এবং intelligence সমর্থিত, যাতে তারা কীভাবে শোনে ও উত্তর দেয় তা নিয়ন্ত্রণ করতে পারেন: intelligence হলো core অথবা pro, এবং audio_tier (শ্রবণ) হলো lite, standard, plus অথবা max (Max সাধারণভাবে উপলভ্য নয়)। পুরোনো মানগুলো (lite এবং standard intelligence-এর জন্য; lean, hearing এবং deep_hearing শ্রবণের জন্য) এখনও গৃহীত হয়। পূর্ণ ডুপ্লেক্স এজেন্ট সমর্থিত ভাষাগুলোতে একই ভয়েস বজায় রাখে, তাই ওই কলগুলোতে ভাষাভিত্তিক ভয়েস পরিবর্তন প্রযোজ্য নয়। এজেন্টে intro_clip এবং intro_ring_count-ও সমর্থিত, যাতে এজেন্ট কথা বলার আগে একটি পূর্বে রেকর্ড করা পরিচিতি এবং সর্বোচ্চ দুইবার রিং বাজানো যায়। নতুন এজেন্টের জন্য একটি সময় অঞ্চলও প্রয়োজন। আপনার এজেন্ট বহুভাষী হলে, ভাষা পরিবর্তনের আগে এটি জিজ্ঞাসা করবে নাকি কলারের ভাষা অনুসরণ করবে তা নিয়ন্ত্রণ করতে language_switching সেট করতে পারেন। নির্দিষ্ট শব্দ কীভাবে বলা হবে এবং কোন শব্দগুলো শোনা হবে তা নিয়ন্ত্রণ করতে এজেন্টে words-ও সেট করতে পারেন। প্রতিটি কনফিগারেশন ফিল্ডের জন্য এজেন্ট দেখুন; ন্যূনতমটি হলো:

curl -X POST https://api.thunderphone.com/v1/agents \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name":    "Acme Support",
    "prompt":  "You are a friendly support agent for Acme. Help callers with orders and returns. Keep answers short.",
    "voice":   "john",
    "product": "bolt"
  }'

ফেরত পাওয়া id সংরক্ষণ করুন — ধাপ 2-এ এটির প্রয়োজন হবে।

2. একটি ফোন নম্বর নিন

শুধু কল করে পরীক্ষা করার জন্য কিছু দরকার হলে, ThunderPhone-এর পুল থেকে একটি ThunderPhone নম্বর নিন:

curl -X POST https://api.thunderphone.com/v1/phone-numbers \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area_code": "415"}'

রেসপন্সে E.164 ফরম্যাটে একটি id এবং একটি number থাকে। ThunderPhone নম্বরগুলো status="provisioning"-এ শুরু হয় এবং কয়েক সেকেন্ডের মধ্যে active হয়ে যায় — প্রয়োজন হলে পরিবর্তনটি দেখতে GET /v1/phone-numbers/{id} পোল করুন।

3. এজেন্ট বরাদ্দ করুন

ধাপ 1-এর এজেন্টটিকে নম্বরের ইনবাউন্ড দিকের সঙ্গে যুক্ত করুন:

curl -X PATCH https://api.thunderphone.com/v1/phone-numbers/{phone_id} \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"inbound_agent_id": 12}'

এটুকুই — নম্বরটি এখন সক্রিয়। আপনার সংস্থার জন্য বহির্গামী কল অনুমোদিত হওয়ার পর, আপনি একই PATCH-এ outbound_agent_id-ও সেট করতে পারবেন। ততক্ষণ পর্যন্ত, API 400 দিয়ে সেই বরাদ্দ প্রত্যাখ্যান করে।

আপনি যদি একটি নির্দিষ্ট inbound_agent_id-এর পরিবর্তে config webhook-এর মাধ্যমে ইনবাউন্ড কল রুট করেন, তাহলে সেই webhook এখন agent_id এবং variables-এর সঙ্গে প্রতি-কলের timezone ফেরত দিতে পারে। Bolt এজেন্টের ক্ষেত্রে, API write-এ আপনি এজেন্টে audio_tier, endpointing এবং intelligence-ও সেট করতে পারেন। API এখনও endpointing-এর alias হিসেবে পুরোনো eagerness নামটি গ্রহণ করে। আপনার এজেন্ট যদি trigger="call_start" সহ API connection ব্যবহার করে, তাহলে ThunderPhone প্রতিটি ফোন কলের শুরুতে, অভিবাদনের আগে, তাদের সংরক্ষিত call_start_arguments ব্যবহার করে ওই টুলগুলো একবার চালাতে পারে।

আপনার আউটবাউন্ড কলের কলব্যাক

কেউ গত 30 দিনের মধ্যে তাকে কল করা কোনো নম্বরে আবার কল করলে, উত্তরদাতা এজেন্ট সেই কল সম্পর্কে একটি সংক্ষিপ্ত পটভূমি নোট পায়: কখন কলটি করা হয়েছিল, কোন এজেন্ট করেছিলেন এবং কী ঘটেছিল (কোনো উত্তর নেই, ভয়েসমেইল, বা একটি কথোপকথন)। কোনো ইনবাউন্ড এজেন্ট ছাড়া একটি নম্বর একই বিবরণ returning_call হিসেবে আপনার কনফিগ ওয়েবহুকে পাঠায়। সেই নম্বরে কোনো ওয়েবহুক না থাকলে, অথবা ওয়েবহুকের সময়সীমা শেষ হলে বা সেটিতে পৌঁছানো না গেলে, কলটি শেষ হওয়ার পরিবর্তে আগের কলটি করা এজেন্টের কাছে যায়। কলার আইডি জাল হতে পারে, তাই কোনো অ্যাডমিন Organization → General → Callbacks-এর অধীনে আগের কলের বিবরণ শেয়ার করুন চালু করলেই কেবল আগের কলের সারসংক্ষেপ এবং ভেরিয়েবল শেয়ার করা হয়। দেখুন কলব্যাক।

4. একটি কল নিন

আপনার ফোন থেকে নম্বরটিতে ডায়াল করুন। এজেন্ট কল গ্রহণ করে, আপনার prompt অনুযায়ী নিজের পরিচয় দেয়, এবং কথোপকথন শুরু হয়।

কল চলাকালে, এটি GET /v1/calls-এ status="in_progress" সহ দেখা যায়। কল শেষ হলে, রেকর্ডটি end_reason, duration_seconds, billable_minutes, এবং (শেষ পর্যন্ত) একটি রেকর্ডিং URL ও AI গ্রেড দিয়ে আপডেট হয়।

ইনবাউন্ড কল আপনার প্রতিষ্ঠানের একযোগে কলের সীমা-এর মধ্যে গণনা করা হয় (ডিফল্টভাবে 20টি কল চলমান থাকে, যা আউটবাউন্ড, ওয়েব এবং টেস্ট কলের সঙ্গে ভাগ করা হয়)। সীমায় পৌঁছানোর পর আসা কোনো কল এজেন্ট উত্তর দেওয়ার আগেই প্রত্যাখ্যান ও সংযোগ বিচ্ছিন্ন করা হয়, বিল করা হয় না, এবং concurrent_call_limit_reached সমাপ্তির কারণসহ ব্যর্থ কল হিসেবে রেকর্ড করা হয়। আপনার উচ্চতর সীমা প্রয়োজন হলে support@thunderphone.com-এ ইমেল করুন।

5. ফলাফল পরিদর্শন করুন

সাম্প্রতিক কলগুলোর তালিকা আনুন:

curl 'https://api.thunderphone.com/v1/calls?limit=5' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

ট্রান্সক্রিপ্ট সংগ্রহ করুন:

curl https://api.thunderphone.com/v1/calls/{call_id}/transcript \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

এবং রেকর্ডিং URL সংগ্রহ করুন (স্বল্পমেয়াদি, সইকৃত):

curl https://api.thunderphone.com/v1/calls/{call_id}/audio \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

আপনি যদি telephony.complete webhook-এ সাবস্ক্রাইব করে থাকেন, তাহলে আপনার সার্ভারে POST হিসেবে একই ডেটা পাবেন — দেখুন call.complete।

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


পরবর্তী ধাপ