ওয়েবসাইট চ্যাট উইজেট
আপনার ওয়েবসাইটে সরাসরি AI-powered chat widget embed করুন। ভিজিটররা আপনার সাইট না ছেড়ে AI agent থেকে তাৎক্ষণিক উত্তর পায়।
সংক্ষিপ্ত বিবরণ
Website Widget প্রদান করে:
- আপনার ওয়েবসাইটে floating chat bubble
- Real-time streaming AI response
- Customizable appearance (রঙ, position, message)
- ১১KB gzipped-এর কম — প্রায়-শূন্য performance প্রভাব
- নিরাপত্তার জন্য domain allowlisting
পূর্বশর্ত
- আপনার admin panel-এ একটি active AI agent
- আপনার ওয়েবসাইটের HTML-এ access (script tag paste করতে)
সেটআপ ধাপসমূহ
১. Widget তৈরি করুন
- Sidebar থেকে Integrations-এ যান
- Website Widget section-এ scroll করুন
- Create Widget-এ click করুন
- একটি নাম দিন এবং AI agent নির্বাচন করুন
- Create-এ click করুন
২. Appearance customize করুন
Edit sheet খুলতে widget card-এ click করুন:
- Primary Color — Chat bubble এবং header-এর রঙ
- Text Color — Bubble এবং header-এ text-এর রঙ
- Position — নিচে-ডানে বা নিচে-বামে
- Welcome Message — ভিজিটররা প্রথম যে message দেখে
- Suggested Questions — ৪টি পর্যন্ত clickable starter
- Avatar URL — Chat header-এ custom image
- Border Radius — কোণার গোলাকৃতি
আপনি পরিবর্তন করলে live preview আপডেট হয়।
৩. Allowed Domain সেট করুন (সুপারিশকৃত)
কোন ওয়েবসাইট আপনার widget embed করতে পারবে তা সীমাবদ্ধ করুন:
- সব domain অনুমতি দিতে খালি রাখুন (default)
- নির্দিষ্ট domain যোগ করুন:
example.com,*.example.com - Development-এর জন্য port entry ব্যবহার করুন:
localhost:3000
৪. আপনার ওয়েবসাইটে embed করুন
Widget card-এ embed icon-এ click করুন এবং code copy করুন:
<script src="https://core-api.cuneiform.chat/api/widget/widget.js"
data-widget-id="your-widget-id" async></script>আপনার ওয়েবসাইটে closing </body> tag-এর আগে paste করুন।
এটি কীভাবে কাজ করে
ভিজিটর আপনার ওয়েবসাইট খোলে
→ কোণায় chat bubble দেখা যায়
→ ভিজিটর click করে → Chat panel খোলে
→ Welcome message + suggested question দেখা যায়
→ ভিজিটর একটি প্রশ্ন টাইপ করে
→ AI agent আপনার content সার্চ করে
→ Response real-time-এ stream হয়Message real-time-এ প্রক্রিয়া হয়। Agent আপনার content সার্চ করে এবং অন্যান্য সব channel-এর মতো একই AI pipeline ব্যবহার করে response তৈরি করে।
বৈশিষ্ট্যসমূহ
Streaming Response
Response Server-Sent Events (SSE) ব্যবহার করে real-time-এ stream হয়। ভিজিটররা ChatGPT-এর মতো উত্তর ধীরে ধীরে দেখতে পায়।
Session Persistence
একই browser-এ ফিরে আসা ভিজিটররা ২৪ ঘণ্টার window-এর মধ্যে তাদের আগের conversation পুনরায় শুরু করতে পারে। Session browser-এর localStorage-এ সংরক্ষণ করা হয়।
Suggested Question
Chat খুললে ৪টি পর্যন্ত clickable প্রশ্ন configure করুন। সাধারণ বিষয়ের দিকে ভিজিটরদের গাইড করার জন্য দারুণ।
Widget Shadow DOM-এর মধ্যে চলে, তাই এটি আপনার ওয়েবসাইটের style বা JavaScript-এ হস্তক্ষেপ করবে না।
Markdown Rendering
Agent response bold, italic, list, code block, এবং link সহ markdown formatting সমর্থন করে।
Widget পরিচালনা
Integrations page-এ প্রতিটি widget card দেখায়:
- Widget name এবং status
- নির্ধারিত agent
- Edit, embed code, এবং delete action
| Action | কীভাবে |
|---|---|
| Setting edit করুন | Widget card-এ click করুন |
| Embed code পান | Embed icon-এ click করুন |
| মুছুন | Three-dot menu → Delete |
নিরাপত্তা
- Shadow DOM isolation — Widget আপনার page থেকে sandboxed
- HMAC session token — ২৪ ঘণ্টার expiry সহ signed token
- Domain allowlisting — কোন সাইট আপনার widget embed করতে পারবে তা সীমাবদ্ধ করুন
- Rate limiting — প্রতি session-এ ৩০ message/মিনিট
- কোনো data access নেই — Widget আপনার page content পড়তে বা পরিবর্তন করতে পারে না
সমস্যা সমাধান
Widget দেখা যাচ্ছে না
- Script tag
</body>-এর আগে আছে কিনা যাচাই করুন,<head>-এ নয় data-widget-idআপনার admin panel-এর সাথে মিলছে কিনা পরীক্ষা করুন- Domain allowlisting সেট করা থাকলে আপনার domain listed কিনা যাচাই করুন
- Browser console-এ error পরীক্ষা করুন
Widget respond করছে না
- নির্ধারিত agent Active status-এ আছে কিনা নিশ্চিত করুন
- Agent-এর content-এ document আছে কিনা যাচাই করুন
- ব্যর্থ API request-এর জন্য browser Network tab পরীক্ষা করুন
Appearance সমস্যা
Widget Shadow DOM isolation ব্যবহার করে। আপনার page-এর CSS widget-কে প্রভাবিত করবে না। Appearance customize করতে edit sheet-এর live preview ব্যবহার করুন।
FAQ
একাধিক page-এ widget embed করা যায়?
হ্যাঁ। প্রতিটি page-এ একই embed code ব্যবহার করুন। Widget একই domain-এর সব page-এ session state শেয়ার করে।
এটি কি mobile-এ কাজ করে?
হ্যাঁ। Widget সম্পূর্ণ responsive এবং mobile browser-এর জন্য optimized।
“Powered by” badge সরানো যায়?
Trial এবং Starter plan-এ badge আবশ্যক। সরাতে Professional বা উচ্চতর plan-এ upgrade করুন।
এটি কি React/Next.js/Vue-এর সাথে কাজ করে?
হ্যাঁ। Widget standalone script হিসেবে load হয় এবং single-page application সহ যেকোনো framework-এর সাথে কাজ করে।
Message-এর সর্বোচ্চ দৈর্ঘ্য কত?
প্রতি message ৪,০০০ অক্ষর।