GuidesWebhook Apps
Deliveries, Replay, and Observability
Operate webhook delivery at scale with filtered triage, replay workflows, and analytics.
Deliveries, Replay, and Observability
After endpoint setup, operational quality determines customer trust.
Core operator capabilities
- Filter delivery stream by endpoint/status/event/time.
- Inspect individual delivery details.
- Replay failed deliveries safely.
- Track success rate and latency trends.
- Escalate and resolve incidents with clear runbooks.
Delivery and analytics hooks
import {
useWebhookDeliveries,
useWebhookAnalytics,
useWebhookTimeseries,
} from "@wacht/nextjs";
export function WebhookOpsSummary() {
const deliveries = useWebhookDeliveries({ status: "failed", limit: 25 });
const analytics = useWebhookAnalytics({ fields: ["success_rate", "failed", "total_deliveries"] });
const timeseries = useWebhookTimeseries({ interval: "hour" });
if (deliveries.loading || analytics.loading || timeseries.loading) {
return <div>Loading webhook operations...</div>;
}
return (
<section>
<div>Failed deliveries: {deliveries.deliveries.length}</div>
<div>Success rate: {analytics.analytics?.success_rate ?? 0}%</div>
<div>Timeseries points: {timeseries.timeseries.length}</div>
</section>
);
}Replay workflow (session hook)
const {
replayDelivery,
fetchReplayTasks,
fetchReplayTaskStatus,
cancelReplayTask,
} = useWebhookAppSession(ticket);
const replay = await replayDelivery({
status: "failed",
start_date: "2026-04-01T00:00:00Z",
end_date: "2026-04-01T23:59:59Z",
});
const taskId = replay.data.task_id;
if (taskId) {
const taskStatus = await fetchReplayTaskStatus({ taskId });
const recentTasks = await fetchReplayTasks({ limit: 20 });
if (taskStatus.data.status === "running") {
// surface progress in UI
}
// optional incident control
await cancelReplayTask({ taskId });
}Incident triage pattern
- Alert fires on failed-delivery threshold.
- Operator filters deliveries to impacted endpoint/event.
- Operator inspects error class and receiver response.
- Operator validates customer receiver fix.
- Operator executes bounded replay window.
- Operator confirms success-rate recovery in analytics.
Recommended dashboards
- Failed deliveries by endpoint (1h, 24h, 7d).
- Success-rate trend by event group.
- P95/P99 response-time trend.
- Replay task volume, duration, and success/failure rate.
Production guardrails
- Require idempotent receiver processing in customer docs.
- Bound replay windows to avoid receiver overload.
- Audit all replay/cancel operations.
- Alert on sustained endpoint failure and auto-disable transitions.