مستندات

اپ‌ها و یکپارچه‌سازی‌ها

ابزارهایی را که تیم شما همین حالا استفاده می‌کند وصل کنید — Stripe، Shopify، Mailchimp، MailerLite، Jira و Tracio. اپ‌های نصب‌شده دادهٔ زندهٔ مشتری را به‌صورت کارت در پنل گفت‌وگوی صندوق ورودی، درست کنار چت، نشان می‌دهند.

نمای کلی#

بازار اپ‌ها در تنظیمات ← اپ‌ها قرار دارد. اپ‌ها یک بار و برای کل فضای کاری نصب می‌شوند: یک مدیر، سرویس را با اعتبارنامه‌های خودِ فضای کاری وصل می‌کند و هر هم‌تیمی‌ای که به صندوق ورودی دسترسی دارد کارت حاصل را در پنل گفت‌وگو می‌بیند. کارشناسان هرگز خودشان چیزی نصب نمی‌کنند — و عامل‌های هوش مصنوعی هم هرگز چیزی نصب نمی‌کنند.

نصب در سطح فضای کاری

یک مجموعه اعتبارنامه برای هر فضای کاری. نصب، ویرایش یا حذف یک اپ یک‌جا روی همه اثر می‌گذارد.

کارت‌ها در صندوق ورودی

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

بدون حشو

هر چیزی که در کاتالوگ فهرست شده همین امروز قابل نصب است — بخش «به‌زودی» وجود ندارد. با کاشی درخواست می‌توانید بگویید کدام سرویس جایش خالی است.

مدیریت اپ‌ها نیازمند دسترسی نصب و پیکربندی اپ‌ها است (به‌طور پیش‌فرض در نقش‌های مالک و مدیر گنجانده شده و به نقش‌های سفارشی هم قابل اعطاست). هم‌تیمی‌های بدون این دسترسی همچنان کارت‌های اپ را در گفت‌وگوها می‌بینند — فقط نمی‌توانند چیزی نصب یا دوباره پیکربندی کنند.

کاتالوگ اپ‌ها#

امروز شش اپ در دسترس است:

اپدستهکارشناسان در گفت‌وگو چه می‌بینند
Stripeپرداخت‌هااشتراک و پرداخت‌های اخیرِ کسی که با او صحبت می‌کنید
Shopifyتجارتسفارش‌های اخیر با وضعیت پرداخت و تحویل
Mailchimpبازاریابیوضعیت اشتراک، مخاطبان و برچسب‌های کسی که با او صحبت می‌کنید
MailerLiteبازاریابیوضعیت اشتراک، گروه‌ها و تاریخ ثبت‌نام کسی که با او صحبت می‌کنید
Jiraپیگیری مسئله‌هامسئله‌های پیوندخورده به این گفت‌وگو، و ساخت مسئلهٔ تازه با یک کلیک
Tracioامنیتانسان یا بات: رأی Tracio دربارهٔ بازدیدکنندهٔ ویجت چت

دنبال یک لینک ساده به سامانهٔ داخلی خودتان هستید؟ آن نه حساب می‌خواهد و نه توکن، پس به‌جای کاتالوگ اپ‌ها در تنظیمات ← عمومی ← لینک به سامانه‌های شما قرار دارد.

نصب یک اپ#

تنظیمات ← اپ‌ها را باز کنید، یک کاشی را انتخاب کنید و اعتبارنامه‌هایی را که اپ می‌خواهد وارد کنید. هر فیلد به همان صفحه‌ای در داشبورد آن سرویس لینک می‌دهد که مقدار در آن ساخته یا پیدا می‌شود.

گامتوضیح
1. پیش‌نمایش را ببینیدپیش از آنکه چیزی جای‌گذاری کنید، صفحهٔ پیکربندی نمونه‌ای از همان کارتی را نشان می‌دهد که کارشناسان شما خواهند دید — با دادهٔ ساختگی، تا پیش از ذخیرهٔ هر اعتبارنامه‌ای بدانید چه چیزی را با فضای کاری به اشتراک می‌گذارید.
2. اعتبارنامه‌ها را وارد کنیدکلید API یا توکن را جای‌گذاری کنید. مقادیر خودکار پیرایش می‌شوند — فاصله یا خط جدیدِ اضافه از کپی‌پیست نصب را خراب نمی‌کند.
3. ذخیره و آزمایشذخیره‌کردن پیکربندی را نگه می‌دارد؛ آزمایش اتصال یک درخواست واقعی به سرویس می‌فرستد و همین است که چیپ وضعیت را سبز می‌کند.

