Webhooks

קאנטע אונטערשריפט סוד

שאפט דעם אונטערשריפט סוד אין דעשבארד איידער צולייגן א webhook. עס ווערט געוויזן איינמאל און געהאלטן פארשלאסלט ביי אלף בוט

שיקונג קאנטראקט

גיט א פובליקן HTTPS endpoint ביים שאפן טראנסקריפציע. דער געשעעניש גוף און כותרות זענען דאקומענטירט ווי א callback אין API רעפערענץ

{
  "event": "transcription.completed",
  "event_id": "evt_...",
  "job_id": "job_...",
  "status": "completed",
  "created_at": "2026-08-14T12:00:00Z",
  "links": {
    "self": "https://alef-bot.top/api/v1/transcriptions/job_...",
    "artifact": "https://alef-bot.top/api/v1/transcriptions/job_.../artifact"
  }
}

• יעדער פארלאנג אנטהאלט X-AlefBot-Event, X-AlefBot-Event-ID, X-AlefBot-Timestamp און X-AlefBot-Signature
• Webhook בדיקות שיקן X-AlefBot-Event: webhook.test און א גוף מיט test_mode: true; דער גענויער schema שטייט ווי callback פון דער בדיקה אפעראציע אין API רעפערענץ
• באשטעטיקט די אונטערשריפט קעגן דעם רויען פארלאנג גוף איידער לייענען JSON
• זאגט אפ אלטע צייטשטעמפלען און פארגלייכט אונטערשריפטן אין קאנסטאנטער צייט
• גיט שנעל א 2xx ענטפער און פראצעסירט די געשעעניש אסינכראן
• שיקונג קומט כאטש איינמאל; פארמיידט דאפלט באהאנדלונג לויט event_id ווייל שיקונג קען זיך איבערחזרן
• דער סדר פון געשעענישן איז נישט גאראנטירט
• אלף בוט פרוווט ביז 5 מאל איבער בערך דריי שעה ביי נעץ דורכפאלן, 408, 425, 429 און 5xx
• דער ציל מוז זיין פובליק HTTPS אויפן פארט 443 אן redirects

פרוווט איידער אקטיווירן

נוצט POST /webhooks/test צו באשטעטיקן DNS, TLS, נעץ פאליסי, אונטערשריפטן און ענטפער צייט אן שאפן טראנסקריפציע