راهنمای پیام‌رسان‌ها و اتصال‌ها

دستیار فروش شما فقط روی سایت نمی‌ماند: همان مغز می‌تواند در تلگرام و بله با مشتری گفتگو کند، در گروه‌ها به سؤال‌ها جواب بدهد، و هر سرنخ یا درخواست اپراتور را به CRM یا هر سیستم دیگری بفرستد. همهٔ این‌ها از پنل → «پیام‌رسان‌ها و اتصال‌ها» تنظیم می‌شود. آخرین به‌روزرسانی: ۱۵ مهر ۱۴۰۵.

۱. اتصال به تلگرام

  1. در تلگرام به @BotFather پیام بدهید و /newbot را بزنید. یک نام (مثلاً «فروشگاه نیلو») و یک نام کاربری که به bot ختم شود (مثلاً niloo_shop_bot) انتخاب کنید.
  2. BotFather یک توکن می‌دهد (شبیه 123456789:AAH…). این توکن مثل رمز است؛ آن را جایی غیر از پنل همسو چت وارد نکنید.
  3. در پنل همسو چت → «پیام‌رسان‌ها و اتصال‌ها» → کارت تلگرام → توکن را بچسبانید → اتصال. نام کاربری بات و برچسب «متصل» ظاهر می‌شود.
  4. اختیاری ولی توصیه‌شده: در BotFather با /setuserpic عکس، با /setdescription توضیح و با /setabouttext متن «درباره» را تنظیم کنید. برای پاسخ در گروه‌ها بخش گروه‌ها را ببینید.

حالت دریافت webhook یا polling؟ بعد از اتصال، کارت تلگرام یکی از این دو را نشان می‌دهد. هر دو درست کار می‌کنند؛ polling یعنی سرورهای تلگرام نتوانستند مستقیم به سرور ما وصل شوند و دستیار خودش پیام‌ها را می‌گیرد. برای شما تفاوتی ندارد.

چه چیزهایی کار می‌کند: /start پیام خوش‌آمد و سؤالات پیشنهادی را می‌فرستد؛ هر پیام متنی مثل ویجت سایت پاسخ می‌گیرد؛ محصولات با عکس، قیمت و دکمهٔ «مشاهده محصول» می‌آیند؛ اگر دستیار گفتگو را به اپراتور بسپارد، پاسخ شما از صندوق پنل به همان چت تلگرام می‌رود (متن و پیام صوتی). ویس مشتری هم (تا ۲ دقیقه) به متن تبدیل و جواب داده می‌شود. پیام‌های تصویری و صوتی مشتری فعلاً خوانده نمی‌شوند و دستیار مؤدبانه متن می‌خواهد.

۲. اتصال به بله

  1. در بله به @botfather پیام بدهید و با /newbot بات بسازید؛ توکن را کپی کنید.
  2. پنل → «پیام‌رسان‌ها و اتصال‌ها» → کارت بله → توکن → اتصال.

بله یک سرویس داخلی است و بدون واسطه از سرور ما در دسترس است؛ همهٔ قابلیت‌های تلگرام (کارت محصول، تحویل به اپراتور، پیام صوتی اپراتور) در بله هم هست.

۳. پاسخ‌گویی در گروه‌ها

بات را به گروه تلگرام یا بلهٔ خودتان (مثلاً گروه مشتریان یا نمایندگان فروش) اضافه کنید. در گروه، دستیار ساکت می‌ماند و فقط وقتی جواب می‌دهد که کسی:

  • نام کاربری بات را منشن کند: @niloo_shop_bot یه کفش ورزشی تا دو میلیون می‌خوام
  • روی یکی از پیام‌های بات Reply بزند (ادامهٔ همان گفتگو)
  • یک دستور را به بات خطاب کند: /ask@niloo_shop_bot شرایط مرجوعی چیه؟

پاسخ همیشه به‌صورت Reply زیر پیام همان شخص می‌آید تا معلوم باشد جواب چه کسی است. هر عضو گروه گفتگوی جداگانه‌ای دارد (سابقهٔ سؤال‌هایش با دیگران قاطی نمی‌شود) و در صندوق پنل با برچسب «در گروه …» دیده می‌شود. اگر دستیار گفتگویی را به اپراتور بسپارد، پاسخ شما در گروه با نام همان عضو شروع می‌شود.

