Recommendations

A recommendation records that an agent presented an eligible offer to a user. It is the core attribution event in Rako.

POST /v1/recommend
Content-Type: application/json

Request

{
  "session_id": "sess_...",
  "offer_id": "offer_...",
  "context": "Best value for a cheap rolling SIM with at least 10GB"
}

{
  "recommendation_id": "rec_...",
  "attribution_recorded": true,
  "fallback_url": "https://aap.link/r/..."
}

Create the recommendation when the agent actually recommends the offer, not when the user clicks a link.
Include concise context explaining why the offer was recommended.
Use the returned recommendation ID when initiating checkout.