همسو چت
شروع رایگان

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

دستیار فروش شما فقط روی سایت نمی‌ماند: همان مغز می‌تواند در تلگرام و بله با مشتری گفتگو کند، در گروه‌ها به سؤال‌ها جواب بدهد، و هر سرنخ یا درخواست اپراتور را به 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 (بعد از این تغییر، بات را یک بار از گروه حذف و دوباره اضافه کنید)، یا بات را در گروه ادمین کنید. در بله نیازی به این تنظیم نیست.

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

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

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

برای اتصال به هر 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 روی پیام خودش، یا دستور خطاب‌شده به خودش. گپ معمولی اعضا را نمی‌خواند و پاسخ نمی‌دهد.

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