هر کاشی اپ یک چیپ وضعیت دارد که می‌گوید نصب در چه مرحله‌ای است:

وضعیتمعنا
آزمایش‌نشدهاعتبارنامه‌ها ذخیره شده‌اند، اما اپ هنوز به یک درخواست واقعی پاسخ نداده است.
متصلسرویس واقعاً پاسخ داده — اتصال تأیید شده است، نه فقط ذخیره.
نیازمند توجهسرویس اعتبارنامه‌های ذخیره‌شده را رد کرده (کلید باطل یا منقضی). کارت‌ها تا وقتی یک مدیر اپ را دوباره ذخیره یا آزمایش کند، دیگر با سرویس تماس نمی‌گیرند.
خطاچیز دیگری خراب شده — راهنمای ابزارک را ببینید.
غیرفعالیک مدیر اپ را خاموش کرده است. کارت از صندوق ورودی ناپدید می‌شود بی‌آنکه اعتبارنامه‌ها حذف شوند.

اعتبارنامه‌ها و امنیت#

اعتبارنامه‌های اپ به فضای کاری تعلق دارند و چند قاعده آن‌ها را امن نگه می‌دارد:

  • رمزنگاری در حالت سکون. فیلدهای محرمانه (کلیدهای API، توکن‌ها) در ذخیره‌سازی به‌ازای هر کلید رمزنگاری می‌شوند و پس از ذخیره هرگز دوباره نمایش داده نمی‌شوند.
  • حداقل دسترسی هر جا سرویس اجازه دهد. Stripe باید با یک کلید محدود وصل شود که بتواند Customers، Subscriptions، Charges و Invoices را بخواند — به‌علاوهٔ دسترسی نوشتن Refunds فقط اگر قرار است کارشناسان از داخل گفت‌وگو بازپرداخت انجام دهند. اگر کلید تمام‌دسترسی جای‌گذاری کنید باز هم کار می‌کند، اما صفحهٔ تنظیمات توصیه می‌کند آن را عوض کنید.
  • جابه‌جایی مقصد، محرمانه را دوباره می‌پرسد. ویرایش فیلدی که اعتبارنامه به آن گره خورده — دامنهٔ فروشگاه Shopify، نشانی سایت Jira — واردکردن دوبارهٔ توکن را لازم می‌کند، تا یک اعتبارنامهٔ ذخیره‌شده هرگز نتواند به میزبانی که برایش نبوده هدایت شود.
  • باطل‌کردن روی کل فضای کاری اثر می‌گذارد. برای هر اپ در هر فضای کاری فقط یک نصب وجود دارد: اگر کلید را در سرویس بچرخانید یا باطل کنید، کارت همهٔ هم‌تیمی‌ها از کار می‌افتد تا وقتی یک مدیر آن را در تنظیمات ← اپ‌ها به‌روز کند.

کارت‌های اپ در صندوق ورودی#

پس از نصب، هر اپ به‌صورت یک ابزارک در پنل جزئیات گفت‌وگوی صندوق ورودی ظاهر می‌شود. بازکردن یک گفت‌وگو کارت زنده‌ای از سرویس می‌آورد: این مشتری در Stripe کیست، سفارش‌های اخیرش در Shopify، وضعیت خبرنامه‌اش، مسئله‌های Jira پیوندخورده به رشته، یا رأی Tracio دربارهٔ بازدیدکننده. بیشتر کارت‌ها به رکورد متناظر در داشبورد خود سرویس هم لینک می‌دهند — رأی Tracio تماماً در همان پنل زندگی می‌کند.

کارت‌ها دربارهٔ نداشتن چیزی برای نمایش صادق‌اند. اگر مشتری پیدا نشود — یا گفت‌وگو هویت قابل‌استفاده‌ای نداشته باشد — کارت همین را می‌گوید و علتش را توضیح می‌دهد، به‌جای رسم یک جعبهٔ خالی. پاسخ‌ها مدت کوتاهی کش می‌شوند و برای هر اپ سهمیهٔ نرخ دارند، پس یک صندوق ورودی باز سهمیهٔ API سرویس را نمی‌سوزاند.

کارت‌ها از هویت تأییدشده پیروی می‌کنند#

