Session Link

د پراختیاکوونکو API

له خپلو سیستمونو څخه د پیرودونکي د خبرو اترو مستقیم لینک ترلاسه کړئ؛ که پیرودونکی او خبرې اترې نه وي، جوړیږي.

WhatsApp
Instagram
REST API

له MonoStore څخه نصب کړئ په monochat.ai کې یې وګورئ

لنډه کتنه

یو API کال د یو چینل او د پیرودونکي د تلیفون شمېرې یا ایمیل سره یو لینک بیرته ورکوي چې په MonoChat کې د هغه پیرودونکي خبرې اترې پرانیزي. که پیرودونکی یا خبرې اترې لا نه وي، جوړیږي.

لینک خپل CRM، د مرستې ډیسک یا د فرمایش سکرین کې کېږدئ او ستاسو ټیم له هغه ځایه مستقیم چټ ته ځي.

مهمې ځانګړتیاوې

خلاص کړئ یا جوړ کړئ. د یو ټاکلي WhatsApp، Instagram یا بل چینل پیرودونکي لپاره کار کوي، د تلیفون شمېرې یا ایمیل له لارې.
په لاره کې لارښوونه. په همدې کال کې خبرې اترې د ID یا ایمیل له لارې یو اجنټ ته، یا یوې کاري ډلې ته وسپارئ.
ورته پیرودونکی، ورته خبرې اترې. د همدې پیرودونکي او چینل لپاره بیا کال کول شته خبرې اترې بیرته ورکوي.

نصب او تنظیم

Session Link له تنظیمات › MonoStore › اپلیکېشنونه څخه نصب کړئ، یا د نصب لینک app.monochat.ai/apps/vvKJe8Nbp4EQNy2KA پرانیزئ. که د MonoChat حساب نلرئ، لینک تاسو ته اجازه درکوي لومړی نوملیکنه وکړئ او اپ ستاسو لپاره نصبوي.
د پروفایل › API ټوکنونه لاندې یو API ټوکن جوړ کړئ. ټوکن یوازې یو ځل ښودل کیږي، نو سمدلاسه یې کاپي کړئ. API ټوکنونه وګورئ.
تنظیمات › Session Link API پرانیزئ. هلته اسناد ستاسو د کاري ځای د اینډپوینټ دقیقه پته او د کاپي لپاره چمتو بیلګې غوښتنې ښيي. بیلګه د خپل یو چینل سره وازمایئ.
خپل CRM، د مرستې ډیسک یا د فرمایش سکرین کې یوه "Chat on WhatsApp" تڼۍ اضافه کړئ چې API ته غږ کوي او بیرته ورکړل شوی url پرانیزي.

یادښت

لینک MonoChat هغو کسانو ته پرانیزي چې ننوتي دي او د هغو خبرو اترو لیدلو اجازه لري.
کال یوازې خبرې اترې پرانیزي؛ پیرودونکي ته پیغام نه لیږي. د لومړي لیکلو لپاره WhatsApp Template API وکاروئ.

ځانګړتیاوې

د خبرو اترو لینک

ځواب هغه لینک ورکوي چې په MonoChat کې خبرې اترې پرانیزي او د خبرو اترو ID.

که اړتیا وي پیرودونکی جوړیږي

یو نوی پیرودونکی ستاسو د لیږل شوي لومړي او وروستي نوم سره جوړیږي؛ ځواب وايي چې پیرودونکی دمخه پیژندل شوی و که نه.

سپارنه

د ID یا ایمیل له لارې یو اجنټ ته، یا یوې کاري ډلې ته وسپارئ.

د اسنادو سکرین

د API مرجع، د ستاسو د کاري ځای د اینډپوینټ دقیقه پته او د کاپي لپاره چمتو بیلګې غوښتنې.

د API مرجع

کال یو POST دی د JSON بدن سره، چې د 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> ستاسو د کاري ځای tenant 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` (د اجنټ کارن ID)، `agentIdentity` (د اجنټ ایمیل) یا `workgroup` (د کاري ډلې ID).
`assignment.value`	له `assignment.type` سره	هغه ID یا ایمیل چې خبرې اترې ورکول کیږي.

د غوښتنې بیلګه

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`	د خبرو اترو ID. په ورته چینل کې ورته پیرودونکی تل ورته خبرې اترې ترلاسه کوي.
`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` سرلیک نشته یا ټوکن ناسم دی.