Usuarios Destinatarios

GET /api/activities/:id/target-users

Lista los usuarios destinatarios resueltos de una actividad.

Auth: Requerida — permiso VIEW_ACTIVITIES

Parámetros de Ruta

Parámetro	Tipo	Descripción
`id`	UUID	ID de la actividad

Ejemplo

curl https://api.reten.ai/api/activities/ee0e8400-e29b-41d4-a716-446655440000/target-users \
  -H "Authorization: Bearer <token>" \
  -H "x-tenant-id: <tenant-id>"

const activityId = "ee0e8400-e29b-41d4-a716-446655440000";
const response = await fetch(`https://api.reten.ai/api/activities/${activityId}/target-users`, {
  headers: {
    "Authorization": "Bearer <token>",
    "x-tenant-id": "<tenant-id>",
  },
});
const targetUsers = await response.json();

import requests

activity_id = "ee0e8400-e29b-41d4-a716-446655440000"
response = requests.get(
    f"https://api.reten.ai/api/activities/{activity_id}/target-users",
    headers={
        "Authorization": "Bearer <token>",
        "x-tenant-id": "<tenant-id>",
    },
)
target_users = response.json()

Respuesta `200 OK`

[
  {
    "id": "110e8400-e29b-41d4-a716-446655440000",
    "commerceUserId": "aa0e8400-e29b-41d4-a716-446655440000",
    "status": "RESOLVED",
    "lockReason": "CRITERIA_MATCH",
    "commerceUser": {
      "firstName": "Maria",
      "lastName": "Garcia"
    }
  }
]

PATCH /api/activities/:id/target-users/:targetUserId/resolve

Asigna manualmente un usuario de comercio como el usuario destinatario. Solo funciona con usuarios destinatarios en estado PENDING.

Auth: Requerida — permiso CREATE_ACTIVITY

Parámetros de Ruta

Parámetro	Tipo	Descripción
`id`	UUID	ID de la actividad
`targetUserId`	UUID	ID del registro del usuario destinatario

Cuerpo de la Solicitud

Campo	Tipo	Requerido	Descripción
`commerce_user_id`	UUID	Sí	Usuario de comercio a asignar

Respuesta `200 OK`

Devuelve el registro del usuario destinatario actualizado.

Respuestas de Error

Estado	Descripción
`400`	El usuario destinatario no está en estado PENDING o ya está bloqueado