Stripe، Shopify، Mailchimp و MailerLite مشتری را با نشانی ایمیل جست‌وجو می‌کنند — و فقط با نشانی‌ای که واقعاً تأییدشده است: نشانی‌ای که هویت امضاشدهٔ ویجت (تأیید هویت) آن را پوشش می‌دهد، یا نشانی From در گفت‌وگوی کانال ایمیل. نشانی‌ای که بازدیدکننده صرفاً در چت تایپ کرده اصلاً برای جست‌وجو استفاده نمی‌شود — وگرنه هر کسی می‌توانست ایمیل یک مشتری واقعی را تایپ کند و تاریخچهٔ پرداختش را ببیند. در آن حالت کارت توضیح می‌دهد که نشانی به هویت تأییدشده‌ای متکی نیست.

Jira و Tracio بر پایهٔ ایمیل کار نمی‌کنند — کارت‌های Jira به مسئله‌های پیوندخوردهٔ گفت‌وگو تعلق دارند و Tracio به بازدیدکنندهٔ ویجت — پس حتی وقتی نشانی تأییدشده‌ای وجود ندارد هم کار می‌کنند.

اگر نشانی خود گفت‌وگو چیزی پیدا نکند، Respondo نشانی شناخته‌شدهٔ دیگر مخاطب را هم امتحان می‌کند (مثلاً پس از ادغام مخاطب‌ها)، و روی کارت می‌نویسد از کدام نشانی استفاده کرده است.

هر اپ چه چیزی نشان می‌دهد#

Stripe#

پنجره‌ای فقط‌خواندنی به صورت‌حساب مشتری: نام، ایمیل، ماندهٔ حساب و شناسهٔ مشتریِ قابل‌کپی، به‌علاوهٔ اشتراک — نشان وضعیت، پلن، مبلغ ماهانه و تاریخ شروع — و پرداخت‌های اخیر با شمارهٔ فاکتور. بازپرداخت تنها عمل نوشتنیِ اختیاری است: یک مدیر باید اجازهٔ بازپرداخت از پنل گفت‌وگو را در تنظیمات اپ روشن کند (پیش‌فرض خاموش)، اپراتور باید دسترسی اجرای بازپرداخت‌ها و لغوها را داشته باشد، و هر بازپرداخت باید با تایپ‌کردن REFUND تأیید شود — Stripe نمی‌تواند بازپرداختِ فرستاده‌شده را پس بگیرد.

Shopify#

سفارش‌های اخیرِ فقط‌خواندنی — شمارهٔ سفارش، تاریخ، جمع کل، وضعیت پرداخت و تحویل — با لینک به هر سفارش و به رکورد مشتری در پیشخوان Shopify شما. با دامنهٔ فروشگاه و یک توکن Admin API از یک اپ سفارشی با اسکوپ‌های read_customers و read_orders وصل می‌شود.

Mailchimp#

مشترک همان‌طور که Mailchimp می‌بیندش: نشان وضعیت، مخاطبان، برچسب‌ها، میزان تعامل و فعالیت کمپین‌های اخیر (ارسال‌ها، بازشدن‌ها، کلیک‌ها). یک کنش در دسترس است: لغو اشتراک، برای اجابت درخواست «دیگر برایم ایمیل نفرستید» بدون ترک گفت‌وگو. از راه API برگشت‌پذیر نیست — Mailchimp فقط اجازه می‌دهد خود شخص از راه فرم ثبت‌نام دوباره مشترک شود — پس تأیید تایپی لازم دارد. توجه کنید کلیدهای API در Mailchimp اسکوپ‌بندی ندارند: کلیدی که وصل می‌کنید می‌تواند همه‌چیز حساب را بخواند و بنویسد.

MailerLite#

وضعیت اشتراک، گروه‌ها، تاریخ ثبت‌نام، میزان تعامل و فعالیت کمپین‌های اخیر. دو کنش: لغو اشتراک (برگشت‌پذیر — API در MailerLite اشتراک دوباره را پشتیبانی می‌کند) و اشتراک دوباره، برای برگرداندن کسی به فهرست به درخواست خودش.

Jira#

پیوندی دوطرفه میان گفت‌وگوها و مسئله‌های Jira Cloud. کارت مسئله‌های پیوندخورده به این گفت‌وگو را با وضعیت فعلی‌شان فهرست می‌کند و ساخت مسئله (در پروژهٔ انتخابی شما ثبت و خودکار پیوند می‌شود) و پیوند موجود / حذف پیوند را برای مسئله‌های ازپیش‌موجود پیشنهاد می‌دهد. تغییرات وضعیت در Jira از راه یک وب‌هوک برمی‌گردند: صفحهٔ تنظیمات اپ یک نشانی وب‌هوک محرمانه نشان می‌دهد که در سایت Jira خود جای‌گذاری می‌کنید، و از آن پس کارت وضعیت زندهٔ مسئله را بازتاب می‌دهد. مسئله‌ها با همان حساب Atlassian که وصل می‌کنید ساخته می‌شوند و کارت دقیقاً همان چیزی را می‌بیند که آن حساب می‌بیند.

