דילוג לתיעוד
עיון בתיעוד
מדריך

Webhooks

קבלו אירועי השלמה בצורה בטוחה ובדקו את השליחה לפני מעבר לייצור

עודכן 11.07.2026צפייה כ־Markdown

חוזה השליחה

בעת יצירת התמלול, ספקו endpoint ציבורי ב־HTTPS. אלף בוט חותם על הבקשות באמצעות X-AlefBot-Timestamp ו־X-AlefBot-Signature.

  • אמתו את החתימה מול גוף הבקשה הגולמי לפני פענוח ה־JSON.
  • דחו חותמות זמן ישנות והשוו חתימות בזמן קבוע.
  • החזירו תשובת 2xx במהירות ועבדו את האירוע באופן א־סינכרוני.
  • מנעו טיפול כפול לפי event_id, מפני שהשליחה עשויה להתבצע שוב.

בדיקה לפני הפעלה

השתמשו ב־POST /webhooks/test כדי לבדוק DNS, ‏TLS, מדיניות רשת, אימות חתימות וזמן תגובה בלי ליצור תמלול.

Webhooks | API | אלף בוט