Reten Docs
Configuración de Actividades

Configuraciones de Razones de Actividad

Configuracion por tenant de razones de actividad activas.

GET /api/activity-reason-configs

Lista todas las configuraciones de razones de actividad del tenant.

Auth: Requerida — permiso VIEW_ACTIVITIES

Ejemplo

curl https://api.reten.ai/api/activity-reason-configs \
  -H "Authorization: Bearer <token>" \
  -H "x-tenant-id: <tenant-id>"
import axios from 'axios';

const response = await axios.get(
  'https://api.reten.ai/api/activity-reason-configs',
  {
    headers: {
      Authorization: 'Bearer <token>',
      'x-tenant-id': '<tenant-id>',
    },
  }
);

const configs = response.data;

Respuesta 200 OK

[
  {
    "id": "880e8400-e29b-41d4-a716-446655440000",
    "activityReasonId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "code": "retention",
    "label": "Retencion",
    "isActive": true,
    "activityReason": {
      "code": "retention",
      "label": "Retention"
    }
  },
  {
    "id": "990e8400-e29b-41d4-a716-446655440000",
    "activityReasonId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "code": "upsell",
    "label": "Upsell",
    "isActive": true,
    "activityReason": {
      "code": "upsell",
      "label": "Upsell"
    }
  }
]

POST /api/activity-reason-configs

Crea una configuracion de razon de actividad para el tenant.

Auth: Requerida — permiso MANAGE_ACTIVITY_CONFIG

Cuerpo de la Solicitud

CampoTipoRequeridoDescripcion
activity_reason_idUUIDSiID de la razon de actividad global
labelstringSiEtiqueta de visualizacion para este tenant

Ejemplo

curl -X POST https://api.reten.ai/api/activity-reason-configs \
  -H "Authorization: Bearer <token>" \
  -H "x-tenant-id: <tenant-id>" \
  -H "Content-Type: application/json" \
  -d '{
    "activity_reason_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "label": "Retencion"
  }'
import axios from 'axios';

const response = await axios.post(
  'https://api.reten.ai/api/activity-reason-configs',
  {
    activity_reason_id: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
    label: 'Retencion',
  },
  {
    headers: {
      Authorization: 'Bearer <token>',
      'x-tenant-id': '<tenant-id>',
    },
  }
);

Respuesta 201 Created


POST /api/activity-reason-configs/bulk

Creacion masiva de configuraciones de razones de actividad del tenant.

Auth: Requerida — permiso MANAGE_ACTIVITY_CONFIG

Cuerpo de la Solicitud

CampoTipoRequeridoDescripcion
itemsarraySiArray de configuraciones a crear
items[].activity_reason_idUUIDSiID de la razon de actividad global
items[].labelstringSiEtiqueta de visualizacion para este tenant

Ejemplo

curl -X POST https://api.reten.ai/api/activity-reason-configs/bulk \
  -H "Authorization: Bearer <token>" \
  -H "x-tenant-id: <tenant-id>" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "activity_reason_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "label": "Retencion"
      },
      {
        "activity_reason_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "label": "Upsell"
      }
    ]
  }'
import axios from 'axios';

const response = await axios.post(
  'https://api.reten.ai/api/activity-reason-configs/bulk',
  {
    items: [
      {
        activity_reason_id: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
        label: 'Retencion',
      },
      {
        activity_reason_id: 'b2c3d4e5-f6a7-8901-bcde-f12345678901',
        label: 'Upsell',
      },
    ],
  },
  {
    headers: {
      Authorization: 'Bearer <token>',
      'x-tenant-id': '<tenant-id>',
    },
  }
);

Respuesta 201 Created


PATCH /api/activity-reason-configs/:id

Actualiza una configuracion de razon de actividad del tenant.

Auth: Requerida — permiso MANAGE_ACTIVITY_CONFIG

Cuerpo de la Solicitud

CampoTipoRequeridoDescripcion
labelstringNoEtiqueta de visualizacion
is_activebooleanNoHabilitar o deshabilitar esta configuracion

Ejemplo

curl -X PATCH https://api.reten.ai/api/activity-reason-configs/<id> \
  -H "Authorization: Bearer <token>" \
  -H "x-tenant-id: <tenant-id>" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Etiqueta Actualizada"
  }'
import axios from 'axios';

const response = await axios.patch(
  'https://api.reten.ai/api/activity-reason-configs/<id>',
  {
    label: 'Etiqueta Actualizada',
  },
  {
    headers: {
      Authorization: 'Bearer <token>',
      'x-tenant-id': '<tenant-id>',
    },
  }
);

Respuesta 200 OK


DELETE /api/activity-reason-configs/:id

Desactiva una configuracion de razon de actividad del tenant.

Auth: Requerida — permiso MANAGE_ACTIVITY_CONFIG

Ejemplo

curl -X DELETE https://api.reten.ai/api/activity-reason-configs/<id> \
  -H "Authorization: Bearer <token>" \
  -H "x-tenant-id: <tenant-id>"
import axios from 'axios';

const response = await axios.delete(
  'https://api.reten.ai/api/activity-reason-configs/<id>',
  {
    headers: {
      Authorization: 'Bearer <token>',
      'x-tenant-id': '<tenant-id>',
    },
  }
);

Respuesta 204 No Content