BitelioBitelio

Registrar intención comercial autenticada

Solo para el servidor del comercio, con clave secreta y los permisos retention:edit Y contacts:edit. El comercio verifica al comprador autenticado antes de asociar integrationId/contactId/orderId de Bitelio. Requiere seguimiento habilitado y un programa activo del pedido, sin retirada ni borrado de respuestas. Los GID de producto/variante deben pertenecer a esa integración. occurredAt debe estar dentro de las últimas 24 horas y nunca en el futuro. eventId es inmutable: un reintento con datos distintos se rechaza. Límite de 120 solicitudes por proyecto y minuto. Los eventos del píxel público no acreditan intención comercial. No crea consentimiento ni responde encuestas. Las señales caducan para decisiones en 2–48 horas y el barrido elimina después el historial temporal.

POST
/v1/retention/commerce-intents

Authorization

ApiKeyAuth

AuthorizationBearer <token>

Autenticación mediante clave de API. Las claves secretas (sk_*) son obligatorias en todos los endpoints excepto /v1/track. Las claves públicas (pk_*) solo funcionan con el endpoint /v1/track para el seguimiento de eventos desde el cliente. El proyecto se deriva automáticamente de la clave.

In: header

Request Body

application/json

integrationId*string
Length1 <= length <= 100
contactId*string
Length1 <= length <= 100
orderId*string
Length1 <= length <= 100
eventId*string
Match^[a-zA-Z0-9._:-]+$
Length1 <= length <= 128
kind*string
Value in"VIEWED_PRODUCT" | "ADDED_TO_CART" | "CHECKOUT_STARTED" | "CHECKOUT_ABANDONED" | "CHECKOUT_COMPLETED"
occurredAt*string
Formatdate-time
products*
Items1 <= items <= 20
[key: string]?never

Response Body

application/json

curl -X POST "https://bitelio-api.heltia.com/v1/retention/commerce-intents" \  -H "Content-Type: application/json" \  -d '{    "integrationId": "string",    "contactId": "string",    "orderId": "string",    "eventId": "string",    "kind": "VIEWED_PRODUCT",    "occurredAt": "2019-08-24T14:15:22Z",    "products": [      {        "productId": "string"      }    ]  }'
{
  "id": "string",
  "accepted": true,
  "duplicate": true,
  "expiresAt": "2019-08-24T14:15:22Z"
}
Empty
Empty
Empty
Empty
Empty