وبلاگ
اتصال ویتایگر به سیستمهای دیگر زمانی لازم میشود که داده مشتری، سفارش، پیام یا رویداد در چند ابزار پخش شده باشد. API و Webhook دو ابزار رایجاند، اما انتخاب آنها باید بر اساس جهت جریان داده و نیاز به زمان واقعی انجام شود.
API و Webhook چه تفاوتی دارند؟
| روش | منطق ساده |
|---|---|
| API | سیستم A درخواست میدهد و داده را از سیستم B میخواند یا تغییر میدهد |
| Webhook | سیستم مبدا هنگام یک رویداد، پیام را به مقصد میفرستد |
در بسیاری از پروژهها هر دو لازماند: Webhook رویداد را اعلام میکند و API برای دریافت جزئیات یا ثبت نتیجه استفاده میشود.
قبل از اتصال، مالک داده را مشخص کنید
برای هر فیلد باید بدانید Source of Truth کدام سیستم است. مثلاً وضعیت پرداخت ممکن است از فروشگاه بیاید، اما مالک پیگیری فروش در CRM باشد. اگر هر دو سیستم بتوانند آزادانه یک فیلد را تغییر دهند، Conflict و حلقه Sync ایجاد میشود.
سناریوهای رایج اتصال ویتایگر
- ووکامرس: مشتری، سفارش و وضعیت پرداخت
- فرم سایت: ساخت Lead و منبع جذب
- پیامرسان: ثبت یا ارسال ارتباط
- اتوماسیون: n8n، Make یا Zapier
- داشبورد: ارسال داده برای تحلیل
- سیستم اختصاصی: همگامسازی با API
لاگ و Retry بخشی از طراحی هستند
هیچ اتصال واقعی همیشه بدون خطا نیست. Timeout، خطای اعتبارسنجی، Token منقضی و قطعی شبکه رخ میدهد. برای رویدادهای مهم باید لاگ درخواست، پاسخ، زمان، شناسه رکورد و امکان Retry وجود داشته باشد.
امنیت اتصال
- کلید API را در کد یا فایل عمومی قرار ندهید.
- حداقل سطح دسترسی لازم را بدهید.
- HTTPS را اجباری کنید.
- Payload حساس را فقط در حد نیاز ارسال کنید.
- Webhookهای ورودی را با Secret یا امضای مناسب اعتبارسنجی کنید.
- Logها را طوری نگه دارید که اطلاعات حساس بیدلیل ذخیره نشوند.
نقش Workflow در یکپارچهسازی
Workflow میتواند تعیین کند چه زمانی یک Webhook اجرا شود. مثلاً فقط وقتی Opportunity وارد مرحله مشخص شد یا Lead از منبع خاصی آمد. این کار بهتر از ارسال همه تغییرات به سیستم بیرونی است. راهنمای Workflow را برای منطق داخلی بخوانید.
راهکار اول CRM برای Webhook
صفحه وبهوک ویتایگر اول CRM برای ارسال رویدادهای CRM به n8n، Make، Zapier و APIهای بیرونی طراحی شده است. برای فروشگاهها نیز اتصال ووکامرس به CRM نمونهای از یکپارچهسازی داده مشتری و سفارش است.
چکلیست معماری اتصال
- هدف اتصال را مشخص کنید.
- Source of Truth هر داده را تعیین کنید.
- جهت Sync و Trigger را بنویسید.
- شناسه یکتا و جلوگیری از Duplicate را طراحی کنید.
- Timeout و Retry را مشخص کنید.
- لاگ و هشدار خطا بسازید.
- روی داده آزمایشی تست کنید.
جمعبندی
یکپارچهسازی خوب یعنی داده کمتر اما درستتر، مسیر خطای قابل مشاهده و مسئولیت روشن. اگر ابزارهای فعلی شما پراکندهاند، نقشه اتصال CRM و کانالها را بررسی کنید.
نمونه معماری فروشگاه ووکامرسی
در یک فروشگاه، WooCommerce میتواند Source of Truth سفارش و پرداخت باشد و Vtiger Source of Truth پیگیری فروش. هنگام سفارش جدید، اطلاعات ضروری به CRM میرود؛ اگر وضعیت پرداخت تغییر کند، رویداد به CRM ارسال میشود؛ اما یادداشت فروشنده یا مرحله Opportunity نباید از ووکامرس بازنویسی شود. همین مرزبندی از Conflict جلوگیری میکند.
شناسه یکتا و Duplicate
قبل از Sync مشخص کنید مشتری با چه کلیدی Match میشود: ایمیل، موبایل، Customer ID یا ترکیبی از آنها. هیچ گزینهای همیشه کامل نیست. شمارهها باید Normalize شوند و تغییر ایمیل نباید مشتری جدید بسازد. برای Order هم شناسه خارجی را نگه دارید تا Retry باعث ساخت رکورد دوم نشود.
Idempotency و Retry
اگر Webhook دو بار ارسال شد، سیستم مقصد باید بتواند تشخیص دهد رویداد قبلاً پردازش شده است. این اصل Idempotency برای سفارش، پرداخت و پیام اهمیت دارد. Retry باید با فاصله و تعداد محدود انجام شود و خطای دائمی وارد صف بررسی انسانی شود.
مانیتورینگ اتصال
- تعداد رویداد موفق و ناموفق
- آخرین زمان Sync
- خطاهای احراز هویت
- رکوردهای Duplicate
- Latency غیرعادی
- Payloadهای ردشده به دلیل Validation
نسخه API و تغییرات
وابستگی به Endpoint یا ساختار قدیمی بدون Versioning ریسک دارد. مستندات اتصال باید URL، روش احراز هویت، فیلدها، Mapping و رفتار خطا را ثبت کند. قبل از ارتقای CRM یا سیستم مقصد، Contract اتصال را روی محیط تست بررسی کنید.
سؤالات متداول
برای هر اتصال Webhook بهتر است یا API؟
خیر. اگر رویداد باید فوراً اعلام شود Webhook مناسب است؛ اگر سیستم مقصد باید داده را در زمان دلخواه بخواند API مناسبتر است. بسیاری از معماریها هر دو را ترکیب میکنند.
آیا همه فیلدهای CRM را باید Sync کنیم؟
خیر. فقط دادهای را منتقل کنید که برای فرایند مقصد لازم است؛ Sync بیش از حد پیچیدگی و ریسک را بالا میبرد.
مطالعههای مرتبط
برای دیدن تصویر کاملتر موضوع، راهنمای جامع ویتایگر فارسی را نیز مطالعه کنید.
میخواهید مسیر CRM و فروش فعلی شما بررسی شود؟ درخواست بررسی وضعیت فعلی و فرصتهای بهبود.
