هەموو کەناڵێک پەیوەند بکە
لە یەک سندوقی نامەدا.

§ 00چی پێویستە

هەر کەناڵێک ٥–٢٠ خولەکی پێ دەچێت بۆ پەیوەندکردن. کارەکە لە دوو شوێندا دەکەیت: داشبۆردی گەشەپێدەری کەناڵەکە (BotFather بۆ Telegram، Meta Developer Dashboard) و شاشەی Channels لە ناو شوێنی کاری EasyLiveChat-ت لە app.livechattools.com/channels.

هەر چوار کەناڵەکە هەمان بناغەیان هەیە لە EasyLiveChat — یەک Conversation نۆرماڵایزکراو بۆ هەر پەیوەندیدارێک، یەک سندوقی نامە، یەک بۆکسی وەڵامدانەوە. جیاوازییەکان لە بەڵگەنامەکانی پێداویستی هەر دابینکارێک و لە شێوازی واژۆکردنی webhook-یاندایە.

§ 01Telegram

ئاسانترین کەناڵە بۆ ڕێکخستن. Telegram پێویستی بە ئەپلیکەیشنی گەشەپێدەر یان هەژماری بزنس نییە — تەنیا بۆتێک. تۆکنەکانی بۆت بۆ هەمیشە دەمێننەوە و کۆی تەکمیلکردنەکە نزیکەی پێنج خولەکی پێ دەچێت.

١. بۆتێک دروست بکە بە BotFather

Telegram بکەرەوە و چاتێک دەستپێبکە لەگەڵ @BotFather. بنێرە /newbot، ناوی پیشاندان و ناوی بەکارهێنەرێک هەڵبژێرە کە کۆتاییەکەی bot. BotFather بە تۆکنێکی شێوەی ئەمە وەڵام دەداتەوە 1234567890:ABCdefGHI…. کۆپی بکە.

٢. لە EasyLiveChat-ا پەیوەندی بکە

لە شوێنی کارت بڕۆ بۆ Channels → Telegram Bot → Connect. تۆکنی بۆت بپێچە. هەر ناوێکی پیشاندان هەڵبژێرە — تەنیا لە سندوقی نامەدا پیشان دەدرێت. بنێرە.

لەسەر ڕیزە دروستکراوەکە Integration settings بکەرەوە بۆ ئەوەی Webhook secret و ناونیشانی callback-ی تەکمیلکردنەکە دەربکەوێت.

٣. Telegram ڕێنمایی بکە بۆ webhook-ی ئێمە

Telegram Bot API هیچ UI-یەکی بۆ webhooks نییە؛ لە ڕێگەی setWebhook. ڕێکیان دەخەیت. شوێنی شوێنگرەکانی خوارەوە بە تۆکنی بۆت و ID-ی تەکمیلکردن و نهێنی webhook بگۆڕە، پاشان جارێک ئەنجامی بدە:

curl -X POST "https://api.telegram.org/bot${BOT_TOKEN}/setWebhook" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://api.livechattools.com/api/channels/webhook/telegram/${INTEGRATION_ID}",
    "secret_token": "${WEBHOOK_SECRET}",
    "allowed_updates": ["message", "edited_message"]
  }'

Telegram وەڵام دەداتەوە بە {"ok":true,"description":"Webhook was set"}. . تاقی بکەرەوە بە getWebhookInfo — — پێویستە بەهای pending_update_count بکەوێتە بۆ ٠.

٤. تاقی بکەرەوە

بکەرەوە t.me/yourbot_username لە Telegram، کرتە لە Start بکە، هەر نامەیەک بنێرە. پێویستە لە کەمتر لە یەک چرکەدا لە سندوقی EasyLiveChat دەربکەوێت بە ناوی نێرەر و کۆدی زمان. لە داشبۆرد وەڵامی بدەرەوە — کەمێک دواتر دەگاتە Telegram-ی سەردانکار.

§ 02WhatsApp Cloud

Meta Cloud API بەشێوەیەکی گشتی هەڵبژاردنی دروستە بۆ زۆربەی کەسان — تەواو هۆست دەکرێت، بەخۆڕایی بۆ ١٬٠٠٠ گفتوگۆی خزمەتگوزاری مانگانە، و تەنیا گواستنەوەی WhatsApp کە پێویستی بە هیچ بنیادێکی خۆتی نییە. ڕێکخستنەکە لە Telegram قورستر، چونکە Meta ئەپلیکەیشنی گەشەپێدەر و Business Portfolio-ی پشتڕاستکراو دەوێت بۆ ترافیکی پرۆداکشن.

١. ئەپلیکەیشنی گەشەپێدەری Meta دروست بکە

بڕۆ بۆ developers.facebook.com/apps → Create App. ناوێک و ئیمەیلێک هەڵبژێرە، پاشان لە شاشەی دواتر دۆخی بەکارهێنانی “Connect with customers through WhatsApp” هەڵبژێرە. Business Portfolio پەیوەند بکە — یان یەکێکی ئامادە یان Test Business-ی ناودەری Meta بۆ هەڵسەنگاندن.

