مدیریت فضای کاری
یکپارچهسازیها
اتصالات به دستیار فروش شما اجازه میدهند از دادههای خارج از پایگاه داده Pitchbar (نوتین، گوگل داکس) یاد بگیرد و به مشتریان بالقوه اجازه میدهد به سیستمهای موجود شما (CRMها، اسلک، وبهوکها) جریان یابند. برای مدیریت آنها، /app/integrations را باز کنید.
نوتین
یک بار از طریق OAuth اتصال برقرار کنید. Pitchbar درخواست دسترسی خواندن به فضاهای کاری که در طول فرآیند OAuth انتخاب میکنید را دارد — ما هرگز دسترسی سراسری نداریم. پس از اتصال:
- مودال افزودن منبع یک انتخابگر نوتین (صفحه یا پایگاه داده) را نمایش میدهد.
- هر صفحه انتخابشده به یک منبع نوتین تبدیل شده و از طریق
IngestNotionPageJobدریافت میشود. - همگامسازی مجدد بهصورت دستی است (به ازای هر منبع پردازش مجدد) — ما بهصورت زمانبندیشده از نوتین نظرسنجی نمیکنیم.
- توکن OAuth با استفاده از تبدیل
encryptedلاراول در حالت استراحت رمزگذاری میشود.
گوگل داکس
همان شکل نوتین. یک بار OAuth، انتخاب اسناد از یک انتخابگر درایو، دریافت از طریق IngestGoogleDocJob، همگامسازی مجدد دستی به ازای هر منبع. توکنها در حالت استراحت رمزگذاری میشوند. در هر زمان قطع اتصال کنید — قطع اتصال بلافاصله دسترسی ما را لغو کرده و از همگامسازیهای بعدی جلوگیری میکند.
اسلک
اسلک برای اعلانهای خروجی است:
- مشتریان جدید — به یک کانال قابل تنظیم ارسال میشود.
- مکالمات مسیریابیشده — زمانی که صندوق ورودی به کارشناس نیاز دارد، اعلان ارسال میکند.
- خلاصه روزانه — خلاصه اختیاری از حجم مکالمات و شکافهای جدید.
از طریق OAuth متصل شوید، کانال را انتخاب کنید و ذخیره کنید. ربات با نام یکپارچهسازی ارسال میکند، هرگز بهعنوان یک کاربر.
علامت زدن ارسال تست در زمان ذخیره، یک پیام نمونه "مشتری جدید" به کانال ارسال میکند تا بتوانید اتصال را قبل از ارسال یک بازدیدکننده واقعی تأیید کنید. payload تست از نام و ایمیل کاربر احراز هویتشده استفاده میکند (با پسوند "تست اسلک از <نام فضای کاری>") تا هشدار بهوضوح یک خودآزمایی باشد — اپراتورها با این تصور که یک مشتری واقعی وارد شده است، نگران نمیشوند.
وبهوکها (خروجی)
Pitchbar میتواند زمانی که رویدادها رخ میدهند، به نقطه پایانی شما درخواست POST ارسال کند. در /app/integrations/webhooks پیکربندی کنید. رویدادهای موجود:
| رویداد | زمان فعالسازی |
|---|---|
lead.captured | فرم جذب مشتری ویجت ارسال شد (تنها رویدادی که در حال حاضر ارائه میشود). |
سایر نامهای رویداد که ممکن است در یادداشتهای قدیمی نقشه راه ببینید (conversation.started، conversation.message، conversation.routed، lead.updated) در نقشه راه هستند اما هنوز متصل نشدهاند. رویدادهای اضافی را با گسترش SignedDispatcher اضافه کنید.
هر وبهوک دارای یک کلید مخفی امضا است. Pitchbar بدنه را با آن کلید مخفی HMAC کرده و هضم را در هدر X-Pitchbar-Signature ارسال میکند — آن را در زمان دریافت تأیید کنید. ارسالکننده جذب مشتری (app/Services/Webhooks/SignedDispatcher.php) بهطور طراحی تکتلاش است (مشتری قبلاً ذخیره شده است؛ یک تحویل وبهوک ناموفق در گزارش اجرای فرآیند خودکار ثبت میشود به جای اینکه ارسال بازدیدکننده را مسدود کند). وبهوکهای مرحلهای فرآیند خودکار (DispatchWebhookJob) تا ۳ بار از طریق مکانیزم تلاش مجدد صف لاراول تکرار میشوند.
برای شکلهای payload به وبهوکهای خروجی مراجعه کنید.
HubSpot / Salesforce / Zapier
وبهوکهای بالا راه فرار جهانی هستند — آنها با هر چیزی که میتواند درخواستهای HTTP POST را دریافت کند، کار میکنند. یکپارچهسازیهای بومی HubSpot و Salesforce در نقشه راه هستند؛ در حال حاضر، یک وبهوک را به یک قلاب گیرنده Zapier اشاره دهید و اجازه دهید Zapier به CRM شما مسیریابی کند.
قطع اتصال
هر ردیف یکپارچهسازی یک دکمه قطع اتصال دارد. ما:
- توکن OAuth خود را با ارائهدهنده بالادستی (نوتین / گوگل) لغو میکنیم.
- ردیف محلی
integration_connectionرا بهعنوان غیرفعال علامتگذاری میکنیم. - همگامسازی را متوقف میکنیم — منابع پشتیبانشده توسط یکپارچهسازی وارد حالت "یتیم" شده و از بازخوانی بازمیایستند، اما محتوای از قبل پردازششده آنها قابل استفاده باقی میماند.
اتصال مجدد، فرآیند OAuth را دوباره اجرا کرده و منابع موجود را دوباره متصل میکند. هیچ دادهای از دست نمیرود.
مجوزها
اتصال یک یکپارچهسازی نیاز به مجوز integrations.manage دارد که به مالکان و مدیران اعطا میشود. اعضا میتوانند ببینند کدام یکپارچهسازیها متصل هستند اما نمیتوانند آنها را تغییر دهند.