چگونه رویدادها را به سامانه‌ای دیگر بفرستیم؟

مکان: تنظیمات ← پیشرفته ← اتصال سایر برنامه‌ها

باز کردن این صفحه: admin.<your-site>/settings/integrations/webhooks (به‌جای <your-site> نشانی سایت خود را بگذارید). اگر آن را در منو نمی‌بینید، در صفحه تنظیمات گزینه نمایش همه تنظیمات را روشن کنید.

پیش‌نیازها

• فقط مدیر اصلی سایت می‌تواند وب‌هوک اضافه کند.
• نشانی گیرنده باید با https:// شروع شود و روی اینترنت عمومی دردسترس باشد.

مراحل انجام کار

1. بخش تنظیمات → پیشرفته → اتصال به برنامه‌های دیگر → وبهوک‌ها را باز کنید.
2. دکمه افزودن وبهوک را بزنید.
3. یک نام، مثلاً Zapier، و نشانی نشانی دریافت‌کننده پیام‌ها را وارد کنید.
4. زیر بخش پیام فرستاده شود وقتی، رویدادها را تیک بزنید: یک خبر منتشر می‌شود، یک خبر منتشرشده تغییر می‌کند، یک خبر از حالت انتشار خارج می‌شود، یک اصلاحیه اضافه می‌شود، یک خبر پس گرفته می‌شود، یک نظر جدید، یک اشتراک تغییر می‌کند.
5. دکمه افزودن وبهوک را بزنید.
6. کلید امنیتی امضا را کپی کنید؛ این کلید فقط یک‌بار نشان داده می‌شود. دکمه ذخیره کردم را بزنید.
7. گزینه ارسال رویداد آزمایشی را امتحان کنید.

نکات مهم

• تمام پیام‌ها امضا دارند. هدر «Keynate-Signature» را بررسی کنید تا مطمئن شوید پیام واقعاً از سایت شما ارسال شده است.
• سامانه مقصد باید با یکی از کدهای وضعیت 2xx پاسخ دهد تا دریافت پیام تأیید شود.
• پیام‌های ناموفق تا ۲۴ ساعت دوباره امتحان می‌شوند. اگر وب‌هوکی تا ۳ روز پیاپی خطا دهد، غیرفعال خواهد شد. مشکل گیرنده را حل کنید و سپس ادامه را بزنید.
• شما می‌توانید وب‌هوک را توقف موقت، ادامه یا کلید امنیتی جدید کنید. کلید قبلی تا مدتی که خودتان تعیین می‌کنید به امضای پیام‌ها ادامه می‌دهد.
• در این فهرست، وضعیت هر وب‌هوک نمایش داده می‌شود: فعال، هنوز استفاده‌نشده، غیرفعال، متوقف‌شده، خاموش.
• با باز کردن هر پیام ارسالی می‌توانید تلاش‌های مجدد را ببینید و دکمه ارسال دوباره را بزنید.

مشکلات رایج

• «نشانی باید با https://." شروع شود»
• «برای وب‌هوک یک نام تعیین کنید.»
• «حداقل یک رویداد را انتخاب کنید.»
• «به سقف مجاز تعداد وب‌هوک‌ها رسیده‌اید. ابتدا وب‌هوکی که دیگر استفاده نمی‌کنید را حذف کنید.»

پرسش‌ها

مطالب مرتبط

• اتصال به برنامه‌های دیگر
• کلیدهای API