دەستپێکردنی خێرا.
لە ماوەی کەمتر لە پێنج خولەکدا.

§ 01Workspace ـی خۆت دروست بکە.

بڕۆ بۆ داشبۆردی نمایش لە پەڕەی چوونەژوورەوە. هەژماری خاوەنی پێشتر دروستکراو بەکار بهێنە، یان لە بەرهەمدا Workspace ێکی نوێ دروست بکە — slug ێک هەڵبژێرە، ئەوە دەبێتە subdomain ـی تۆ (acme.livechattools.com).

لە یەکەم چوونەژوورەوەدا دەگەیتە ناونیشانی نامەکان. هێشتا گفتوگۆی ڕاستەقینە نییە — ئەوەی هەنگاوی دووەم چارەسەری دەکات.

§ 02ویجێتەکە جێبگرە.

سکریپتی لۆدەر بنووسە پێش تاگی داخستن </body> . هەر ئەوەیە — هیچ React component نییە بۆ نووسین، هیچ Vue plugin نییە بۆ تۆمارکردن.

<script>
  window.LivechattoolsConfig = { tenant: 'acme' };
</script>
<script src="https://cdn.livechattools.com/widget-loader.js" async defer></script>

بگۆڕە acme بە slug ـی Workspace ـی خۆت. سکریپتەکە تەمی خۆی ڕاستەوخۆ لە tenant ـی تۆوە دەهێنێت — ڕەنگەکان، نووسین، ئاڵای RTL، و ئاوەتار — کەواتە گۆڕینی دیزاین هەرگیز پێویستی بە re-deploy ـی سایتت نییە.

ناسینی سەردان

ئەگەر سەردانەکە چووە ژوورەوەی بەرهەمەکەت، ناسنامەی پێ بدە بە ویجێتەکە بۆ ئەوەی گفتوگۆکانی EasyLiveChat لەگەڵ خشتەی بەکارهێنەرەکانتدا گرێبدەیتەوە:

window.LivechattoolsConfig = {
  tenant: 'acme',
  identify: {
    id:    'usr_28x91',          // your stable user id
    name:  'Mariam El-Sayed',
    email: 'mariam@example.com',
    locale: 'ar',
    attributes: {
      plan:        'pro',
      mrr_cents:   4900,
      signed_up:   '2024-11-04',
    },
  },
};

§ 03یەکەم وەڵامت بنێرە.

سایتەکەت لە تابێکی تری وێبگەڕدا بکەرەوە، کرتە لە فقاعە بکە و "Hello world" بنووسە. نامەکە بە کاتی ڕاستەقینە لە ڕێگەی کاناڵی Socket.IO وە دەگاتە ناونیشانی داشبۆرد — ژێر چرکە، بەبێ پاشخۆڕی polling.

کرتە بکە ⌘↩ لەسەر هەر وەڵامێکی نوێنەر بۆ ناردنی. سەردانەکە دەبینێت کە نامەکەت لەگەڵ دەنگێکی ناسک دەردەکەوێت و خاڵی ئامادەبوون دەگۆڕێت بۆ "Typing…" کاتێک تۆ دەنووسیت.

§ 04تیمەکەت بانگ بکە.

لە ڕێکخستن → نوێنەران، کرتە بکە لە بانگکردن، و ئیمەیڵ و ڕۆڵ بنووسە. EasyLiveChat لینکێکی یەک-جار بەکارهێنانی بە ئیمەیڵ دەنێرێت؛ کرتە لەسەری وشەی نهێنی دادەنێت و نوێنەری نوێ ڕاستەوخۆ دێتە ناونیشانی نامەکان. ڕۆڵەکان جێبەجێ دەکات کە چی دەبینن — خاوەنان پارەدان بەڕێوەدەبەن، ئەدمینەکان نوێنەرەکان بەڕێوەدەبەن، نوێنەرەکان وەڵام دەدەنەوە.

curl -X POST https://acme.livechattools.com/api/tenant/agents \
  -H "Authorization: Bearer $EASYLIVECHAT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "email":  "noor@acme.test",
        "name":   "Noor Al-Saadi",
        "role":   "ADMIN"
      }'

§ 05کاتژمێرەکانی کار دیاری بکە.

لە دەرەوەی کاتی کار ویجێتەکە دانەرەکە دەگۆڕێت بە فۆڕمی دەرەوەی کات. گفتوگۆکان هێشتا دەگەنە ناونیشانەکەت — ناونیشانیان دەکرێت offline بۆ شوێنپێهەڵگرتنی پاک لە بەیانی دواتر. پەنجەرەکانی ڕۆژانی هەفتە لە ژێر ڕێکبخە ڕێکخستن → کاتژمێرەکانی کار، هەر یەکێک لە کاتی ناوچەی tenant ـی خۆتدا.

{
  "timezone": "Asia/Erbil",
  "schedule": {
    "sunday":    [{ "from": "09:00", "to": "18:00" }],
    "monday":    [{ "from": "09:00", "to": "18:00" }],
    "tuesday":   [{ "from": "09:00", "to": "18:00" }],
    "wednesday": [{ "from": "09:00", "to": "18:00" }],
    "thursday":  [{ "from": "09:00", "to": "18:00" }],
    "friday":    [],
    "saturday":  []
  },
  "offlineMessage": "We're back Sunday at 9. Leave a note — we will reply."
}

§ 06بۆ کوێ بچیت دواتر.

• WhatsApp Cloud گرێبدەژمارەکەت پشتڕاست بکە، Webhook دابنێ، نامەی نموونە بنێرە.→
• بەشداربە لە Webhooks ـە دەرچووەکانهەموو ڕووداوێکی گفتوگۆ بنێرە بۆ ناو data warehouse ـی خۆت.→
• سەرچاوەی API بکەرەوەڕۆچوونێکی پاڵنراو بە EasyLiveChat لە سۆفتوێرەکەتدا دروست بکە.→
• ویجێتەکە بۆ زمانەکەت وەربگێڕەفەرهەنگی JSON، دابەشکردنی کۆد بۆ هەر زمان، RTL ئۆتۆماتیکی.→