SDK রেফারেন্স

প্রতিটি Telybot SDK — Android, iOS, React Native, Flutter, Ionic — একই ছোট কনটেন্ট অনুসরণ করে। আপনি যদি একটি ব্যবহার করে থাকেন, তবে সবগুলোই ব্যবহার করতে পেরেছেন।

API

কল	এটি যা করে
`init` / `initialize`	আপনার Client ID সংরক্ষণ করে। এটি যাচাই করে এবং ভুল ফরম্যাটে থাকলে স্পষ্টভাবে ত্রুটি দেখায়।
`show`	আপনার অ্যাপের উপরে চ্যাট দেখায়। মেসেজ বক্সের জন্য ঐচ্ছিকভাবে একটি প্রশ্ন নেয় (0.2.0)।
`dismiss`	এটি বন্ধ করে।
`isShowing`	এটি বর্তমানে প্রদর্শিত হচ্ছে কিনা।
এমবেড করা চ্যাট	আপনার নিজের কোনো স্ক্রিনের ভেতরে চ্যাট, যেমন একটি সহায়তা ট্যাব (0.2.0)।
`onShow` / `onDismiss`	চ্যাট খোলা ও বন্ধ হলে জানানো হয়, Android ও iOS-এ (0.2.0)।
`setVisitor`	আপনার সাইন ইন করা গ্রাহকের নাম, ফোন ও ইমেল, চ্যাটের ফর্মে প্রস্তাব করা হয় (0.2.0)।
`hasUnreadReply` / `onReply`	আপনার দলের একটি উত্তর যা গ্রাহক এখনও দেখেননি (0.2.0)।

একটি প্রশ্ন নিয়ে খুলুন। show-এ একটি প্রশ্ন পাঠান, সেটি চ্যাটের মেসেজ বক্সে বসে যায়; গ্রাহক পড়ে পাঠান-এ ট্যাপ করেন। এটি লিঙ্কের #fragment-এ যায়, তাই কখনো সার্ভার লগে পৌঁছায় না। এক লাইনে সর্বোচ্চ 500 অক্ষর।

আপনার নিজের স্ক্রিনের ভেতরে চ্যাট। Android KeydaBotView, iOS KeydaBot.makeChatViewController বা SwiftUI KeydaBotView, React Native <KeydaBotChat />, Flutter KeydaBotChat, এবং Ionic প্যাকেজের embedWidget()। এতে কোনো বন্ধ করার বোতাম নেই — আপনার স্ক্রিনের নেভিগেশনই বেরোনোর পথ। Android-এ ব্যাক প্রথমে খোলা কোনো আইটেম বা কার্ট বন্ধ করে: চ্যাট সামনের স্ক্রিন থাকা পর্যন্ত React Native ও Flutter এটি আপনার জন্য করে, আর নেটিভ KeydaBotView-এ আপনার ব্যাক হ্যান্ডলিং এর goBack() কল করে।

আপনার সাইন ইন করা গ্রাহক। SDK-কে আপনার গ্রাহকের নাম, ফোন নম্বর বা ইমেল দিন, চ্যাট আপনার অ্যাপ যা আগে থেকেই জানে তা ভরে দেয়। বিবরণগুলি প্রস্তাব করা হয়, কখনো পাঠানো হয় না: এগুলি “একজন মানুষের সঙ্গে কথা বলুন” ফর্মে, একটি অর্ডারে, একটি বুকিংয়ে এবং নাম, ফোন বা ইমেল চাওয়া স্বাগত প্রশ্নে দেখা যায়, আর গ্রাহকই সেগুলি জমা দেন। এগুলি লিঙ্কের #fragment-এ যায় এবং এগুলি আপনার অ্যাপের কথা, যাচাই করা পরিচয় নয়। চ্যাট যে মান প্রত্যাখ্যান করত তা বাদ পড়ে: 80 অক্ষরের বেশি লম্বা নাম, 8 থেকে 15 সংখ্যা না থাকা ফোন নম্বর, সঠিক ডোমেইন ছাড়া ইমেল ঠিকানা। Ionic-এর ফুল-স্ক্রিন চ্যাট সিস্টেম ব্রাউজারে খোলে, যা ঠিকানা তার ইতিহাসে রাখে, তাই সেগুলি নেয় না; এর এমবেড করা উইজেট নেয়।