دوای دروستکردنی ئەپلیکەیشنەکە، Use Cases → Connect on WhatsApp → API Setup بکەرەوە. Phone Number ID دەبینیت (ژمارەی تاقیکردنەوەی Meta بەخۆڕایی، یان ژمارەی خۆت لە دوای زیادکردن) و دوگمەی Generate access token. کرتەی بکە، ڕەزامەند بە، و تۆکنە بەرهەمهاتووەکە کۆپی بکە. هەروەها Phone Number ID-ش کۆپی بکە.

٢. App Secret وەربگرە

لە هەمان داشبۆردی Meta، App settings → Basic بکەرەوە. App Secret پشت دوگمەی Show شاراوەتەوە — دەربخە و کۆپی بکە. ئەمە کلیلی HMAC-ە کە Meta بۆ واژۆکردنی هەر POST-ێکی webhook بەکاری دەهێنێت. بەبێ ئەو، نامە هاتووەکانت بە BAD_SIGNATURE.

٣. WhatsApp لە EasyLiveChat پەیوەند بکە

Channels → WhatsApp Cloud → Connect. ناوی پیشاندان (ئازاد)، Phone Number ID، Access Token، و App Secret پڕ بکەرەوە. بنێرە. ڕێکخستنەکانی تەکمیلکردن بکەرەوە بۆ کۆپیکردنی webhook secret-ی خۆکار و ID-ی تەکمیلکردن.

٤. webhook-ی Meta ڕێک بخە

بگەڕێوە بۆ داشبۆردی Meta، بڕۆ بۆ Use Cases → Connect on WhatsApp → Configuration. بپێچە:

Callback URL : https://api.livechattools.com/api/channels/webhook/whatsapp/${INTEGRATION_ID}
Verify token : ${WEBHOOK_SECRET}

کرتە لە Verify and save بکە. Meta GET handshake دەنێرێت — ئێمە چالنجەکەی ڕەنگ دەکەینەوە ئەگەر verify token یەکسان بێت. لە هەمان لاپەڕە، لیستی Webhook fields بدۆزەرەوە و messages-ەکە بکە Subscribed. بەبێ ئەم گۆڕانە، Meta ناونیشانی webhook قبووڵ دەکات بەڵام هیچ شتێک بۆی ناگەیەنێت.

٥. تاقیکارێک زیاد بکە (تەنیا Sandbox)

ئەگەر ژمارەی تاقیکردنەوەی بەخۆڕایی Meta بەکار دەهێنیت، پێویستە هەر وەرگرێک پێشتر لە لیستی ڕێگەپێدراو زیاد بکەیت پێش ناردن. لە API Setup → To، ژمارەی تەلەفۆن کە لێی دەنێریت زیاد بکە — Meta کۆدی OTP-ی ٦ ژمارەیی دەنێرێت بۆ پشتڕاستکردنەوە. دەتوانیت تا پێنج وەرگری تاقیکردنەوە زیاد بکەیت. ژمارە راستەقینەکانی بزنس ئەم سنوورەیان نییە.

§ 03Facebook Messenger

Messenger هەمان Meta App و App Secret و سیستەمی webhook-ی WhatsApp بەکار دەهێنێت — بەڵام لە گەڵ Facebook Page دەدوێت لە جیاتی ژمارەی تەلەفۆن، و توکنەکانی دەستڕاگەیشتن Page Access Token-ن، نەک توکنی WhatsApp Business.

١. Messenger زیاد بکە بۆ Meta App-ەکەت

لە هەمان ئەپلیکەیشنی WhatsApp-ت بەکار هێناوە (یان یەکێکی نوێ)، Use cases → Add use cases → فلتەری Business messaging → Engage with customers on Messenger from Meta بکەرەوە. پاشەکەوت بکە. ئەپلیکەیشنەکە ئێستا دوو بەرهەمی هاوبەشی هەیە.

٢. پەڕەی Facebook پەیوەند بکە

Messenger from Meta → Messenger API Settings بکەرەوە. لە ژێر Generate access tokens کرتە لە Connect بکە لە تەنیشت No FB pages yet. Meta دەپرسێت چ پەڕەیەک ڕێگەی پێدەدەیت — ئەوەی دەتەوێت نامەی لەسەری وەربگریت هەڵبژێرە، مۆڵەتەکان قبووڵ بکە، پاشەکەوت بکە.

پەڕەکە ئێستا لەگەڵ Page Access Token-ی یەک کرتە و Page ID دەردەکەوێت. هەردووکیان کۆپی بکە. Page ID هەروەها ئەو بەهایەیە کە وەک pageId لە EasyLiveChat دادەنێیت.

٣. Messenger لە EasyLiveChat پەیوەند بکە

Channels → Messenger → Connect. Page ID و Page Access Token و هەمان App Secret-ی WhatsApp-ت بەکار هێناوە پڕ بکەرەوە. بنێرە و webhook secret و ID-ی تەکمیلکردنە نوێیە کۆپی بکە.

