# Webhooks

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

Canonical: https://alef-bot.top/developers/guides/webhooks

Updated: 2026-07-11

## חוזה השליחה

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

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

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

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

## Machine-readable sources

- [OpenAPI JSON](https://alef-bot.top/api/v1/openapi.json)

- [OpenAPI YAML](https://alef-bot.top/api/v1/openapi.yaml)

- [Arazzo workflow](https://alef-bot.top/api/v1/workflows/transcribe.arazzo.yaml)