RTC-Webhooks
RTC sendet Ereignisse zu Ihren Räumen, Teilnehmern, Aufzeichnungen und Ihrem Konto an den Webhook Endpunkte , das Sie registrieren. Jeder Endpunkt verfügt über eine eigene URL, Ereignisfilter, Signaturschlüssel und ein Zustellungsprotokoll. Die Zustellung erfolgt mindestens einmal: Deduplizierung des Ereignisses id , bevor er weiterhandelt.
Endpunkte
Abschnitt betitelt „Endpunkte“Verwalten Sie Endpunkte in der RTC-Konsole unter Webhooks, über die API mit Ihrer Konsolensitzung oder mit einem Projekt-SchlüsselAPI, der die webhooks:read
oder webhooks:write Gültigkeitsbereich. Ein Projektschlüssel sieht und verwaltet nur die Endpunkte des eigenen Projekts.
| Einstellung | Bedeutung |
|---|---|
| URL | Eine öffentliche HTTPS-URL auf Port 443. Weiterleitungen werden nicht verfolgt und private oder reservierte Adressen werden abgelehnt, sowohl beim Speichern als auch bei jedem Versuch. |
| Projekt | Ein Projekt oder alle Projekte der Organisation (projectId: null). |
| Ereignisse | Filter: * für jedes Ereignis, eine Familie wie beispielsweise recording.*oder einen Typ wie beispielsweise room.ended. Ein Filter, der keinem bekannten Typ entspricht, wird abgelehnt. |
| Aktiviert | Deaktivierte Endpunkte erhalten nichts. RTC deaktiviert einen Endpunkt selbst, wenn dieser wiederholt ausfällt (siehe Wiederholungsversuche und automatische Deaktivierung). |
| Beschreibung | Ihre eigene Bezeichnung, bis zu 500 Zeichen. |
Die Anzahl der Endpunkte hängt von Ihrem Tarif ab. Wenn Sie einen mehr als im Tarif vorgesehen erstellen, sind Antworten möglich 409 mit dem Code
WEBHOOK_ENDPOINT_LIMIT.
curl --fail-with-body https://api.rtc.champrep.com/v1/webhooks/endpoints \ --header "Authorization: Bearer $RTC_API_KEY" \ --header "Content-Type: application/json" \ --data '{ "url": "https://hooks.example.com/rtc", "description": "Production receiver", "events": ["room.*", "recording.ready"] }'| Methode und Pfad | Gültigkeitsbereich | Ergebnis |
|---|---|---|
GET /v1/webhooks/endpoints | webhooks:read | Endpunkte, neueste zuerst (?projectId, ?limit, ?cursor) |
POST /v1/webhooks/endpoints | webhooks:write | 201, der Endpunkt und sein Signaturschlüssel, einmalig angezeigt |
GET /v1/webhooks/endpoints/{endpointId} | webhooks:read | Ein Endpunkt, mit limit: { used, limit } |
PATCH /v1/webhooks/endpoints/{endpointId} | webhooks:write | Ändern url, description, events oder enabled |
DELETE /v1/webhooks/endpoints/{endpointId} | webhooks:write | { "deleted": true } |
POST /v1/webhooks/endpoints/{endpointId}/rotate-secret | webhooks:write | Ein neuer Schlüssel, einmalig angezeigt (Rotation) |
POST /v1/webhooks/endpoints/{endpointId}/test | webhooks:write | Sendet webhook.test sofort und meldet das Ergebnis |
POST /v1/webhooks/endpoints/{endpointId}/replay | webhooks:write | 202, Massenwiedergabe nach Zeitbereich |
GET /v1/webhooks/deliveries | webhooks:read | Das Zustellungsprotokoll |
GET /v1/webhooks/deliveries/{deliveryId} | webhooks:read | Eine Zustellung, bei jedem Versuch |
POST /v1/webhooks/deliveries/{deliveryId}/replay | webhooks:write | 202, sendet diese Zustellung erneut |
GET /v1/webhooks/event-types | webhooks:read | Der Ereigniskatalog |
Ein Endpunkt-Objekt enthält niemals einen geheimen Wert. Es listet die
id, kurz gesagt prefix (zum Beispiel whsec_Ab12), createdAt und während einer Rotation, expiresAt. Außerdem werden status (active oder disabled),
disabledReason (manual, failing, gone oder admin) und health
(consecutiveFailures, lastSuccessAt, lastFailureAt, failingSince).
Ein Endpunkt, bei dem die UnterstützungCHAMPREP deaktiviert ist (disabledReason: "admin") kann nicht aktiviert oder ein Testereignis gesendet werden (WEBHOOK_ENDPOINT_ADMIN_DISABLED), und dessen URL kann nicht erneut als neuer Endpunkt hinzugefügt werden (WEBHOOK_URL_ADMIN_DISABLED). Wenden Sie sich an den Support.
Abfragen geben ein JSON-Array zurück. Wenn weitere Einträge vorhanden sind, wird die X-Next-Cursor Der Response-Header enthält den Cursor für die nächste Seite; geben Sie diesen zurück als ?cursor.
?limit akzeptiert Werte von 1 bis 200.
Arbeitsbereiche, in denen der frühere einzelne Webhook konfiguriert wurde (PUT /v1/webhook) Behalten Sie es bei: Es erscheint nun als Endpunkt für alle Projekte und alle Ereignisse, gekennzeichnet
legacy: true, und das /v1/webhook Die Routen funktionieren weiterhin.
Signatur-Geheimnisse
Abschnitt betitelt „Signatur-Geheimnisse“Das Geheimnis eines neuen Endpunkts hat die Form whsec_ gefolgt von Base64. Es wird angezeigt
einmal, in der Antwort auf die Anforderung zum Erstellen oder Rotieren, und RTC speichert es verschlüsselt. Speichern Sie es im Geheimnismanager Ihres Empfängers; niemand kann es Ihnen erneut anzeigen, auch der SupportCHAMPREP nicht. Sollten Sie es verlieren, rotieren Sie das Geheimnis.
Fügen Sie niemals ein Signaturgeheimnis in einen Chat, ein Ticket oder ein Protokoll ein. Der CHAMPREP AI Assistent kann Endpunkte für Sie auflisten, erstellen, testen und wiedergeben, sieht jedoch niemals ein Geheimnis und zeigt es auch nicht an: Rufen Sie eines in der Konsole ab (Webhooks, dann Geheimnis rotieren).
Rotieren Sie ein Geheimnis ohne Ausfallzeiten
Abschnitt betitelt „Rotieren Sie ein Geheimnis ohne Ausfallzeiten“POST /v1/webhooks/endpoints/{endpointId}/rotate-secret mit
{ "overlapHours": 24 } Es wird ein neuer Geheimschlüssel erstellt, und die bisherigen bleiben während der Überlappungszeit (0 bis 72 Stunden, standardmäßig 24 Stunden) gültig. Während der Überlappungszeit Jede Übermittlung wird mit jedem aktiven Geheimnis signiert, sodass die Empfänger in ihrem eigenen Tempo umstellen können:
- Rotieren Sie das Geheimnis und speichern Sie das neue neben dem alten in Ihrem Empfänger.
- Stellen Sie einen Empfänger bereit, der beide Geheimnisse akzeptiert.
- Sobald jede Instanz das neue Geheimnis verwendet, entfernen Sie das alte. Die Signierung wird beendet, sobald die Überlappungsphase endet (
previousSecretsExpireAt).
Verwendung overlapHours: 0 wenn noch kein Empfänger den Endpunkt nutzt, beispielsweise um ein Geheimnis für einen vom KI-Assistenten erstellten Endpunkt zu erhalten.
Ereignis-Envelope
Abschnitt betitelt „Ereignis-Envelope“Neue Endpunkte verwenden die VersionAPI 2026-11-01:
{ "id": "0b7c1a52-3d4e-4f5a-9b8c-7d6e5f4a3b2c", "type": "room.ended", "apiVersion": "2026-11-01", "createdAt": "2026-11-08T12:00:00.000Z", "tenantId": "00000000-0000-4000-8000-000000000009", "projectId": "00000000-0000-4000-8000-000000000001", "roomId": "00000000-0000-4000-8000-000000000003", "data": { "roomId": "00000000-0000-4000-8000-000000000003", "endedAt": "2026-11-08T12:00:00.000Z" }}Der Legacy-Endpunkt behält den früheren Envelope bei,
{ id, type, createdAt, projectId, data }. Ein Endpunkt apiVersion heftet die empfangene Payload-Form an; siehe Versionierung.
Die oben genannten IDs dienen nur zur Veranschaulichung. Behandeln Sie id als undurchsichtige Zeichenfolge: Einige sind UUIDs, andere sind abgeleitet, wie beispielsweise recording-ready:<uuid>. projectId kann fehlen bei einer Veranstaltung auf Organisationsebene, und roomId ist für Raumereignisse vorhanden.
Ereigniskatalog
Abschnitt betitelt „Ereigniskatalog“GET /v1/webhooks/event-types gibt die verbindliche Liste zurück, wobei jeder Typ mit einer Beschreibung und status: live (gesendet) oder planned (ein reservierter Name, den Sie möglicherweise bereits abonniert haben; es wurde noch nichts gesendet). Einige Live-Ereignisse werden nur gesendet, wenn die entsprechende Funktion für Ihren Arbeitsbereich aktiviert ist.
| Ereignis | Status | Gesendet, wenn |
|---|---|---|
room.created | aktiv | Ein Raum wurde erstellt |
room.started | aktiv | Der erste Teilnehmer ist einem Raum beigetreten |
room.empty | aktiv | Der letzte Teilnehmer hat einen offenen Raum verlassen |
room.idle_timeout | aktiv | Ein offener Raum hatte während des Inaktivitätszeitraums (data.idleSince, data.idleMinutes) |
room.locked | aktiv | Ein Raum wurde gesperrt oder entsperrt |
room.ended | aktiv | Ein Raum wurde beendet |
participant.joined | aktiv | Ein Teilnehmer ist einem Raum beigetreten |
participant.left | aktiv | Ein Teilnehmer hat einen Raum verlassen |
participant.updated | aktiv | Ein Moderator hat einen Teilnehmer bearbeitet (Rolle, Berechtigungen, Name, Metadaten, Stummschaltung durch den Gastgeber) |
participant.connection_quality | geplant | Verbindungsqualität erfasst (Opt-in) |
track.published | aktiv | Ein Teilnehmer hat einen Track veröffentlicht |
track.unpublished | aktiv | Ein Teilnehmer hat eine Strecke abgebrochen |
track.muted | aktiv | Ein Teilnehmer hat eine Spur stummgeschaltet oder ein Gastgeber hat sie stummgeschaltet |
track.unmuted | aktiv | Eine stummgeschaltete Spur wurde wieder aktiviert |
recording.requested | aktiv | Eine Aufzeichnung wurde angefordert |
recording.started | aktiv | Die Aufzeichnung einer Sendung wurde gestartet |
recording.stopped | aktiv | Die Aufzeichnung wurde einmalig pro Aufzeichnung mit dem reason (requested, room_ended, max_duration, limit, tenant_inactive, shutdown, allowance wenn die Aufzeichnungsminuten aufgebraucht sind, billing_unavailable oder error) |
recording.ready | aktiv | Jede Spur einer Aufnahme wird gespeichert |
recording.failed | aktiv | Eine Aufzeichnung wurde nicht erfolgreich beendet (aufgezeichnete Titel bleiben möglicherweise erhalten) |
recording.composite.ready | aktiv | Die Composite-Video- und Audiodateien werden gespeichert |
recording.composite.failed | aktiv | Es konnte keine zusammengesetzte Datei erstellt werden |
recording.delivered | aktiv | Eine Aufnahmedatei wurde in Ihren eigenen Speicher übertragen |
recording.delivery_failed | aktiv | Eine Aufnahmedatei konnte nicht an Ihren eigenen Speicher übermittelt werden |
recording.deleted | aktiv | Eine Aufzeichnung wurde in den Papierkorb verschoben: data ist { recordingId, roomId, reason, deletedAt, purgeAt }, mit reason customer (Sie haben sie gelöscht) oder retention (die Aufbewahrungsfrist ist abgelaufen), und purgeAt wenn sie automatisch gelöscht wurde (30 Tage später; dies gilt, sobald sie in den Papierkorb verschoben wurde, null , während die automatische Löschung im Papierkorb deaktiviert ist). Bis dahin kann sie wiederhergestellt werden. |
recording.restored | aktiv | Eine Aufzeichnung wurde aus dem Papierkorb wiederhergestellt: data ist { recordingId, roomId, restoredAt, by }, mit by customer oder admin |
recording.purged | aktiv | Eine Aufzeichnung wurde endgültig aus dem Papierkorb gelöscht: data ist { recordingId, roomId, reason, purgedAt }, wobei reason customer (Sie haben es aus dem Papierkorb gelöscht), expired (wird nach 30 Tagen automatisch gelöscht) oder admin (CHAMPREPSupport) |
transcript.queued | aktiv | Das Transkript einer Aufzeichnung hat seine Minuten reserviert und befindet sich in der Warteschlange: data ist { recordingId, roomId, reservedMinutes } (Transkription) |
transcript.completed | aktiv | Das Transkript einer Aufzeichnung ist fertig: data ist { recordingId, roomId, segments, durationMs, billedMinutes, truncated }, wobei truncated true wenn das Kontingent während starker Überlagerungen aufgebraucht wurde. Niemals der Text. |
transcript.failed | aktiv | Die Transkription einer Aufzeichnung ist fehlgeschlagen und es wurden keine Kosten berechnet: data ist { recordingId, roomId, error }, sowie code (RTC_ALLOWANCE_EXHAUSTED, BILLING_UNAVAILABLE, CANCELLED oder RECORDING_LENGTH_UNKNOWN) und offers wenn das Kontingent der Grund ist |
transcript.segment | geplant | Noch nicht für Kunden verfügbar (Live-Untertitel) |
captions.started | geplant | Noch nicht für Kunden verfügbar |
captions.stopped | geplant | Noch nicht für Kunden verfügbar |
whiteboard.created | aktiv | In einem Raum wurde ein Whiteboard erstellt |
whiteboard.archived | aktiv | Ein Whiteboard wurde archiviert oder gelöscht |
whiteboard.opened, whiteboard.closed, whiteboard.snapshot.ready | geplant | Whiteboard-Aktivität |
key.created | aktiv | Ein SchlüsselAPI wurde erstellt |
key.revoked | aktiv | Ein SchlüsselAPI wurde widerrufen |
quota.warning | aktiv | Ein RTC-Kontingent hat einen Warnprozentsatz überschritten (80 %, sofern keine anderen Werte CHAMPREPfestlegt); einmal pro Kontingent, Abrechnungszeitraum und Prozentsatz |
quota.exhausted | aktiv | Ein RTC-Kontingent wird aufgebraucht (Abonnement, Testversion und Pakete); einmal pro Kontingent und Abrechnungszeitraum |
subscription.changed | geplant | Das RTC-Abonnement hat sich geändert (Stufe, Testphase, Zahlungsproblem) |
webhook.test | aktiv | Ein Testereignis, das von der Konsole oder dem API |
webhook.endpoint_disabled | aktiv | Einer Ihrer Endpunkte wurde nach einem Fehler oder einer Antwort deaktiviert 410: data ist { endpointId, url, host, reason }. url umfasst ausschließlich das Schema, den Host und den Pfad, niemals den Abfrage-String; host ist der Host allein; reason ist failing oder gone. |
egress.started, egress.ended, ingress.started, ingress.ended | geplant | Streaming und Ingest (noch nicht verfügbar) |
Ereignisse enthalten Identifikatoren, keine Anzeigenamen, Tokens, IP-Adressen oder Medien. Stimmen Sie wichtige Zustände anhand des ab, APIanstatt sich auf ein einzelnes Ereignis zu verlassen.
Jede Anfrage überprüfen
Abschnitt betitelt „Jede Anfrage überprüfen“Jede Übermittlung enthält zwei unabhängige Signaturschemata. Überprüfen Sie jeweils von diesen, über die genaue Rohdaten des Anfrage-Hauptteils in Bytes, vor dem Parsen von JSON oder der Ausführung. Parsen und serialisieren Sie den Body zur Überprüfung niemals erneut.
X-RTC-Timestamp: 1794139200X-RTC-Signature: v1=<hex>X-RTC-Signatures: v1=<hex> v1=<hex>webhook-id: 0b7c1a52-3d4e-4f5a-9b8c-7d6e5f4a3b2cwebhook-timestamp: 1794139200webhook-signature: v1,<base64> v1,<base64>| Schema | Signierter Inhalt | HMAC-SHA256-Schlüssel | Signatur |
|---|---|---|---|
| Standard-Webhooks (empfohlen) | <webhook-id>.<webhook-timestamp>.<raw body> | whsec_… Geheimnisse: der Base64-dekodierte Teil nach dem whsec_ Präfix. Migrierte Altdaten rtc_… Geheimnisse: die UTF-8-Bytes des gesamten Geheimnisses | webhook-signature: durch Leerzeichen getrennt v1,<base64>, jeweils eines pro aktivem Geheimnis |
| RTC (veraltet) | <X-RTC-Timestamp>.<raw body> | Die UTF-8-Bytes der gesamten geheimen Zeichenfolge, einschließlich etwaiger whsec_ oder rtc_ Präfix | X-RTC-Signature: v1=<hex> für das neueste Geheimnis; X-RTC-Signatures: jedes aktive Geheimnis, durch Leerzeichen getrennt |
Für beide Verfahren gilt:
- Lehnen Sie einen Zeitstempel ab, der mehr als fünf Minuten von Ihrer Uhrzeit abweicht.
- Vergleichen Sie die Signaturen in konstanter Zeit und akzeptieren Sie die Anfrage, wenn beliebig Die aufgeführte Signatur stimmt mit einem Ihrer Geheimnisse überein.
- Während eines Überlappung bei der Rotation,
X-RTC-Signatureenthält nur den neuesten Schlüssel. Ein älterer Empfänger, der noch den vorherigen Schlüssel enthält, muss prüfen,X-RTC-Signatures. - Standardmäßige Webhook-Bibliotheken akzeptieren
whsec_Geheimnisse direkt. Für einen migriertenrtc_…Geheimnis, geben Sie der Bibliothekwhsec_gefolgt von der Base64-Kodierung der gesamten UTF-8-Bytes des Geheimnisses.
Node.js
Abschnitt betitelt „Node.js“Der Beispiel für die Verifizierung implementiert beide Verfahren ohne Abhängigkeiten:
import { verifyStandardWebhook, verifyRtcWebhook } from './verify-webhook.mjs';
// rawBody: the Buffer captured before any JSON middleware.const valid = verifyStandardWebhook({ rawBody, id: request.headers['webhook-id'], timestamp: request.headers['webhook-timestamp'], signature: request.headers['webhook-signature'], secret: process.env.RTC_WEBHOOK_SECRET,}) || verifyRtcWebhook({ rawBody, timestamp: request.headers['x-rtc-timestamp'], signatures: request.headers['x-rtc-signatures'], signature: request.headers['x-rtc-signature'], secret: process.env.RTC_WEBHOOK_SECRET,});if (!valid) return rejectWebhook(); // 401, without applying the eventconst event = JSON.parse(rawBody.toString('utf8'));// Validate the envelope, then atomically deduplicate event.id in durable storage.Rufen Sie während einer Rotation den Verifizierer einmal pro Geheimnis auf, das Sie besitzen.
import base64import hashlibimport hmacimport reimport time
TOLERANCE_SECONDS = 300
def _fresh(timestamp, now=None): if not timestamp or not re.fullmatch(r"[0-9]{1,12}", timestamp): return False return abs((now or time.time()) - int(timestamp)) <= TOLERANCE_SECONDS
def _any_match(expected, header, prefix): entries = header.split(" ") if header else [] matched = False for entry in entries[:16]: if entry.startswith(prefix) and hmac.compare_digest(entry[len(prefix):], expected): matched = True return matched
def standard_webhook_key(secret): """whsec_ secrets: the base64 part after the prefix. Legacy rtc_ secrets: the whole secret.""" if secret.startswith("whsec_"): return base64.b64decode(secret[len("whsec_"):], validate=True) return secret.encode("utf-8")
def verify_standard_webhook(raw_body: bytes, headers, secret: str) -> bool: msg_id = headers.get("webhook-id") timestamp = headers.get("webhook-timestamp") if not msg_id or not _fresh(timestamp): return False signed = f"{msg_id}.{timestamp}.".encode() + raw_body digest = hmac.new(standard_webhook_key(secret), signed, hashlib.sha256).digest() return _any_match(base64.b64encode(digest).decode(), headers.get("webhook-signature"), "v1,")
def verify_rtc_webhook(raw_body: bytes, headers, secret: str) -> bool: timestamp = headers.get("x-rtc-timestamp") if not _fresh(timestamp): return False signed = timestamp.encode() + b"." + raw_body digest = hmac.new(secret.encode("utf-8"), signed, hashlib.sha256).hexdigest() header = headers.get("x-rtc-signatures") or headers.get("x-rtc-signature") return _any_match(digest, header, "v1=")headers muss eine Zuordnung sein, bei der Groß- und Kleinschreibung nicht berücksichtigt wird, wie beispielsweise request.headers in Flask, Django oder Starlette, und raw_body der nicht geparste Hauptteil (request.get_data() in Flask, request.body in Django, await request.body()
(in Starlette).
Diese Beispiele dienen als Anleitung zur Empfängerintegration und stellen keine vollständigen Server dar. Legen Sie ein Limit für den Anfragetext fest, behandeln Sie fehlerhaft formatiertes JSON und validieren Sie den Envelope.
Antworten, Duplikate entfernen und ordnen
Abschnitt betitelt „Antworten, Duplikate entfernen und ordnen“Geben Sie einen 2xx Reagieren Sie umgehend, nachdem Sie ein verifiziertes Ereignis dauerhaft akzeptiert haben, und führen Sie längere Aufgaben asynchron aus. Jeder Versuch läuft nach 5 Sekunden ab. Jeder andere Status, eine Weiterleitung oder ein Timeout gilt als fehlgeschlagener Versuch.
Persist event.id atomisch und verarbeiten Sie jedes Ereignis einmal; ein In-Memory-Set reicht bei Neustarts oder mehreren Empfängerinstanzen nicht aus. Die Zeitstempelprüfung allein verhindert keine Wiederholung innerhalb des akzeptierten Zeitfensters. Die Reihenfolge ist nicht garantiert: Verwenden Sie Zeitstempel in data und das , APIum den aktuellen Status aufzulösen.
Wiederholungsversuche und automatische Deaktivierung
Abschnitt betitelt „Wiederholungsversuche und automatische Deaktivierung“Eine fehlgeschlagene Zustellung wird mit exponentiellem Backoff und Jitter etwa 24 Stunden lang (12 Versuche) erneut versucht und anschließend als dead. Jeder Versuch wird erneut mit den aktuellen Geheimnissen des Endpunkts und einem neuen Zeitstempel signiert.
Jeder Versuch läuft nach 5 Sekunden ab. RTC deaktiviert einen Endpunkt (disabledReason: "failing") wenn eine der folgenden Bedingungen zutrifft:
- er ist 25 Mal in Folge abgelaufen und weist zudem seit mindestens einer Stunde Fehler auf;
- er seit 24 Stunden ununterbrochen Fehler meldet (CHAMPREPkann einen anderen Zeitraum festlegen).
Er wird sofort deaktiviert ("gone") wenn er antwortet 410 Gone. Der Organisationsinhaber wird benachrichtigt, und ein webhook.endpoint_disabled Das Ereignis wird an Ihre anderen Endpunkte gesendet. Beheben Sie das Problem beim Empfänger und aktivieren Sie den Endpunkt anschließend erneut (PATCH mit { "enabled": true }); durch das Aktivieren wird der Fehlerstatus zurückgesetzt.
Test, Zustellungsprotokoll und Wiedergabe
Abschnitt betitelt „Test, Zustellungsprotokoll und Wiedergabe“- Test:
POST /v1/webhooks/endpoints/{endpointId}/testsendet einwebhook.testEreignis sofort und Antworten{ deliveryId, eventId, ok, status, latencyMs, error }. - Zustellungsprotokoll:
GET /v1/webhooks/deliverieslistet Zustellungen auf, die neuesten zuerst, mitstate(pending,retry,delivered,dead,cancelled),attempts,lastStatus,lastErrorundlastLatencyMs. Filtern Sie mit?endpointId,?state,?typeund?eventId. Eine Zustellung (GET /v1/webhooks/deliveries/{deliveryId}) fügt jeden Versuch mit seinem Status, der Latenz und den ersten 1 KB der Antwort Ihres Empfängers sowie das Ereignis selbst hinzu. Das Protokoll wird für einen begrenzten Zeitraum aufbewahrt. - Wiederholung eins:
POST /v1/webhooks/deliveries/{deliveryId}/replayStellen Sie die Zustellung erneut in die Warteschlange. Die Anzahl der Wiederholungen pro Zustellung und pro Tag ist begrenzt (REPLAY_LIMIT,REPLAY_QUOTA); eine übermittelte Zustellung liefert AntwortenDELIVERY_IN_PROGRESS. - Massenwiedergabe:
POST /v1/webhooks/endpoints/{endpointId}/replaymit{ "from": "2026-11-08T00:00:00Z", "to": "2026-11-08T06:00:00Z", "types": ["recording.*"], "onlyFailed": true }Stellt die passenden Ereignisse dieses Zeitraums für den Endpunkt in die Warteschlange, maximal 1000 pro Anfrage, sowie die Antworten202 { "queued": n }.
Fehlerbehebung
Abschnitt betitelt „Fehlerbehebung“- Senden Sie ein Testereignis und lesen Sie dessen
statusunderror. - Lesen Sie im Zustellungsprotokoll die
lastStatussowie den Antwortauszug des Versuchs. - Stellen Sie sicher, dass Sie die Rohbytes mit dem richtigen Schlüssel für das Schema verifizieren (den dekodierten
whsec_Teil für Standard-Webhooks, die gesamte Zeichenfolge fürX-RTC-Signature). - Überprüfen Sie die Zeitabweichung, Weiterleitungen und ob der Endpunkt aktiviert ist.
Protokollieren Sie während der Fehlerbehebung niemals das Signaturgeheimnis, signierte Rohanfragen oder Teilnehmer- Anmeldedaten.