Session Link

ডেভেলপার API

আপনার নিজস্ব সিস্টেম থেকে গ্রাহকের কথোপকথনের সরাসরি লিংক নিন; গ্রাহক ও কথোপকথন না থাকলে তৈরি হয়ে যায়।

WhatsApp
Instagram
REST API

MonoStore থেকে ইনস্টল করুন monochat.ai-তে দেখুন

ওভারভিউ

একটি চ্যানেল এবং গ্রাহকের ফোন নম্বর বা ইমেইলসহ একটি API কল এমন একটি লিংক ফেরত দেয় যা MonoChat-এ সেই গ্রাহকের কথোপকথন খোলে। গ্রাহক বা কথোপকথন এখনো না থাকলে সেগুলো তৈরি হয়।

লিংকটি আপনার CRM, হেল্প ডেস্ক বা অর্ডার স্ক্রিনে রাখুন, আপনার টিম সেখান থেকে সরাসরি চ্যাটে চলে যাবে।

হাইলাইট

খুলুন বা তৈরি করুন। নির্দিষ্ট WhatsApp, Instagram বা অন্য চ্যানেলের গ্রাহকের জন্য কাজ করে, ফোন নম্বর বা ইমেইল দিয়ে।
যেতে যেতেই রাউট করুন। একই কলে কথোপকথনটি আইডি বা ইমেইল দিয়ে কোনো এজেন্টকে, অথবা কোনো ওয়ার্কগ্রুপকে দায়িত্ব দিন।
একই গ্রাহক, একই কথোপকথন। একই গ্রাহক ও চ্যানেলের জন্য আবার কল করলে বিদ্যমান কথোপকথনই ফেরত আসে।

ইনস্টল ও সেট আপ

সেটিংস › MonoStore › অ্যাপ থেকে Session Link ইনস্টল করুন, অথবা ইনস্টল লিংক app.monochat.ai/apps/vvKJe8Nbp4EQNy2KA খুলুন। MonoChat অ্যাকাউন্ট না থাকলে লিংকটি আগে সাইন আপ করার সুযোগ দেয় এবং আপনার জন্য অ্যাপটি ইনস্টল করে দেয়।
প্রোফাইল › API টোকেন-এর অধীনে একটি API টোকেন তৈরি করুন। টোকেন শুধু একবারই দেখানো হয়, তাই সঙ্গে সঙ্গে কপি করে নিন। দেখুন API টোকেন।
সেটিংস › Session Link API খুলুন। সেখানকার ডকুমেন্টেশনে আপনার ওয়ার্কস্পেসের সঠিক এন্ডপয়েন্ট ঠিকানা ও কপি করার জন্য তৈরি উদাহরণ অনুরোধ দেখানো আছে। আপনার কোনো একটি চ্যানেলে উদাহরণটি চালিয়ে দেখুন।
আপনার CRM, হেল্প ডেস্ক বা অর্ডার স্ক্রিনে একটি "Chat on WhatsApp" বোতাম যোগ করুন, যা API কল করে এবং ফেরত আসা url খোলে।

নোট

যারা সাইন ইন করা আছেন এবং সেই কথোপকথন দেখার অনুমতি আছে, লিংকটি তাদের জন্য MonoChat খোলে।
কলটি শুধু কথোপকথন খোলে; গ্রাহকের কাছে কোনো মেসেজ পাঠায় না। আগে লিখতে চাইলে WhatsApp Template API ব্যবহার করুন।

ফিচার

কথোপকথনের লিংক

উত্তরে MonoChat-এ কথোপকথন খোলার লিংক এবং কথোপকথনের আইডি থাকে।

প্রয়োজনে গ্রাহক তৈরি হয়

আপনার পাঠানো প্রথম ও শেষ নামে নতুন গ্রাহক তৈরি হয়; উত্তরে জানানো হয় গ্রাহকটি আগে থেকেই পরিচিত ছিল কি না।

দায়িত্ব বণ্টন

আইডি বা ইমেইল দিয়ে কোনো এজেন্টকে, অথবা কোনো ওয়ার্কগ্রুপকে দায়িত্ব দিন।

ডকুমেন্টেশন স্ক্রিন

আপনার ওয়ার্কস্পেসের সঠিক এন্ডপয়েন্ট ঠিকানা ও কপি করার জন্য তৈরি উদাহরণ অনুরোধসহ API রেফারেন্স।

