Keyda উইজেট API
ডেভেলপারদের জন্য, অথবা যে কেউ যদি তাদের নিজস্ব বোতাম থেকে চ্যাট খুলতে চান।
ইনস্টল করা হচ্ছে
<script src="https://keyda.in/business/widget.js"
data-key="kb_live_your_key_here" async></script>স্ক্রিপ্ট ট্যাগের জন্য শুধুমাত্র src এবং data-key প্রয়োজন। বাকি সবকিছু — রঙ, অবস্থান, অভিবাদন, ভাষা — আপনার ড্যাশবোর্ড থেকে নিয়ন্ত্রণ করা যায়, তাই এগুলো পরিবর্তনের জন্য আপনাকে বারবার সাইট রিডিপ্লয় করতে হবে না।
মোড
ফ্লোটিং (ডিফল্ট)। কোণায় একটি লঞ্চার বাটন, যা একটি চ্যাট প্যানেল খোলে।
ইনলাইন। পৃষ্ঠায় একটি খালি কন্টেইনার রাখুন এবং চ্যাটটি সেখানে প্রদর্শিত হবে:
<div data-keyda-bot style="height:520px"></div>কন্টেইনারটির একটি উচ্চতা প্রয়োজন। ইনলাইন মোডে চ্যাট সবসময় দৃশ্যমান থাকে, তাই এখানে খোলার বা বন্ধ করার কিছু নেই।
JavaScript API
স্ক্রিপ্ট লোড হওয়ার পর window.KeydaBot-এ পাওয়া যাবে:
| কল | এটি যা করে |
|---|---|
KeydaBot.open() | চ্যাট প্যানেল খোলে |
KeydaBot.close() | বন্ধ করে |
KeydaBot.toggle() | খোলে বা বন্ধ করে |
KeydaBot.expand() | প্যানেলটিকে উইন্ডোর সমান লম্বা এবং ৭৬০ পিক্সেল পর্যন্ত চওড়া করে |
KeydaBot.shrink() | স্ট্যান্ডার্ড কার্ডে ফিরে যান |
KeydaBot.isOpen | true চ্যাট কখন দৃশ্যমান হবে |
KeydaBot.isExpanded | true যখন প্যানেলটি প্রসারিত থাকে |
KeydaBot.clientId | এই পেজটি যে Client ID ব্যবহার করছে |
উদাহরণ — আপনার নিজস্ব "Chat with us" বাটন থেকে চ্যাট ওপেন করুন:
<button onclick="KeydaBot.open()">Chat with us</button>স্ক্রিপ্টটি অ্যাসিনক্রোনাসভাবে লোড হয়, তাই পেজ লোড হওয়ার পর মুহূর্তের জন্য
window.KeydaBot নাও থাকতে পারে। পেজ পার্স হওয়ার সময় কল না করে কোনো ক্লিকের সাথে হ্যান্ডলার যুক্ত করুন।এটি আপনার পেজে কেমন আচরণ করে
- প্যানেলটি লঞ্চার বাটনের উপরে খোলে, যা তার জায়গায় স্থির থাকে এবং ক্লোজ কন্ট্রোল হিসেবে কাজ করে। এটিতে আবার ট্যাপ করলে, হেডারের ✕ চিহ্নে ক্লিক করলে অথবা Escape চাপলে চ্যাট বন্ধ হয়ে যায়।
- দর্শকরা হেডার থেকে প্যানেলটি বড় করতে পারেন — এটি উইন্ডোর উচ্চতা এবং সর্বোচ্চ 760px পর্যন্ত চওড়া হতে পারে — এবং ব্রাউজার এই পছন্দ মনে রাখে। ফোনে প্যানেলটি ইতিমধ্যে পুরো স্ক্রিন জুড়ে থাকে, তাই সেখানে এই কন্ট্রোলটি দেখানো হয় না।
- আপনার লোগোর আকার সেটিংস লোগো পরিবর্তন করে, বোতাম নয়: লঞ্চারটি একটি নির্দিষ্ট ৫২ পিক্সেল পিল (গোল এবং বর্গাকার আকৃতির জন্য ৫৮ পিক্সেল) এবং লোগোটি এর ভেতরে বড় হয়।
- সবকিছু একটি shadow root-এর ভেতরে রেন্ডার হয়, তাই আপনার CSS উইজেটটিকে নষ্ট করতে পারবে না এবং উইজেটের CSS আপনার সাইটকে প্রভাবিত করবে না।
- প্যানেলটি শুধুমাত্র তখনই লোড হয় যখন কোনো ভিজিটর এটি খোলে, তাই এটি আপনার পেজের গতি কমায় না।
- একজন ভিজিটরের কথোপকথন ২৪ ঘণ্টা পর্যন্ত বজায় থাকে যদি তারা ফিরে আসে, এরপর তা নতুন করে শুরু হয়।
- যদি অ্যাসিস্ট্যান্টের সাথে যোগাযোগ করা না যায়, তবে উইজেটটি একটি ছোট বার্তা দেখাবে এবং আপনার পেজে কোনো ত্রুটি দেখাবে না।