تنظیم لازم در تلگرام: بات‌های تلگرام به‌صورت پیش‌فرض در گروه فقط دستورها را می‌بینند، نه منشن‌ها را. برای این‌که منشن کار کند یکی از این دو کار را بکنید: در BotFather با /setprivacy → انتخاب بات → Disable (بعد از این تغییر، بات را یک بار از گروه حذف و دوباره اضافه کنید)، یا بات را در گروه ادمین کنید. در بله نیازی به این تنظیم نیست.

۳.۵. اینستاگرام (دایرکت و کامنت‌ها) — به‌زودی

این قابلیت ساخته شده و منتظر تأیید برنامهٔ ما توسط Meta است؛ به‌محض فعال‌شدن، کارت «اینستاگرام» در پنل ظاهر می‌شود. چه کار می‌کند:

  • دایرکت: دستیار مثل سایت و تلگرام به پیام‌های دایرکت جواب می‌دهد (محصولات به‌صورت کارت با عکس و دکمهٔ خرید). تحویل به اپراتور و پاسخ از پنل هم کار می‌کند.
  • کامنت‌ها: می‌توانید انتخاب کنید کامنت‌های سؤالی را دستیار به‌صورت پیام خصوصی جواب بدهد (اینستاگرام برای هر کامنت یک پیام خصوصی اجازه می‌دهد).
  • کلیدواژه‌ها: قاعده بسازید: «اگر کامنت یا دایرکت شامل قیمت بود → زیر کامنت بنویس «قیمت رو دایرکت کردیم 🙏» و در دایرکت لیست قیمت را بفرست». هر قاعده را می‌توانید به یک پست خاص محدود کنید یا روی همهٔ پست‌ها بگذارید؛ به‌جای متن ثابت می‌توانید بنویسید ai تا دستیار جواب بدهد.

پیش‌نیاز حساب شما: حساب Business یا Creator، و در اینستاگرام: Settings → Messages and story replies → Message controls → Allow access to messages روشن باشد. اتصال با دکمهٔ «اتصال با حساب اینستاگرام» و ورود به حساب خودتان انجام می‌شود؛ رمز اینستاگرام هیچ‌وقت به ما داده نمی‌شود.

۳.۷. واتس‌اپ (اتصال با QR)

شمارهٔ واتس‌اپ فروشگاه را درست مثل «واتس‌اپ وب» وصل می‌کنید: در پنل، تب «پیام‌رسان‌ها» ← کارت واتس‌اپ ← «اتصال واتس‌اپ با QR»، بعد در گوشی تنظیمات ← دستگاه‌های متصل ← اتصال دستگاه و اسکن کد. از آن به بعد دستیار به پیام‌های خصوصی مشتری‌ها در همان واتس‌اپ جواب می‌دهد، محصول را با عکس، قیمت و لینک می‌فرستد و هر جا لازم شد گفتگو را به شما تحویل می‌دهد.

  • وقتی خودتان جواب می‌دهید: اگر از گوشی در گفتگویی پیام بدهید، دستیار همان‌جا ساکت می‌شود (مدتش را در کارت تنظیم می‌کنید، پیش‌فرض ۲ ساعت) و پاسخ شما در «گفتگوها» هم دیده می‌شود. پاسخ از پنل یا اپ هم مثل بقیهٔ پیام‌رسان‌ها به واتس‌اپ مشتری می‌رود.
  • پیام صوتی مشتری: ویس‌های تا ۲ دقیقه به متن تبدیل می‌شوند و دستیار به همان جواب می‌دهد؛ متنش با علامت 🎤 در «گفتگوها» می‌آید. عکس، فایل و استیکر هنوز خوانده نمی‌شود.
  • چه چیزهایی نادیده گرفته می‌شود: گروه‌ها، استوری‌ها، کانال‌ها و پیام‌های خودتان. دستیار هیچ‌وقت خودش پیامی را شروع نمی‌کند.
  • اگر گوشی خارج شد: وضعیت کارت «قطع» می‌شود؛ «نمایش QR» را بزنید و دوباره اسکن کنید. گوشی باید گاهی آنلاین باشد، وگرنه واتس‌اپ بعد از مدتی دستگاه متصل را خارج می‌کند.