API রেফারেন্স

কলটি JSON বডিসহ একটি POST, যা একটি API টোকেন দিয়ে প্রমাণীকৃত হয়।

POST https://app.monochat.ai/api/<slug>/custom-functions/<app-folder>/methods/session-link.js
Authorization: Bearer <API_TOKEN>
Content-Type: application/json

<slug> হলো আপনার ওয়ার্কস্পেসের টেন্যান্ট স্লাগ, আপনার MonoChat ঠিকানায় /tenants/-এর পরের অংশ।
<app-folder> হলো যে ফোল্ডারে অ্যাপটি ইনস্টল হয়েছে। সেটিংস › Session Link API স্ক্রিনে দুটি অংশই বসানো পূর্ণ ঠিকানা দেখানো হয়।
টোকেনটি প্রোফাইল › API টোকেন-এর অধীনে তৈরি করুন। দেখুন API টোকেন।

অনুরোধের ফিল্ড

ফিল্ড	আবশ্যক	বিবরণ
`connectorBrand`	হ্যাঁ	চ্যানেলের ধরন, যেমন `whatsapp` বা `instagram`।
`channelUsername`	হ্যাঁ	MonoChat-এ আপনার চ্যানেলের ইউজারনেম, যেমন `+` ছাড়া আপনার WhatsApp নম্বর।
`customer.identityType`	হ্যাঁ	`phoneNumber` বা `email`।
`customer.identity`	হ্যাঁ	গ্রাহকের ফোন নম্বর (কান্ট্রি কোডসহ, `+` ছাড়া) বা ইমেইল ঠিকানা।
`customer.firstname`, `customer.lastname`	না	গ্রাহক MonoChat-এ নতুন হলে ব্যবহৃত হয়। ডিফল্ট `-`।
`assignment.type`	না	`agent` (এজেন্ট ইউজার আইডি), `agentIdentity` (এজেন্টের ইমেইল) বা `workgroup` (ওয়ার্কগ্রুপ আইডি)।
`assignment.value`	`assignment.type` থাকলে	যে আইডি বা ইমেইলকে কথোপকথনটি দায়িত্ব দেওয়া হবে।

উদাহরণ অনুরোধ

curl --location 'https://app.monochat.ai/api/<slug>/custom-functions/<app-folder>/methods/session-link.js' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <API_TOKEN>' \
--data '{
  "connectorBrand": "whatsapp",
  "channelUsername": "905334445566",
  "customer": {
    "identityType": "phoneNumber",
    "identity": "905306667788",
    "firstname": "Ayşe",
    "lastname": "Yılmaz"
  },
  "assignment": { "type": "agentIdentity", "value": "sarah@yourcompany.com" }
}'

রেসপন্স

{
  "result": {
    "url": "https://app.monochat.ai/tenants/<slug>?tab=messages&sessionTab=all&filter=…&_id=<sessionId>",
    "sessionId": "Zeii7vpeeFFnsJepZ",
    "isOldUser": true
  }
}

ফিল্ড	বিবরণ
`url`	MonoChat-এ কথোপকথন খোলে।
`sessionId`	কথোপকথনের আইডি। একই চ্যানেলের একই গ্রাহক সবসময় একই কথোপকথন পায়।
`isOldUser`	এই কলে গ্রাহক তৈরি হলে `false`।

ত্রুটি

ব্যর্থ কল একটি ত্রুটির স্ট্যাটাস ও একটি বার্তা দিয়ে উত্তর দেয়:

বার্তা	কারণ
`connectorBrand, channelUsername and customer fields are required`	একটি আবশ্যক শীর্ষ-স্তরের ফিল্ড নেই।
`customer.identityType must be one of: phoneNumber, email`	`identityType` নেই বা অন্য মান আছে।
`customer.identity field is required`	গ্রাহকের ফোন নম্বর বা ইমেইল নেই।
`Channel not found`	আপনার ওয়ার্কস্পেসে সেই ধরন ও ইউজারনেমের কোনো চ্যানেল নেই।
`Customer Channel not found`	গ্রাহককে কোনো চ্যানেল পরিচয়ের সঙ্গে মেলানো যায়নি।
`Agent user not found`	`assignment.value`-তে দেওয়া ইমেইলের কোনো এজেন্ট নেই।
`401`	`Authorization` হেডার নেই বা টোকেন অবৈধ।