Free, Open Source, Self-Hosted WhatsApp API Gateway
TypeScript apibotgatewayself-hostedwhatsappwhatsapp-apiwhatsapp-automationwhatsapp-botwhatsapp-gatewaywhatsapp-gateway-apiwhatsapp-webwhatsapp-web-api
docs(integration): say a preflight pass gets the route's ack, not 202
Yudhi Armyndharis25217fa04db2
diff --git a/src/core/plugins/plugin.interfaces.ts b/src/core/plugins/plugin.interfaces.tsindex 407e10be5..d7d73ebc3 100644--- a/src/core/plugins/plugin.interfaces.ts+++ b/src/core/plugins/plugin.interfaces.ts@@ -244,7 +244,7 @@ export interface IngressChallengeSpec {export type IngressPreflightCheck = {// Reject (503) when the route's concrete-scoped WhatsApp session is not alive (no live engine, or// EngineStatus.FAILED). Recoverable statuses (INITIALIZING/QR_READY/AUTHENTICATING/DISCONNECTED) and- // READY pass through to a normal 202+enqueue so the worker can fail fast and the dedup row holds the+ // READY pass through to a normal ack + enqueue so the worker can fail fast and the dedup row holds the// delivery. Skipped for wildcard (sessionScope null/'*') scopes — there is no single session to probe.type: 'session-alive';};diff --git a/src/modules/integration/ingress-preflight.ts b/src/modules/integration/ingress-preflight.tsindex 0101fe1c7..166004a9a 100644--- a/src/modules/integration/ingress-preflight.ts+++ b/src/modules/integration/ingress-preflight.ts@@ -7,7 +7,7 @@ export type PreflightRejection = { status: number; body: string; headers?: Recor* Retry-After on the session-alive 503. Presence is what buys the retry: the provider dispatchers that* matter re-attempt a 503 only when the header is set and do not parse its value (supabase/auth checks* `Get("retry-after") != ""`). A session that is merely still coming up already passes through to the- * normal 202 + enqueue path, so a rejection means no live engine or FAILED, and what bounds a provider+ * normal ack + enqueue path, so a rejection means no live engine or FAILED, and what bounds a provider* hammering a dead session is the per-instance bucket IngressService charges after verification, not* this number.*/@@ -21,7 +21,7 @@ const PREFLIGHT_RETRY_AFTER_SECONDS = 5;** `session-alive`: skipped for wildcard (null/'*') scopes and when sessionStatus is unwired; rejects 503* only when the concrete session has no live engine or is EngineStatus.FAILED. Recoverable statuses and- * READY pass through to the normal 202+enqueue path so the worker can fail fast and the delivery stays durable.+ * READY pass through to the normal ack + enqueue path so the worker can fail fast and the delivery stays durable.*/export function evaluatePreflight(route: IngressRouteDescriptor,