Retención de grabaciones por tipo de negocio

English: Recording retention by business type.

El tiempo mínimo que la plataforma conserva el audio de una llamada grabada depende de los tipos de negocio que declare tu tenant. Esta guía cubre las dos rutas que leen y escriben esa declaración. Los nombres de campo, los enums y los códigos de estado están copiados del documento OpenAPI vendorizado (core v0.103.0).

Esto no es asesoría legal ni una promesa de cobertura

Los pisos de abajo salen de las normas federales de EE. UU. que cita el diseño de la plataforma. La ley estatal no está cubierta. Un tenant declara su propio tipo de negocio y responde por él. La matriz legal jurisdicción por jurisdicción todavía no se sirve; ver Lo que aún no cubre.

Disponibilidad

Capacidad	Disponibilidad
GET /v1/business-types, PUT /v1/business-types	Publicado en core v0.103.0 (core#2012, core#2065)

Cómo se calcula el piso

months = legal_floor_months + safety_margin_months

• legal_floor_months es el máximo piso de audio entre los tipos declarados. Un tenant que declara cobranza y telemarketing obtiene el mayor de los dos.
• safety_margin_months es el margen de la plataforma que se suma encima: hoy 3. Se hereda de la planeación de la plataforma, no es una cifra legal.
• El resultado nunca es 0 ni queda por debajo del margen: un tipo cuya regla no pide audio conserva igualmente la retención incluida de la plataforma.
• Un tenant que no declara nada obtiene el máximo entre todos los tipos soportados (basis: undeclared_maximum). Omitir la declaración nunca puede bajar el piso.

Leer la declaración y el piso

GET /v1/business-types

Puede leer cualquier principal de la consola: una llave dd_ o un inicio de sesión del dashboard de cualquier rol. El cuerpo 200 es { "business_types": { ... } }:

Campo	Significado
declared	Los tipos declarados, ordenados; null cuando no se declaró nada.
supported	El vocabulario cerrado, cada entrada { type, audio_floor_months, source }.
retention_floor.months	El piso efectivo para grabaciones nuevas (mínimo 3).
retention_floor.legal_floor_months	El máximo piso de audio entre los tipos declarados.
retention_floor.safety_margin_months	El margen de la plataforma.
retention_floor.basis	declared o undeclared_maximum.
retention_floor.imposed_by	El tipo o los tipos cuyo piso es el vinculante, cada uno con su source.

El vocabulario cerrado de type es cobranza, telemarketing, servicio_cliente, financiera_valores e hipotecas_servicing. Lee el audio_floor_months y el source vigentes de cada uno en supported en lugar de fijarlos en el código. audio_floor_months es 0 cuando la regla no pide el audio.

Códigos de estado: 200, 401, 403, 429 y 503 cuando no se puede leer la declaración; en ese caso no se publica ningún piso, nunca una cifra adivinada.

Declarar los tipos de negocio

PUT /v1/business-types

{ "business_types": ["cobranza"] }

• Solo puede escribir un inicio de sesión del dashboard (ddu_) con el rol account_admin. Una llave dd_ lee pero recibe 403 role_forbidden, y también un inicio de sesión member: bajar un piso es decisión de una persona que responde por ella.
• business_types es obligatorio: una lista tomada del vocabulario de arriba, o null / [] para retirar la declaración (se vuelve al máximo con cierre en falso). La lista se guarda ordenada y sin duplicados.
• El cuerpo es cerrado: una clave desconocida, la ausencia de la clave business_types o un valor que no sea una lista ni null es 400 bad_request. Un tipo fuera del vocabulario es 422 unprocessable.

El cuerpo 200 trae business_types (con la misma forma que la lectura) más:

Campo	Significado
changed	false cuando el cuerpo declaró lo que ya estaba declarado; no se escribe nada.
lowered	true cuando el piso efectivo bajó.
previous_floor_months	El piso efectivo antes de esta llamada.

Cada cambio, al alza o a la baja, escribe una fila de auditoría de solo anexar en la misma transacción: quién, cuándo, el valor anterior y el nuevo, y el piso que implicaba cada uno. Códigos de estado: 200, 400, 401, 403, 422, 429, 503.

Lo que un tenant no puede bajar

• El piso mismo. PUT /v1/recording-policy con un retention_months por debajo del piso efectivo es 422 unprocessable. Escribir esa ruta exige un administrador: una llave dd_ o un inicio de sesión account_admin. Un inicio de sesión member recibe 403 role_forbidden (core#2438); GET /v1/recording-policy no cambia.
• El techo. La misma llamada con un retention_months por encima de max(3, piso) más 12 meses por cada bloque de retención extra comprado es 422 unprocessable; una política ya guardada por encima conserva su valor y nunca se sube. Ver el techo de retención.
• Las grabaciones ya hechas. Un piso más bajo se aplica solo a las grabaciones nuevas. retained_until queda congelado por grabación y los objetos ya sellados conservan su sello; cambiar la declaración o la política nunca les cambia la fecha.
• La omisión. Dejar fuera la declaración no es un camino a un piso más bajo; produce el máximo.

Lo que aún no cubre

La plataforma no publica aquí una matriz de cobertura legal por jurisdicción, y el precio de la retención por encima del piso no está definido en esta guía. Ambas cosas esperan una decisión que se sigue en macro-tasks#415. El registro del roadmap sigue la convención de que una entrada no marcada como entregada no se sirve: ver Roadmap. Hasta entonces, trata las cadenas source que devuelve supported como la cita detrás de cada piso, y nada más.