Choose products or request help inside the app

Revalidates device session and mobile permission inside the action transaction. REQUESTED returns up to three eligible product choices; VIEWED records deliberate viewing; SELECTED/CHECKOUT require an exact returned product and variant and recheck current stock and policy. HELP REQUESTED shows reviewed guidance; HELP_REQUESTED creates support only if canContact, RESOLVED confirms resolution. No survey submission is required. Never invent product ids or a checkout URL. HELP/RESOLVED must echo caseId and updatedAt from the displayed helpRevision; a changed case is rejected with HELP_REPLY_CONFLICT. Never generate these values locally.

Authorization

MobileSurveySession

X-Bitelio-Mobile-Session<token>

Short-lived token created by the authenticated merchant backend; also requires X-Bitelio-Device.

In: header

Header Parameters

X-Bitelio-Device*string

Match^[A-Za-z0-9_-]{16,128}$

Request Body

application/json

action*string

Value in"REPEAT" | "DISCOVER" | "HELP"

stage*string

productId?string

variantId?string

caseId?string

Exact helpRevision.caseId returned for the case shown to the buyer; required only for HELP/RESOLVED.

updatedAt?string

Exact helpRevision.updatedAt returned by the API; required only for HELP/RESOLVED.

Formatdate-time

[key: string]?never

Response Body

`application/json`

curl -X POST "https://bitelio-api.heltia.com/public/retention/mobile-survey/actions" \
  -H "X-Bitelio-Device: string" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "REPEAT",
    "stage": "REQUESTED"
  }'

curl -X POST "https://bitelio-api.heltia.com/public/retention/mobile-survey/actions" \  -H "X-Bitelio-Device: string" \  -H "Content-Type: application/json" \  -d '{    "action": "REPEAT",    "stage": "REQUESTED"  }'

{}

Empty