# Wiederholungen und Zustand

> Was passiert, wenn dein Endpunkt nicht antwortet. Der Zeitplan der Wiederholungen, wie ein Endpunkt pausiert und abgeschaltet wird und wie du verpasste Ereignisse zurückbekommst.

Stand: 2026-10-30. Quelle: https://docs.smartchat.marketing/de/webhooks/retries/

## Was als Erfolg zählt

Jeder 2xx-Status innerhalb von 10 Sekunden. Alles andere ist ein Fehlschlag: eine Zeitüberschreitung, ein Verbindungsfehler, ein Status 3xx, 4xx oder 5xx. Weiterleitungen werden nie befolgt, deshalb ist eine 3xx-Antwort ein Fehlschlag.

- **410 Gone** schaltet den Endpunkt sofort ab. Nutze es, wenn SmartChat aufhören soll.
- Bei 429 und 5xx beachtet SmartChat den Header `Retry-After` (höchstens 24 Stunden).

## Zeitplan der Wiederholungen

Eine fehlgeschlagene Zustellung wird noch einmal versucht. Es gibt bis zu 9 Versuche, und zwar spätestens 72 Stunden nach dem Ereignis (der letzte Versuch wird auf diesen Zeitpunkt vorgezogen). Zu jeder Wartezeit kommt eine zufällige Änderung von bis zu 20 Prozent, damit viele Zustellungen nicht im selben Moment ankommen. Der Header `SmartChat-Delivery-Attempt` sagt dir, den wievielten Versuch du bekommen hast.

| Attempt | Wait before the attempt |
|---|---|
| 1 | immediately |
| 2 | 30 seconds |
| 3 | 2 minutes |
| 4 | 10 minutes |
| 5 | 1 hour |
| 6 | 4 hours |
| 7 | 12 hours |
| 8 | 1 day |
| 9 | 2 days |

Nach dem letzten Versuch ist die Zustellung `failed`. Fehlgeschlagene Zustellungen bleiben 30 Tage im Zustellprotokoll. Du kannst sie von Hand noch einmal senden.

## Zustand eines Endpunkts

Ein Endpunkt wird nie nach einer einzigen fehlgeschlagenen Zustellung abgeschaltet.

| Zustand | Was er bedeutet | Wie er sich ändert |
|---|---|---|
| `active` | Empfängt Ereignisse. | 5 fehlgeschlagene Versuche hintereinander: `degraded`. |
| `degraded` | Empfängt noch Ereignisse. Der Zustand steht in der App und im Endpunkt (`status`). SmartChat sendet noch keine Warn-Mail, prüfe den Status also ab und zu. | Ein Erfolg: `active`. Mindestens 3 Tage ohne Erfolg und mindestens 20 Versuche hintereinander: `paused`. |
| `paused` | Empfängt keine Ereignisse. Zustellungen, die beim Pausieren des Endpunkts warten, schlagen mit `endpoint_paused` fehl und werden nicht von selbst später gesendet. | 7 Tage ohne Erfolg: `disabled`. Der Aufruf "Wieder einschalten" macht ihn wieder `active`. |
| `disabled` | Empfängt keine Ereignisse. | Eine 410-Antwort schaltet einen Endpunkt sofort ab. Der Aufruf "Wieder einschalten" macht ihn wieder `active`. |

Der Test-Aufruf ändert den Zustand eines Endpunkts nicht.

**Ereignisse während einer Pause kommen nur mit einem Replay zurück.** Solange ein Endpunkt `paused` oder `disabled` ist, werden seine Ereignisse nicht für ihn eingereiht und wartende Zustellungen werden als fehlgeschlagen markiert. Schaltest du ihn wieder ein, sende `replay_since` im Aufruf "Wieder einschalten" (die Zeit deiner letzten guten Zustellung, höchstens 7 Tage zurück und 10.000 Ereignisse), oder rufe danach "Ereignisse erneut senden (Replay)" auf. Ohne Replay gehen diese Ereignisse für diesen Endpunkt verloren.

## Verpasste Ereignisse zurückholen

- **Eine Zustellung noch einmal senden:** der Aufruf "Erneut zustellen" bei einer Zustellung.
- **Einen Endpunkt wieder einschalten:** der Aufruf "Wieder einschalten" (für Endpunkte mit `paused` und `disabled`). Du kannst im selben Aufruf verlangen, dass Ereignisse ab einer Zeit erneut gesendet werden.
- **Ereignisse erneut senden (Replay):** Der Aufruf "Ereignisse erneut senden (Replay)" sendet Ereignisse eines Zeitraums noch einmal (höchstens 7 Tage zurück und 10.000 Ereignisse; er braucht einen `Idempotency-Key`).

Alle Aufrufe stehen in der [Webhook-Endpunkte API](https://docs.smartchat.marketing/de/webhooks/endpoints-api/).