Webhooks

📄️Receive Faire Webhook

Single webhook endpoint that receives every Faire event. Faire identifies the event via the `X-Faire-Webhook-Topic` header — the request body shape varies by topic.

📄️List Webhook Configurations

List every available Temu TMC event code with its current subscription state for this integration instance.

📄️Enable Webhook Subscription

Subscribe the shop to a single TMC event code via `bg.tmc.message.update` and persist the local mirror row in `temu_webhooks`.

📄️Disable Webhook Subscription

Unsubscribe the shop from a single TMC event code via `bg.tmc.message.update` and delete the local mirror row.

📄️Enable All Webhooks

Dispatch `CreateTemuWebhooksJob` via the **Tracked Job pattern** — subscribes the integration instance to every event code in `TemuEventCodeEnum` in one shot. The HTTP call returns immediately; the worker performs each TMC `bg.tmc.message.update` call in the background.

📄️List Webhook Events

Paginated list of TMC events captured for this integration instance, with Spatie QueryBuilder filtering and sorting.

📄️Webhook Event Stats

Aggregate counts of webhook events for an integration instance, broken down by `processing_status`. Used to render the summary cards on the webhooks settings page.

📄️Show Event

Full record for a single webhook event, including the raw payload (`json_data`) Temu delivered.

📄️Process Pending Events

Synchronously process all pending webhook events for the integration instance (optionally scoped to a single event code).

📄️Retry Failed Events

Reset failed events with fewer than 3 attempts back to pending and process them again.

📄️Process Event (single)

Process a specific webhook event. No-ops if it has already been processed.

📄️Reprocess Event (single)

Force-reset a single event to pending and run it through processing again (works even for already-processed events).

📄️Bulk Reprocess Events

Bulk reset + reprocess. Either provide `event_ids` or set `apply_to_all=true` with `filters` + `integration_instance_id`.

📄️Bulk Delete Events

Delete webhook events. Requires `confirmation: 'YES'` to prevent accidental loss.

📄️Delete All Events for Instance

Permanently delete every webhook event for the integration instance. Irreversible — requires `confirmation: 'YES'`.