هر کنشی که از پنل اجرا می‌شود با دسترسی‌های نقش گیت می‌خورد — استفاده از کنش‌های اپ برای لغو اشتراک، اشتراک دوباره و مسئله‌های Jira، و اجرای بازپرداخت‌ها و لغوها برای بازپرداخت‌ها. جایی که اپ کلید قابلیت در سطح فضای کاری هم دارد — امروز یعنی اجازهٔ بازپرداخت از پنل گفت‌وگو در Stripe — آن کلید تعیین می‌کند قابلیت اصلاً وجود داشته باشد یا نه، و خاموش‌کردنش جلوی همه را می‌گیرد، از جمله مالک فضای کاری.

Tracio: انسان یا بات#

Tracio به یک پرسش دربارهٔ بازدیدکنندهٔ ویجت چت پاسخ می‌دهد: این انسان است یا بات؟ نصب اپ، SDK تشخیص Tracio را داخل ویجت چت Respondo شما فعال می‌کند — گفت‌وگوهای تازهٔ ویجت خودکار رأی می‌گیرند، که به‌صورت یک چیپ روی کارت Tracio در پنل گفت‌وگو نشان داده می‌شود.

چیپمعنا
انسانبررسی سمت سرور Tracio برای این بازدیدکننده هیچ نشانهٔ باتی پیدا نکرد.
بات · 93%بات تشخیص داده شد، با درجهٔ اطمینان Tracio. کارت نشانه‌های پشت این رأی را هم فهرست می‌کند.
بررسی‌نشدهبررسی سمت سرور Tracio الان در دسترس نیست — کارت به رأی گزارش‌شده از مرورگر برمی‌گردد و همین را می‌گوید.
شناسهٔ جعلیشناسهٔ بازدیدکننده‌ای که مرورگر فرستاده برای Tracio ناشناخته است — ادعا جعلی به نظر می‌رسد.

دو کلید وصل می‌شود: یک کلید عمومی که SDK را در ویجت فعال می‌کند، و یک کلید محرمانهٔ Data API که برای بررسی سمت سرورِ رأی به کار می‌رود. بدون بررسی سمت سرور، ادعای «بات نیستم» از سوی مرورگر به‌تنهایی قابل اعتماد نیست — و وقتی ادعای مرورگر با رأی سرور نمی‌خواند، کارت هر دو را نشان می‌دهد.

Tracio فقط برای گفت‌وگوهای ویجت چت کار می‌کند. ایمیل، Telegram و کانال‌های دیگر بازدیدکننده‌ای برای بررسی ندارند، پس کارت Tracio آن‌ها توضیح می‌دهد چیزی برای بررسی نیست. نبودِ رأی به معنای ظن نیست: مسدودکننده‌های تبلیغ مدام SDK را برای انسان‌های واقعی قطع می‌کنند، و گفت‌وگوهای قدیمی‌تر که پیش از اتصال Tracio شروع شده‌اند هم رأیی ندارند.
SDK در Tracio از بازدیدکنندگان سایت شما اثرانگشت می‌گیرد. گرفتن رضایت بازدیدکننده (از راه CMP / بنر کوکی) به‌عنوان مالک سایت مسئولیت شماست.

محدودیت‌ها#

  • کارت‌های Stripe و Shopify فقط‌خواندنی هستند — تنها عمل نوشتنی در کل اپ Stripe همان بازپرداختِ اختیاری و صراحتاً فعال‌شده است.
  • اپ‌های مبتنی بر ایمیل (Stripe، Shopify، Mailchimp، MailerLite) نشانی ایمیل تأییدشده می‌خواهند. گفت‌وگوهای بازدیدکنندگان ناشناس ویجت یا کانال‌های بدون نشانی، کارت صادقِ «چیزی برای جست‌وجو نیست» می‌بینند.
  • پشتیبانی Jira فقط Jira Cloud را پوشش می‌دهد.
  • Mailchimp اشتراک دوباره ندارد: پس از لغو اشتراک، فقط خود شخص می‌تواند از راه فرم ثبت‌نام دوباره مشترک شود. اگر این جریان برایتان مهم است از اشتراک دوبارهٔ MailerLite استفاده کنید.
  • رأی Tracio فقط برای گفت‌وگوهای ویجت با SDK بارگذاری‌شده وجود دارد — هرگز برای ایمیل یا کانال‌های پیام‌رسان نه.