চ্যাট বন্ধ থাকার সময় একটি উত্তর। কোনো গ্রাহক একজন মানুষের সঙ্গে কথা বলতে চেয়ে চ্যাট বন্ধ করলে, ড্যাশবোর্ড থেকে দেওয়া আপনার উত্তর কথোপকথনে অপেক্ষা করে। Android, iOS, React Native ও Flutter-এর SDK আপনার অ্যাপ সামনে এলে এটি পরীক্ষা করে আপনার অ্যাপকে জানায়, যাতে গ্রাহক চ্যাট খোলার আগে পর্যন্ত আপনি চ্যাট বোতামে একটি বিন্দু দেখাতে পারেন। এগুলি কেবল সেই চ্যাটগুলির কথা জিজ্ঞাসা করে যেখানে গ্রাহক গত 14 দিনে একজন মানুষ চেয়েছেন। আপনার অ্যাপ যে চ্যাট দৃষ্টির বাইরে লোড করে রাখে, যেমন ব্যাকগ্রাউন্ডে একটি সহায়তা ট্যাব, সেটি পড়া হিসেবে গণ্য হয় না: গ্রাহক না দেখা পর্যন্ত বিন্দুটি থেকে যায়। এটি পুশ নোটিফিকেশন নয়: অ্যাপ খোলা হলেই উত্তরটি নজরে আসে।

ইচ্ছাকৃতভাবেই আর কিছু নেই। মেসেজ পাঠানোর কোনো API নেই, ব্যবহারকারীর পরিচয়ের কোনো কল নেই — কারণ কোনোটিই এখনও শুরু থেকে শেষ পর্যন্ত কাজ করে না, আর যে পদ্ধতি কাজ করে না তা না থাকার চেয়েও খারাপ।

প্রতিটি SDK যে URL খোলে

{baseUrl}/chat/{clientId}

baseUrl ডিফল্ট হিসেবে https://telybot.com সেট করা থাকে এবং স্টেজিং বা সেলফ-হোস্টেড ইন্সটলের জন্য প্রতিটি প্ল্যাটফর্মে এটি পরিবর্তন করা যায়।

ওয়েব ভিউ কেন প্রয়োজন এবং এর খরচ কত

একটি একক চ্যাট ইন্টারফেস রয়েছে, যা প্ল্যাটফর্ম দ্বারা পরিবেশিত হয় এবং প্রতিটি প্ল্যাটফর্ম এটি লোড করে।

আপনি যা পাবেন: ড্যাশবোর্ডে মালিকের করা যেকোনো পরিবর্তন—অ্যাকসেন্ট কালার, ওয়েলকাম মেসেজ, বটের নাম, লাইভ হওয়া—কোনো রিলিজ ছাড়াই অবিলম্বে প্রতিটি অ্যাপে পৌঁছে যায়। একটি ঠিকঠাক আপডেট সব জায়গায় একযোগে কার্যকর হয়। প্ল্যাটফর্ম নির্বিশেষে চ্যাটটি একদম একই থাকে।

খরচ: চ্যাটের জন্য ইন্টারনেট সংযোগ প্রয়োজন। এতে কোনো অফলাইন মোড নেই এবং এখনো কোনো পুশ নোটিফিকেশন নেই।

আমরা চাই আপনি এটি লাইভ করার আগেই জানুন, পরে আবিষ্কার করার চেয়ে।

প্রতিটি এসডিকে (SDK) যে নিশ্চয়তা দেয়