مهم: این اتصال از API رسمی متا استفاده نمی‌کند. واتس‌اپ شماره‌هایی را که رفتار ربات‌گونه یا تبلیغاتی دارند مسدود می‌کند؛ چون دستیار فقط به پیام‌های ورودی جواب می‌دهد ریسک کم است، ولی صفر نیست. یک شمارهٔ جداگانه برای فروشگاه وصل کنید، نه شمارهٔ شخصی‌تان، و برای ارسال انبوه از آن استفاده نکنید.

۴. پاسخ اپراتور به گفتگوهای پیام‌رسان

اعلان در تلگرام یا بلهٔ خودتان

لازم نیست پنل را باز نگه دارید: در صفحهٔ «گفتگوها» → 🔔 اعلان در پیام‌رسان → «دریافت اعلان در تلگرام/بله» → لینکی می‌گیرید که شما را به بات فروشگاه می‌برد؛ Start را بزنید و تمام. از آن به بعد هر «درخواست اپراتور» و هر «سرنخ جدید» با نام مشتری، آخرین پیامش و لینک مستقیم به گفتگو در چت خودتان می‌آید. هر همکار این کار را برای خودش انجام می‌دهد؛ مالک فهرست همه را می‌بیند. برای قطع، به بات /stop بفرستید یا در پنل «قطع» بزنید.

گفتگوهای تلگرام و بله در همان صفحهٔ «گفتگوها»ی پنل و در اپ اندروید اپراتور می‌آیند، با برچسب پیام‌رسان و نام مشتری. هر پاسخی که از آن‌جا بفرستید (متن یا 🎤 پیام صوتی) به پیام‌رسان می‌رود و زیر پیام «✓ در پیام‌رسان ارسال شد» می‌خورد. اگر مشتری بات را مسدود کرده باشد، بالای گفتگو هشدار می‌بینید. با «بازگرداندن به بات» دستیار دوباره خودش جواب می‌دهد.

۵. وب‌هوک: ارسال سرنخ‌ها و درخواست‌های اپراتور به سیستم شما

برای اتصال به هر CRM، اتوماسیون (n8n، Make، Zapier) یا بک‌اند خودتان. در تب وب‌هوک یک آدرس https اضافه کنید و رویدادها را انتخاب کنید. یک کلید امضا فقط یک بار نشان داده می‌شود؛ آن را ذخیره کنید. حداکثر ۵ وب‌هوک برای هر فروشگاه.

رویدادکی ارسال می‌شودمهم‌ترین فیلدهای data
lead.createdوقتی مشتری نام/شماره/ایمیلش را به دستیار می‌دهدlead.name, lead.phone, lead.email, lead.interest, session.channel, session.page_url, session.panel_url
handoff.requestedوقتی دستیار گفتگو را به اپراتور می‌سپاردreason, recent[] (آخرین پیام‌ها), session.*
pingبا دکمهٔ «ارسال تست»message

هر درخواست یک POST با بدنهٔ JSON است و این هدرها را دارد:

  • X-Hamsochat-Event نام رویداد · X-Hamsochat-Delivery شناسهٔ یکتای تحویل (برای جلوگیری از پردازش دوباره) · X-Hamsochat-Timestamp زمان ارسال (ثانیهٔ یونیکس)
  • X-Hamsochat-Signature = sha256=HMAC-SHA256(secret, timestamp + "." + rawBody)
// Node.js — verify a Hamsochat webhook
const crypto = require('crypto');
function verify(req, rawBody, secret) {
  const ts = req.headers['x-hamsochat-timestamp'];
  if (Math.abs(Date.now() / 1000 - Number(ts)) > 300) return false;           // replay window: 5 min
  const expected = 'sha256=' + crypto.createHmac('sha256', secret).update(ts + '.' + rawBody).digest('hex');
  const got = req.headers['x-hamsochat-signature'] || '';
  return expected.length === got.length && crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(got));
}
// body: { id, event, created_at, data: { leadId, sessionId, lead: {...}, session: {...} } }

