وب‌هوک‌ها
INTEGRATIONS · EXPERTINI ATS

وب‌هوک‌ها

رویدادهای استخدام بلادرنگ را به هر URLـی POST کنید — ماده خام Zapier، n8n و Make روی آن ساخته شده‌اند.

2 دقیقه مطالعه · به‌روزرسانی شده در ژوئیه ۲۰۲۶ · تحریریه Expertini

هر تیم استخدامی سیستمی دارد که سیستم ATS نمی‌تواند آن را ببیند: یک انبار داده، یک داشبورد داخلی، یک ابزار دست‌ساز که باید بداند چه زمانی اتفاقی افتاده است. وب‌هوک‌ها پاسخ جهانی هستند. هنگامی که یک شغل منتشر می‌شود، یک درخواست می‌رسد، یا یک کاندیدا مرحله خود را تغییر می‌دهد، Expertini ATS یک رویداد JSON ساختاریافته را به هر URL که پیکربندی می‌کنید ارسال (POST) می‌کند — به صورت بلادرنگ، در همان لحظه وقوع رویداد.

خلائی که این ویژگی پر می‌کند، مسئله نظرسنجی دوره‌ای است: بدون رویدادها، سیستم‌های خارجی یا مکرراً تغییرات را بررسی می‌کنند یا اطلاعات آن‌ها قدیمی می‌شود. وب‌هوک‌ها این روند را معکوس می‌کنند؛ به سیستم‌های شما بلافاصله و تنها زمانی اطلاع داده می‌شود که چیزی برای دانستن وجود داشته باشد. این همان پایه و اساسی است که پلتفرم‌های اتوماسیون مانند Zapier، n8n و Make بر روی آن ساخته شده‌اند، به این معنی که یک نقطه پایانی وب‌هوک می‌تواند رویدادهای استخدام شما را تقریباً به هر ابزاری که آن پلتفرم‌ها پشتیبانی می‌کنند، ارسال کند. این قابلیت به‌طور پیش‌فرض در اشتراک شما گنجانده شده است: بدون سطح افزودنی اتوماسیون، بدون قیمت‌گذاری به ازای هر رویداد، و بدون محصول یکپارچه‌سازی جداگانه. تحویل‌ها به‌صورت ناهمگام انجام می‌شوند، بنابراین سیستم‌های پایین‌دستی سنگین هرگز سرعت استخدام‌کنندگان یا خط لوله استخدام شما را کاهش نمی‌دهند.

01رویدادهایی که با لحظات واقعی استخدام نگاشت می‌شوند

رویدادها لحظاتی را پوشش می‌دهند که تیم‌ها واقعاً پیرامون آن‌ها اتوماسیون انجام می‌دهند: زنده شدن یک شغل، فرود آمدن یک درخواست جدید، جابجایی یک نامزد بین مراحل. هر تحویل یک محتوای JSON با رکوردهای مربوطه است که در لحظه‌ی وقوع رویداد به URL شما ارسال می‌شود.

تیم‌ها از این سه عنصر پایه، کاربردهای زیادی می‌سازند: اعلان‌های آنی به کانال‌های داخلی، جایگزینی برای گزارش‌های شبانه، تایمرهای SLA برای تغییر مراحل، و فیدهای انبار داده که داشبوردهای هوش تجاری (BI) را بدون نیاز به خروجی‌گرفتن، به‌روز نگه می‌دارند.

02پلتفرم اتوماسیون خود را بیاورید — یا هیچ‌کدام

وب‌هوک را به سمت یک آدرس محرک (Trigger URL) در Zapier، n8n یا Make هدایت کنید و رویدادهای استخدام شما بدون نیاز به هیچ کدی وارد اکوسیستم‌های هزاران برنامه می‌شوند. یا واسطه را حذف کنید: هر پایانه (Endpoint) HTTPS که اجرا می‌کنید — یک تابع بدون سرور (Serverless)، یک سرویس داخلی — همان بارگذاری‌ها (Payloads) را دریافت می‌کند. سیستم ATS اهمیتی نمی‌دهد چه کسی گوش می‌دهد؛ آن را به طور قابل اعتمادی تحویل می‌دهد.

03طراحی‌شده برای ارسال و فراموشی

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

یادداشت‌های مهندسی

معماری پلتفرم و عملیات

A1Connection architecture