ন্যাভিগেশন এস্কেপস। অন্য কোনো অরিজিনের লিঙ্ক চ্যাট প্রতিস্থাপন না করে সিস্টেম ব্রাউজারে খোলে। এটি ছাড়া, ফুটার লিঙ্কে একটি ট্যাপ করলে গ্রাহকের কথোপকথন শেষ হয়ে যায় এবং ফিরে আসার কোনো উপায় থাকে না।
কথোপকথনের ধারাবাহিকতা। DOM স্টোরেজ চালু আছে, তাই কোনো গ্রাহক অ্যাপ বন্ধ করে আবার ফিরে এলে তার চ্যাট আগের জায়গায় (২৪ ঘণ্টার জন্য) দেখতে পান।
কীবোর্ড কখনোই ইনপুট বক্সকে ঢেকে ফেলে না।
নিরাপদ এলাকাগুলো বজায় রাখা হয় — নচ বা হোম ইন্ডিকেটরের নিচে কোনো চ্যাট দেখানো হয় না।
কোনো ক্র্যাশ আপনার অ্যাপে পৌঁছাবে না। লোড ব্যর্থ হলে একটি রিট্রাই অপশন দেখাবে।
কোনো অ্যানালিটিক্স নেই, কোনো ডিভাইসের পরিচয়পত্র নেই, কোনো থার্ড-পার্টি নির্ভরতা নেই। Telybot SDK যোগ করলে আপনার অ্যাপে কোনো ট্র্যাকার যোগ হয় না।
ব্যাক প্রথমে বন্ধ করে গ্রাহক যা দেখছেন। Android-এ খোলা কোনো আইটেম, কার্ট বা বুকিংয়ের উপরে ব্যাক সেটি বন্ধ করে, তারপরেই চ্যাট (SDK 0.2.0 ও পরের সংস্করণ)।

চ্যাটের ভেতরে

এসবই হোস্ট করা পেজ থেকে আসে, তাই SDK আপডেট ছাড়াই প্রতিটি অ্যাপে পৌঁছে যায়:

সাজেশন বোতামসহ একটি স্বাগত বার্তা, বটে সেট করা ভাষায়।
কথোপকথন ডিভাইসে 24 ঘণ্টা রাখা হয়, আর চ্যাট কোনো ভিজিটর আইডি তৈরি করে না। ওয়েবসাইটে একটি কথোপকথন একটি ব্রাউজার ট্যাব পর্যন্ত টেকে। (Ionic SDK-এর ফুল-স্ক্রিন চ্যাটে এর জন্য 0.2.0 লাগে।)
অর্ডার ও বুকিং, ব্যবসা সেগুলি নিলে: একটি কার্ট, বুকিংয়ের তারিখ ও সময়, কোনো অর্ডার বা বুকিং বেশি সময় অপেক্ষায় থাকলে ব্যবসাকে কল করার একটি লিঙ্ক, এবং নিশ্চিত হওয়া বুকিংয়ের জন্য “ক্যালেন্ডারে যোগ করুন”।
সংযুক্তি: ছবি (JPEG, PNG, WebP, GIF) এবং PDF, DOCX, TXT, CSV ও MD ফাইল। সংযুক্তি বোতামের জন্য Android ও Flutter SDK-এর 0.1.4 বা তার পরের সংস্করণ লাগে, আর নথির জন্য Flutter-এর 0.2.0 লাগে।
“ক্যালেন্ডারে যোগ করুন” একটি .ics ফাইলের লিঙ্ক। iOS এটিকে ক্যালেন্ডারে সাবস্ক্রাইব করার ক্যালেন্ডার হিসেবে খোলে। Android ফোনের ক্যালেন্ডার অ্যাপ .ics ফাইল ইমপোর্ট করতে পারলে সেটি প্রস্তাব করে — বর্তমান Google ক্যালেন্ডার পারে — না হলে ব্রাউজার ফাইলটি ডাউনলোড করে।

Client id ফরম্যাট

kb_live_ followed by 8-48 hexadecimal characters

গ্রাহকের সামনে 404 দেখানোর চেয়ে ইনিট (init)-এর সময় বাকি সব বাতিল হয়ে যায়। ক্লায়েন্ট আইডি ডিজাইন অনুযায়ীই পাবলিক—এটি উইজেট এমবেড করা যেকোনো ওয়েবসাইটে দৃশ্যমান—এবং এর মাধ্যমে আপনার অ্যাকাউন্ট পড়া বা পরিবর্তন করার কোনো সুযোগ নেই। সীমাবদ্ধতা ও নিরাপত্তা দেখুন।

উৎস

পাবলিক, MIT-লাইসেন্সপ্রাপ্ত: github.com/telybotai/telybot-Sdks। প্রতিটি প্যাকেজ যে চুক্তির অধীনে থাকে তা ওই রিপোর শীর্ষে CONTRACT.md-এ দেওয়া আছে।