٤. ئابوونەی webhook بە دوو چین

Messenger خاسیەتێکی هەیە کە WhatsApp نییەتی: پێویستی بە دوو ئابوونە هەیە بۆ گەیاندنی هیچ شتێک. یەکەم ئابوونەی ئاستی ئەپ — لە Messenger API Settings → Configure webhooks بپێچە:

Callback URL : https://api.livechattools.com/api/channels/webhook/messenger/${INTEGRATION_ID}
Verify token : ${WEBHOOK_SECRET}

Verify and save بکە، پاشان Webhook fields ڕاکێشە و messages-ەکە بکە چالاک. پاشان ئابوونەی ئاستی پەڕە، کە لە UI ناتوانیت بیکەیت — ئەم curl-ە ئەنجام بدە:

curl -X POST "https://graph.facebook.com/v20.0/${PAGE_ID}/subscribed_apps" \
  -d "subscribed_fields=messages,messaging_postbacks,message_deliveries,message_reads" \
  -d "access_token=${PAGE_ACCESS_TOKEN}"

بەبێ ئابوونەی ئاستی پەڕە، Meta {"success":true} وەڵام دەداتەوە لەسەر ئابوونەی ئەپ بەڵام لە ڕاستیدا webhook ناجوڵێنێت. دەتوانیت دڵنیا بیتەوە کە هەموو شت گونجاوە بە پرسیار:

curl "https://graph.facebook.com/v20.0/${APP_ID}/subscriptions?access_token=${APP_ID}|${APP_SECRET}"

وەڵامەکە پێویستە ئۆبجێکتێک لە جۆری page لیست بکات لەگەڵ fields ی پڕ کە تێیدابێت messages.

§ 04Instagram DM

نامەنووسینی Instagram بەسەر هەمان بۆڕی Messenger Platform-دا دەڕوات بەڵام دوو مەرجی زیادە: هەژماری Instagram دەبێت هەژماری بزنس بێت (نەک شەخسی یان Creator)، و دەبێت پەیوەند بێت بە پەڕەی Facebook لە هەمان Business Portfolio. کاتێک هەردوو ڕاست بن، Page Access Token-ت توکنی دەستڕاگەیشتنی Instagram-یشە.

١. هەژماری IG بکە بە Business

لەسەر ئەپلیکەیشنی موبایلی Instagram: Settings → Account → Switch to professional account → Business. هەر جۆرێک هەڵبژێرە. گۆڕانکارییەکە دەگەڕێتەوە.

٢. هەژماری IG زیاد بکە بۆ Business Portfolio-ت

لە Meta Business Suite Settings → Accounts → Instagram accounts → Add → بە بەڵگەنامەی IG چووژوور. Meta پشتڕاست دەکاتەوە و Instagram Business Account ID پیشان دەدات — ژمارەیەکی ١٧ خانە کە دەستپێدەکات بە 1784…. کۆپی بکە؛ ئەمە pageId بۆ تەکمیلکردنی EasyLiveChat-ە.

٣. IG پەیوەند بکە بە پەڕەی Facebook

ئەمە لە هەموو بەزرترین هەنگاوە. Inbox-ی پەڕەی Facebook بکەرەوە لە Meta Business Suite — business.facebook.com/latest/inbox?asset_id={page_id}. بەنەرێکی “Connect to Instagram” لەگەڵ دوگمەی Connect دەخوێنیتەوە. کرتە، چووژوور بۆ Instagram، مۆڵەتە داواکراوەکان بدە، پشتڕاست بکەرەوە. لە دوای ئەمە Graph API-ی Meta دەستپێدەکات بە وەڵامدانەوەی پرسیارەکان دەربارەی هەژماری IG لە چوارچێوەی توکنی دەستڕاگەیشتنی پەڕە.

٤. Instagram لە EasyLiveChat پەیوەند بکە

Channels → Instagram DM → Connect. IG Business Account ID-ی هەنگاوی ٢ وەک pageIdبەکار بهێنە، هەمان Page Access Token-ی Messenger وەک pageAccessToken، و هەمان App Secret-ی پێشوو.

٥. لە هەردوو ئاست ئابوونە بکە

Instagram object=instagram بەکار دەهێنێت بۆ webhook-ی ئاستی ئەپ (Messenger object=page. بەکار دەهێنا). ئەم curl-ە زیاد بکە لەسەر ئابوونەی Messenger-ت کە هەتە:

curl -X POST "https://graph.facebook.com/v20.0/${APP_ID}/subscriptions" \
  -d "object=instagram" \
  -d "callback_url=https://api.livechattools.com/api/channels/webhook/instagram/${INTEGRATION_ID}" \
  -d "verify_token=${WEBHOOK_SECRET}" \
  -d "fields=messages,messaging_postbacks,message_reactions" \
  -d "access_token=${APP_ID}|${APP_SECRET}"

§ 05چارەسەری کێشە