Skip to main content

​
Contexto

  • canal: por dónde vas a ejecutar la acción (push, sms, email, app, caja…).
  • campana_id: si la decisión pertenece a una campaña definida con PUT /v1/campanas/{id}, se aplica su presupuesto.
  • acciones_permitidas: subconjunto de ids que puedes ejecutar ahora (por ejemplo, solo cupones de app si el cliente está en la app). 0 siempre está.

​
Ventana abierta

Si el cliente ya tiene una decisión con ventana de recompensa abierta (menos de N días, 28 por defecto), la respuesta es accion: 0, propension: 1 y el decision_id de esa decisión, con el motivo «ventana de recompensa abierta». No se crea otra.

​
Límites

Hasta 50 peticiones por segundo por credencial (ráfaga de 100), 3 decisiones por cliente_ref y día, y la cuota diaria del inquilino. Al pasarte: 429 con Retry-After. Ver límites.

​
Modo sombra

Durante el alta, el operador activa el modo sombra del inquilino. En ese modo el motor decide y registra como siempre, pero solo sugiere: cada respuesta lleva en_sombra: true y tu sistema debe seguir aplicando su regla de negocio actual. Lo que tienes que hacer en sombra, por cada decisión recibida:
  1. Aplicar tu regla como hasta ahora (mandar el cupón que mandarías, o ninguno).
  2. Si mandas un cupón, etiquetar el CUPON_RECIBIDO con el decision_id recibido.
  3. Confirmar la ejecución con accion_real = el id de tu catálogo del cupón que mandaste (0 si no mandaste nada): POST /v1/decisiones/{decision_id}/ejecucion con {"ejecutada": true, "accion_real": 0}.
Así el motor comprueba, sin tocar tus envíos, que el contrato, el bucle de confirmaciones y la atribución funcionan (≥ 95 % de confirmaciones y de cupones con decision_id), y compara lo que habría hecho con lo que hiciste. Cuando el operador desactiva la sombra, las respuestas dejan de llevar en_sombra y debes ejecutar la acción decidida.