این اپلیکیشن مبتنی بر تنظیمات (Configuration-based) است: آنچه ذخیره می‌کنید مستقیماً توسط پلتفرم اجرا می‌شود — هیچ اتصال حساب شخص ثالثی در کار نیست. تنظیمات هنگام ذخیره اعتبارسنجی می‌شوند، به ازای هر سازمان ذخیره می‌شوند و در درخواست بعدی اعمال خواهند گردید.

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

A2نوشتن معناشناسی و جریان داده‌ها

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

هر اقدام یک سطر در ژورنال فعالیت برنامه (ats_app_activity) می‌نویسد: چه چیزی اجرا شد، چه زمانی، برای کدام رکورد، و نتیجه — از جمله متن خطای خود فروشنده به طور دقیق زمانی که چیزی با شکست مواجه می‌شود. گزارش استفاده در داخل ATS همان ژورنال را تجمیع می‌کند، بنابراین گزارش‌دهی یکپارچه‌سازی و واقعیت یکپارچه‌سازی نمی‌توانند واگرا شوند.

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

A3ملاحظات عملیاتی

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

افراد وارد شده با پیش‌فرض‌های حریم خصوصی محافظه‌کارانه به عنوان وارد شده علامت‌گذاری می‌شوند — هیچ رضایتی برای کسی که هرگز فرم درخواست شما را پر نکرده است فرض نمی‌شود، و پیش‌فرض‌های نگهداری اعمال می‌شوند.هرآنچه نوشته شده مال شماست که ببرید: خروجی‌های CSV و اپلیکیشن صادرات داده همان فروشگاه‌هایی را پوشش می‌دهند که خود محصول می‌خواند. خروج به اندازه ورود باز است — طبق طراحی، نه امتیاز ویژه.

A4موقعیت در توپولوژی ادغام

این یکپارچه‌سازی امروز در رجیستری فعال است. One connection per provider unlocks every feature it powers, and the topology grid below shows the neighbouring connectors in the same capability area — statuses come from the same registry that drives the in-app hub, so this page can never claim more than the product does. For anything the catalogue does not cover, Webhooks and Zapier are the generic, documented escape hatch.

نقشه وابستگی

Connection typeمبتنی بر پیکربندی (بدون حساب شخص ثالث)
Secrets at restرمزگذاری‌شده؛ رابط کاربری پرچم‌های حضور را نشان می‌دهد، هرگز مقادیر را نشان نمی‌دهد
Action journalats_app_activity — یک ردیف به ازای هر اقدام، خطاهای فروشنده کلمه به کلمه
Auto-push rulesغیرفعال به طور پیش‌فرض، به ازای هر ارائه‌دهنده، هر اجرا ثبت می‌شود
Registry statuslive

طرح‌واره رابط

شماتیک ساختاری سطح — پنل‌ها، سلسله‌مراتب و قابلیت‌های تعامل. یک قرارداد، نه یک تصویر صفحه.
کارت اتصال
● متصل — نشانگر حضور
دسترسی‌ها: حداقل مورد نیاز قطع اتصال
اقدامات
ارسال — کلیک صریحوارد کردن — حذف موارد تکراری
سیاهه فعالیت‌ها
شکل ۱ — وب‌هوک‌ها: شماتیک ساختاری رابط. پنل‌ها و وضعیت‌ها قرارداد هستند؛ داده‌های نشان‌داده‌شده جایگزین هستند.

جریان تعامل — حالت‌ها، اعتبار سنجی‌ها، بازخورد

هر وضعیتی در زیر در سمت سرور اجرا می‌شود؛ رابط کاربری آن را گزارش می‌کند، نه اینکه درباره‌اش تصمیم بگیرد.
Open app pageفقط مالک/مدیر برای تغییرات
Save settingsاعتبارسنجی‌شده در هنگام ذخیره (فرمت، بررسی‌های زنده در صورت امکان)
In effectدرخواست بعدی از پیکربندی جدید استفاده می‌کند
Journalاقدامات ثبت شده در فعالیت برنامه
مقدار نامعتبر ← خطای اعتبارسنجی نام‌برده؛ هیچ چیز جزئی ذخیره نمی‌شودپیکربندی حذف‌شده ← رفتار به طور مشهودی متوقف می‌شودرازها ← فقط پرچم‌های حضور، هرگز دوباره نمایش داده نمی‌شوند
تصویر ۲ — جریان تعامل: سرمه‌ای = وضعیت‌ها، طلایی = دروازه‌های اجباری سرور، سبز = نتایج تأییدشده؛ برچسب‌ها موارد خاص و بازخورد آن‌ها را فهرست می‌کنند.

