# Webhooks

באקומט פארענדיקונג געשעענישן זיכער און פרוווט די שיקונג איידער פראדוקציע

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

Updated: 2026-08-14

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

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

> **פארבייט דעם סוד.** פארבייטן טוישט דעם סוד תיכף. דערהיינטיקט דעם מקבל איידער ווייטער שיקן Webhooks

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

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

### JSON

```json
{
  "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, נעץ פאליסי, אונטערשריפטן און ענטפער צייט אן שאפן טראנסקריפציע

## 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)