API সংযোগ
API সংযোগ হলো কাস্টম HTTP ফাংশন, যেগুলো আপনার এজেন্টরা কথোপকথনের সময় কল করতে পারে — অর্ডার খোঁজা, টিকিট তৈরি করা, আপনার নিজস্ব ব্যাকএন্ড থেকে অ্যাকাউন্টের অবস্থা আনা। আপনি Connections → APIs (/dashboard/api-connections) থেকে একবার এন্ডপয়েন্ট সংজ্ঞায়িত করেন; যেসব এজেন্টের সঙ্গে সংযোগটি যুক্ত আছে, তারা কথোপকথনের প্রয়োজনে এটি কল করতে পারে।
এটি তৈরির দুটি উপায় আছে: উইজার্ড বিশ্লেষণ করতে পারে এমন কিছু পেস্ট করুন, অথবা সংযোগটি ম্যানুয়ালি সেট আপ করুন।
দ্রুত উপায়: পেস্ট করুন এবং বিশ্লেষণ করুন
- নতুন API সংযোগে ক্লিক করুন
ডায়ালগটি উইজার্ডে খুলবে। বক্সে একটি নমুনা cURL কমান্ড, OpenAPI/Swagger স্পেসিফিকেশন, Postman এক্সপোর্ট, TypeScript ইন্টারফেস, অথবা Zod স্কিমা পেস্ট করুন।
- বিশ্লেষণ করুন-এ ক্লিক করুন
ThunderPhone আপনার পেস্ট করা তথ্য থেকে সম্পূর্ণ সংযোগটি অনুমান করে — URL, মেথড, হেডার এবং এটি পাওয়া কোয়েরি প্যারামিটার ও রিকোয়েস্ট বডি থেকে তৈরি একটি প্যারামিটার স্কিমা। আপনার পেস্ট করা হেডারগুলো (অথেন্টিকেশন হেডারসহ) এন্ডপয়েন্ট কনফিগারেশনে যুক্ত করা হয়।
- হাইলাইট করা ক্ষেত্রগুলো নিশ্চিত করুন
অনুমান করা কনফিগারেশনটি পর্যালোচনার জন্য চিহ্নিত ক্ষেত্রগুলো হাইলাইট করে খোলে। নাম, বিবরণ এবং প্যারামিটারের ধরন সামঞ্জস্য করুন, যাতে এজেন্ট বুঝতে পারে কখন ও কীভাবে ফাংশনটি কল করতে হবে — মডেলটি বিবরণটিই পড়ে।
- যাচাই করুন ও সংরক্ষণ করুন
সংরক্ষণ করার আগে আপনার এন্ডপয়েন্টে একটি লাইভ পরীক্ষার অনুরোধ চালানো হয়। অনুরোধ ব্যর্থ হলে সংযোগটি সংরক্ষিত হয় না — URL, অথেন্টিকেশন হেডার বা বডি ঠিক করে আবার চেষ্টা করুন। সফল হলে সংযোগটি যাচাইকৃত ব্যাজসহ সংরক্ষিত হয়।
উইজার্ড আপনার পেস্ট করা তথ্যে অনুরোধের URL খুঁজে না পেলে তা জানাবে —
সম্পূর্ণ একটি http(s) এন্ডপয়েন্ট অন্তর্ভুক্ত করে আবার চেষ্টা করুন।
ম্যানুয়াল সেটআপ
উইজার্ডে ম্যানুয়ালি সেট আপ করুন →-এ ক্লিক করুন (অথবা ফিরে যেতে AI-কে এটি অনুমান করতে দিতে চান? উইজার্ড ব্যবহার করুন →-এ ক্লিক করুন)। ম্যানুয়াল বিল্ডারে দুটি এডিটর আছে:
- ভিজ্যুয়াল — প্রদর্শনের নাম, ফাংশনের নাম, অনুরোধের
URL, মেথড (
POST,GET,PUT,PATCH,DELETE), কাস্টম হেডার, এবং প্যারামিটার স্কিমার জন্য ফর্ম ক্ষেত্র (প্রপার্টি যোগ করুন প্রতিটি আর্গুমেন্টের জন্য, যা এজেন্ট সরবরাহ করতে পারে)। - JSON — সরাসরি একটি টুল স্পেসিফিকেশন পেস্ট বা সূক্ষ্মভাবে সামঞ্জস্য করার জন্য কাঁচা JSON হিসেবে একই সংজ্ঞা।
একটি পরীক্ষার অনুরোধ প্যানেল (ঐচ্ছিক) আপনাকে সংরক্ষণের আগে কনফিগার করা অনুরোধটি চালাতে দেয় এবং স্ট্যাটাস, লেটেন্সি ও রেসপন্সের প্রিভিউ দেখায়। যাচাই করুন ও সংরক্ষণ করুন সবসময় এই পরীক্ষা চালায় এবং শুধু সফল হলেই সংরক্ষণ করে।
আপনার সংযোগগুলো পরিচালনা করুন
প্রতিটি সংযোগের সারিতে এর যাচাইয়ের অবস্থা — যাচাইকৃত, পরীক্ষা করা হয়নি, অথবা ত্রুটি — এর ফাংশনের নাম এবং কোন এজেন্টগুলো এটি ব্যবহার করে তা দেখা যায়। সারির অ্যাকশন মেনু থেকে আপনি করতে পারেন:
- সম্পাদনা করুন — কনফিগারেশন পুনরায় খুলুন।
- ক্লোন করুন — একটি শুরুর বিন্দু হিসেবে এটির অনুলিপি তৈরি করুন (অনুলিপিটি পরীক্ষা করা হয়নি অবস্থায় শুরু হয়)।
- সংশোধনের ইতিহাস — আগের সংস্করণ দেখুন এবং একটি সংস্করণ এডিটরে পুনরুদ্ধার করুন।
- স্থানান্তর করুন — আপনার সদস্যভুক্ত অন্য একটি সংস্থায় সংযোগটি অনুলিপি বা স্থানান্তর করুন। স্থানান্তর করলে এটি এখান থেকে সরানো হয়; এটি ব্যবহার করা এজেন্টগুলোর পুনরায় কনফিগারেশন প্রয়োজন হতে পারে।
- মুছে ফেলুন — স্থায়ী; সংযোগটি ব্যবহার করা এজেন্টগুলোর পুনরায় কনফিগারেশন প্রয়োজন হবে।
এটি একটি এজেন্টের সঙ্গে যুক্ত করুন
বিল্ডারের API সংযোগ বিভাগে একটি এজেন্টের সঙ্গে সংযোগটি যুক্ত করুন (একটি এজেন্ট তৈরি করুন)। তালিকাটি দেখায় কোন এজেন্টগুলো প্রতিটি সংযোগ ব্যবহার করে, তাই একটি পরিবর্তন কী প্রভাবিত করে তা আপনি এক নজরেই বুঝতে পারবেন।
পরবর্তী ধাপ
প্রোগ্রামগতভাবে একই সংযোগ তৈরি ও পরিচালনা করুন।
আগে থেকে তৈরি Google, Slack, HubSpot, Salesforce এবং Cal.com সংযোগ।
আপনার এজেন্টদের কাছে একটি সম্পূর্ণ টুল সার্ভার উন্মুক্ত করুন।
ইন্টিগ্রেশন রিসোর্সের প্রতিটি ফিল্ড।