کاتالوگ رویداد (از رجیستری زنده)

Configured per organisation on the in-app Webhooks page — up to 10 endpoints
EVENT job.publishedA job goes live
EVENT application.receivedA new application arrives
EVENT application.stage_changedA candidate moves pipeline stage
EVENT assessment.submittedA candidate submits an assessment
EVENT video_interview.submittedA candidate finishes a video interview
EVENT video_interview.reviewedA video interview is scored by your team
EVENT placement.confirmedAn offer is accepted — hire confirmed
POST https://your-endpoint.example/hook
Content-Type: application/json

{"event": "application.received",
 "org": "acme-recruiting",
 "data": {"job_title": "Senior Backend Engineer", ...}}
تحویل اطلاعات از طریق رشته‌های پس‌زمینه به صورت آتش و فراموش است — تاخیر پایگاه داده شما هرگز ATS را مسدود نمی‌کند. محتوا برای مصورسازی خلاصه شده است.

Neighbouring connectors — Automation & Webhooks

وب‌هوک‌هاthis page Zapierlive
وضعیت‌ها از ثبت‌نام زنده می‌آیند — فهرست کامل را مرور کنید ←

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

کدام رویدادها می‌توانند یک وب‌هوک را فعال کنند؟
رویدادهای کلیدی استخدام — شغل منتشر شده، درخواست دریافت شده، و مرحله کاندیدا تغییر کرد — هر کدام به عنوان یک JSON POST ساختاریافته به URL پیکربندی‌شده شما در لحظه وقوع تحویل داده می‌شوند.
آیا وب‌هوک‌ها با Zapier، n8n و Make کار می‌کنند؟
بله. این پلتفرم‌ها پیرامون دریافت وب‌هوک ساخته شده‌اند — URL راه‌انداز آن‌ها را در تنظیمات وب‌هوک ATS خود قرار دهید و رویدادهای استخدام شما به راه‌اندازهایی برای هزاران برنامه‌ی پایین‌دستی تبدیل می‌شوند.
آیا یک اندپوینت کند، ATS من را کند خواهد کرد؟
خیر. تحویل‌ها به‌صورت ناهمزمان در پس‌زمینه انجام می‌شوند، بنابراین استخدام‌کنندگان و نامزدها هرگز منتظر سیستم دریافت‌کننده شما نمی‌مانند، هرچقدر هم که کند باشد.
آیا هزینه ای به ازای هر رویداد یا سطح اتوماسیون وجود دارد؟
خیر. وب‌هوک‌ها بدون اندازه‌گیری رویداد در اشتراک گنجانده شده‌اند — تضادی عمدی با ابزارهایی که اتوماسیون را به عنوان یک افزونه به شما می‌فروشند.

در یک نگاه

  • ارسال فوری POST به فرمت JSON در رویدادهای کلیدی استخدام
  • شغل منتشر شد، درخواست دریافت شد، مرحله تغییر کرد
  • با Zapier، n8n، Make، یا هر نقطه پایانی HTTPS کار می‌کند
  • تحویل ناهمگام هرگز کاربران را مسدود نمی‌کند
  • بدون هزینه به ازای هر رویداد یا سطوح اتوماسیون
  • در چند دقیقه برای هر سازمان پیکربندی می‌شود

مشاهده وب‌هوک‌ها در استخدام خودتان.

یک شرح شغل واقعی را به یک نسخه نمایشی ۳۰ دقیقه‌ای بیاورید — آزمایش رایگان شامل می‌شود.

رزرو نسخه نمایشی
Expertini هوشمند
اکنون آنلاین است
سلام! من متخصص محصول هوشمند Expertini هستم. درباره راه‌حل‌های ما هر سؤالی دارید بپرسید، در مورد هر یک از ابزارهای استخدام راهنمایی بخواهید یا فقط بگویید چه کاری می‌خواهید انجام دهید — من شما را به سمت درست هدایت می‌کنم. برای مسائل مربوط به حساب کاربری، به support@expertini.com ایمیل بزنید.