اگر آدرس شما ۲xx برنگرداند، تا ۵ بار با فاصلهٔ فزاینده (حدود ۱۵ دقیقه) دوباره تلاش می‌کنیم؛ پاسخ ۴xx یعنی «قبول ندارم» و تکرار نمی‌شود. همهٔ تحویل‌ها با کد پاسخ و خطا در پنل («سوابق») دیده می‌شوند و تحویل ناموفق را می‌توانید دوباره بفرستید.

۶. اتصال مستقیم به CRM

دیدار

  1. در دیدار: تنظیمات → اتصال به سرورهای دیگر → اتصال به دیدار → ساخت API جدید؛ کلید را کپی کنید (فقط مدیر سیستم دسترسی دارد).
  2. پنل همسو چت → تب CRM → کارت دیدار → کلید API → «اتصال و تست».

بعد از آن برای هر سرنخ، مخاطب در دیدار با شمارهٔ موبایل جستجو می‌شود؛ اگر نبود ساخته می‌شود، و یک یادداشت با جزئیات (علاقه‌مندی، کانال، لینک گفتگو در پنل) روی مخاطب ثبت می‌شود. درخواست‌های اپراتور هم به‌صورت یادداشت با آخرین پیام‌های مشتری می‌روند. اگر دیدار برای ساخت مخاطب «کاربر مسئول» بخواهد، شناسهٔ کاربر را در فیلد اختیاری وارد کنید.

پیام‌گستر (بتا)

آدرس نصب پیام‌گستر خودتان (مثلاً https://crm.example.com) و یک کاربر وب‌سرویس را از مدیر سیستم بگیرید و در کارت پیام‌گستر وارد کنید. نسخه‌های پیام‌گستر با هم فرق دارند؛ اگر «تست اتصال» خطا داد، نسخه و پیام خطا را برای پشتیبانی بفرستید تا تطبیق بدهیم.

CRM دیگری دارید؟ از وب‌هوک استفاده کنید؛ تقریباً همهٔ CRMها یا با n8n/Make وصل می‌شوند یا API دریافت وب‌هوک دارند.

۷. اعلان در ایتا

ایتا رابط دوطرفه برای بات ندارد، پس دستیار نمی‌تواند در ایتا گفتگو کند؛ ولی می‌توانید سرنخ‌های جدید و درخواست‌های اپراتور را به‌صورت پیام در کانال یا گروه ایتای تیم فروش بگیرید. از ایتایار توکن بگیرید، کانال/گروه را در پنل ایتایار اضافه کنید و شناسهٔ آن را همراه توکن در کارت «اعلان در ایتا» وارد کنید.

سؤالات متداول

این امکانات در کدام پلن است؟

پیام‌رسان‌ها (تلگرام، بله، گروه‌ها) در پلن پرو؛ وب‌هوک، CRM و اعلان ایتا از پلن بیزینس به بالا. جزئیات در صفحهٔ قیمت‌ها.

توکن بات کجا نگهداری می‌شود؟

رمزشده در سرور همسو چت؛ در پنل فقط ۴ کاراکتر آخرش دیده می‌شود. با «قطع اتصال» حذف می‌شود و webhook بات هم برداشته می‌شود.

پیام‌های پیام‌رسان از سهمیهٔ ماهانه کم می‌شود؟

بله، هر پاسخ دستیار (در سایت یا پیام‌رسان) یک پیام از سهمیهٔ پلن است. پاسخ اپراتور و دستور /start شمرده نمی‌شوند.

می‌توانم یک بات را برای دو فروشگاه استفاده کنم؟

نه؛ هر بات به یک فروشگاه وصل می‌شود. برای هر فروشگاه یک بات جدا بسازید.

دستیار در گروه به همهٔ پیام‌ها جواب می‌دهد؟

نه. فقط به منشن، Reply روی پیام خودش، یا دستور خطاب‌شده به خودش. گپ معمولی اعضا را نمی‌خواند و پاسخ نمی‌دهد.

سؤال دیگری دارید؟ از پنل تیکت بزنید یا به تماس با ما سر بزنید.