درخواست‌های وب و وب‌هوک‌ها

GetMyBot از طریق HTTP در هر دو جهت با سیستم‌های خارجی یکپارچه می‌شود: درخواست‌های ورودی واکنش‌ها را راه‌اندازی می‌کنند، و اقدامات خروجی API دیگران را فراخوانی می‌کنند. این بات را به CRM، درگاه پرداخت، فرم‌های وب‌سایت و هر سرویسی متصل می‌کند.

وب‌هوک ورودی (ماشه)

ماشه «درخواست وب ورودی (webhook)» واکنش را با یک درخواست HTTP خارجی راه‌اندازی می‌کند:

  • مسیر — آدرس گیرنده (URL کامل از آدرس بات و مسیر شکل می‌گیرد).
  • توکن مخفی — اندپوینت را از دسترسی غیرمجاز محافظت می‌کند.
  • متد — POST / GET / PUT / ANY.

داده‌های درخواست (فیلدهای فرم یا بدنه) وارد زمینه اجرا می‌شوند و در اقدامات از طریق {{ctx.field}} در دسترس هستند. این‌گونه وب‌سایت یا سرویس می‌تواند یک رویداد به بات «فشار» دهد — مثلاً پرداخت انجام شد → دسترسی برای کاربر ارسال شود.

درخواست وب خروجی (اقدام)

اقدام «درخواست وب» یک درخواست HTTP از واکنش ارسال می‌کند:

  • متد (GET/POST/PUT/DELETE)، هدرها، بدنه (JSON یا فرم);
  • کدهای موفقیت، تایم‌اوت و تعداد تکرار در صورت خطا;
  • ذخیره پاسخ در پارامتر یا ctx از طریق JSONPath;
  • حالت ناهمزمان (بلاک نکردن واکنش) و راه‌اندازی واکنش‌ها در صورت موفقیت/خطا.

اقدامات مرتبط: «بارگذاری URL» (دانلود متن صفحه در ctx) و «درخواست به منبع» / «نوشتن در منبع» برای کانکتورهای ذخیره‌شده — ببینید منابع و کلیدها.

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

برای ارسال منظم داده به یک سرویس، راحت‌تر است یکپارچه‌سازی «Webhook» (URL + امضای HMAC) تنظیم کنید — ببینید یکپارچه‌سازی‌ها.

امنیت

اندپوینت‌های ورودی با توکن مخفی محافظت می‌شوند؛ درخواست‌های خروجی از محافظت SSRF عبور می‌کنند (دسترسی به شبکه داخلی ممکن نیست) و اندازه پاسخ محدود است.

بیشتر بخوانید