בכתבה זו
איפה: הגדרות ← מתקדם ← חיבור אפליקציות נוספות
פתיחת הדף: admin.<your-site>/settings/integrations/webhooks (החליפו את <your-site> בכתובת האתר שלכם). אם הדף לא מופיע בתפריט, הפעילו את הצגת כל ההגדרות בדף ההגדרות.
לפני שמתחילים
- רק בעל האתר יכול להוסיף webhooks.
- כתובת היעד חייבת להתחיל ב-https:// ולהיות נגישה באינטרנט הציבורי.
שלבי ביצוע
- פתחו את הגדרות → מתקדם → חיבור לאפליקציות נוספות → Webhooks.
- לחצו על הוספת webhook.
- הזינו שם, למשל Zapier, ואת ה-הכתובת שמקבלת את ההודעות.
- תחת שליחת הודעה כאשר, סמנו אירועים: כתבה עולה לאתר, שינוי בכתבה שפורסמה, כתבה מוסרת מהאתר, הוספת תיקון, ביטול והסרת כתבה, תגובה חדשה, שינוי במנוי.
- לחצו על הוספת webhook.
- העתיקו את מפתח החתימה הסודי (signing secret). הוא מוצג פעם אחת בלבד. לחצו על שמרתי.
- נסו את שליחת אירוע בדיקה.
טוב לדעת
- כל הודעה נחתמת דיגיטלית. בדקו את הכותרת "Keynate-Signature" כדי לוודא שהיא אכן נשלחה מהאתר שלכם.
- המערכת שלכם צריכה להחזיר קוד סטטוס 2xx כדי לאשר שההודעה התקבלה בהצלחה.
- הודעות שנכשלו נשלחות שוב בניסיונות חוזרים למשך עד 24 שעות. webhook שנכשל במשך 3 ימים מושבת אוטומטית. תקנו את הבעיה בצד המקבל, ואז לחצו על המשך.
- באפשרותכם לבצע השהיה, המשך, או סוד חדש. המפתח הישן ימשיך לחתום על הודעות למשך פרק זמן שתגדירו.
- הרשימה מציגה את הסטטוס של כל webhook: פעיל, עדיין לא בשימוש, לא עובד, מושהה, כבוי.
- פתחו הודעה שנשלחה כדי לראות את ניסיונות השליחה ולחצו על שליחה שוב.
בעיות נפוצות
- "הכתובת חייבת להתחיל ב-https://."
- "יש לתת שם ל-webhook."
- "יש לבחור לפחות אירוע אחד."
- "הגעתם למספר ה-webhooks המרבי המותר. מחקו תחילה webhook שאינו בשימוש."
שאלות נפוצות
שאלות נפוצות
איך נראית הודעה כזו?
טקסט קצר במבנה JSON המכיל את סוג האירוע ואת פרטי הכתבה הרלוונטית.
מה קורה אם השרת המקבל שלי לא זמין?
המערכת תנסה לשלוח שוב הודעות שנכשלו במשך עד 24 שעות.