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