Ir al contenido
Documentation

RTC: utilice su propio almacenamiento

RTC puede copiar todas las grabaciones finalizadas a un bucket de su propiedad. También CHAMPREPconserva su propia copia, por lo que la grabación seguirá estando disponible para su descarga desde RTC, independientemente de si la entrega se realiza con éxito o no.

La entrega a su propio almacenamiento está incluida en el Crecimiento y Negocios niveles. La prueba gratuita, el nivel Starter y la asignación incluida en los planes de pago CHAMPREP no lo incluyen. Sin él, las rutas de almacenamiento responden 403 RTC_FEATURE_NOT_IN_PLAN con los niveles que lo incluyen en offers. Véase planes y facturación.

Si su plan deja de incluirlo, RTC desactivará sus destinos. Una vez que vuelva a actualizar, vuelva a activar cada uno de ellos; RTC ejecutará primero una nueva prueba de escritura.

TipoÚselo paraLo que almacena RTC
aws-role (preferible)Un depósito de AWS S3Nada confidencial. RTC asume un rol de IAM que usted crea, con un ID externo.
s3-compatibleCloudflare R2, MinIO, Wasabi, Backblaze B2 o AWS con claves de accesoSu ID de clave de acceso y su clave secreta, cifrados

Un destino pertenece a su organización. Da servicio a un proyecto o a todos los proyectos cuando projectId es null. Una organización puede tener hasta 5 destinos; una respuesta más 409 DESTINATION_LIMIT.

Cree, modifique, pruebe y elimine destinos en la consola de RTC, o a través de la API con su sesión de la consola en la que ha iniciado sesión. API Las claves no pueden crear ni modificar destinos. Una clave con recordings:read puede mostrarlos; una clave de proyecto ve los destinos de su propio proyecto y los de todos los proyectos.

Método y rutaCredencialResultado
GET /v1/storage/destinationsSesión de la consola, o una clave con recordings:readLos destinos, ordenados por antigüedad
GET /v1/storage/destinations/{destinationId}Sesión de la consola, o una clave con recordings:readUn destino
GET /v1/storage/aws-setupSesión de la consolaSu ID externo y las políticas de IAM que debe pegar (Rol de AWS)
POST /v1/storage/destinationsSesión de la consola201, el destino tras su escritura de prueba
PATCH /v1/storage/destinations/{destinationId}Sesión de la consolaModifique la configuración, rote las claves o active o desactive la función
POST /v1/storage/destinations/{destinationId}/testSesión de la consolaEjecute de nuevo la prueba de escritura
DELETE /v1/storage/destinations/{destinationId}Sesión de la consola{ "id": "…", "deleted": true }
GET /v1/recordings/{recordingId}/deliveriesrecordings:readLas entregas de la grabación (Realice los envíos)
POST /v1/recordings/{recordingId}/redeliverrecordings:write202, vuelve a entregar la grabación
DELETE /v1/recordings/{recordingId}recordings:writeEnvía la grabación a la Papelera (Eliminar una grabación)
GET /v1/recordings?trashed=truerecordings:readLas grabaciones en la Papelera
POST /v1/recordings/{recordingId}/restorerecordings:writeRecupera la grabación de la Papelera
POST /v1/recordings/{recordingId}/purgerecordings:writeElimina la grabación de forma permanente de la Papelera

Las credenciales nunca se devuelven. Las respuestas se envían con Cache-Control: no-store.

CampoAmbos tiposNotes
type✓aws-role o s3-compatible
name✓Su etiqueta, de hasta 80 caracteres
projectId✓Un proyecto, o null para cada proyecto
bucket, region✓El nombre del depósito y su región
pathTemplate✓Opcional; consulte Plantillas de ruta
keepCopyDays✓Opcional, de 0 a 3650, valor predeterminado 7; consulte retención
roleArn, kmsKeyIdaws-roleSu rol y, opcionalmente, su clave KMS para SSE-KMS
provider, endpoint, forcePathStyle, accessKeyId, secretAccessKeys3-compatibleforcePathStyle El valor por defecto es true

Un destino también informa de su status (active, unverified o disabled), lastCheck (la última escritura de prueba) y lastDelivery.

RTC nunca almacena sus claves de AWS. Usted crea un rol en su cuenta que el rol de entrega de RTC puede asumir, limitado por un ID externo único para su organización.

  1. Llame a GET /v1/storage/aws-setup?bucket=<your-bucket> (añada pathTemplate y kmsKeyArn si los utiliza), o abra la misma configuración en la consola.
  2. Cree un rol de IAM. Pegue el texto devuelto trustPolicy: confía en principalArn solo cuando la solicitud incluya su externalId.
  3. Asigne el devuelto permissionsPolicy. Permite s3:PutObject y s3:AbortMultipartUpload en su ruta, s3:DeleteObject solo en la carpeta de validación, y kms:GenerateDataKey y kms:Encrypt en su clave KMS cuando ha indicado una.
  4. Cree el destino con type: "aws-role" y el rol roleArn:
{
"type": "aws-role",
"name": "Recordings archive",
"projectId": null,
"bucket": "acme-rtc-recordings",
"region": "us-east-1",
"roleArn": "<your-delivery-role-arn>"
}

El identificador externo se crea una sola vez para su organización y no cambia. Cuando available es false En la respuesta de configuración, los destinos de roles de AWS aún no están disponibles y al crear uno se obtiene la respuesta 503 DELIVERY_NOT_CONFIGURED; utilice claves de acceso mientras tanto.

Utilice type: "s3-compatible" para Cloudflare R2, MinIO, Wasabi, Backblaze B2 o AWS cuando prefiera utilizar claves de acceso. Indique el nombre de su servicio en el provider campo, con uno de estos valores: r2, minio, wasabi, backblaze, aws o other.

  • endpoint debe ser un origen HTTPS en el puerto 443, sin ruta, consulta ni nombre de usuario, fuera de los dominiosCHAMPREP, y debe resolverse en direcciones públicas. RTC comprueba la dirección de nuevo en cada conexión. De lo contrario, RTC responde 400 ENDPOINT_NOT_ALLOWED.
  • Conceda a las claves acceso de escritura al depósito. Elimine el acceso en el champrep-rtc-validation/ La carpeta permite a RTC eliminar su objeto de prueba.
  • Las claves se cifran en reposo y nunca se devuelven. Un destino solo muestra accessKeyIdHint, los cuatro últimos caracteres del ID de la clave.
  • Para rotar las claves, PATCH accessKeyId y secretAccessKey en conjunto.
  • Cuando el almacenamiento de claves no está disponible, RTC responde 503 CREDENTIALS_UNAVAILABLE; utilice un rol de AWS mientras tanto.

RTC comprueba un destino cuando lo crea, cuando cambia su región, plantilla de ruta, rol, clave KMS, punto de conexión, estilo de ruta o claves, cuando lo vuelve a activar y cuando llama a POST /v1/storage/destinations/{destinationId}/test.

La prueba escribe un objeto de 64 bytes en <path prefix>/champrep-rtc-validation/<uuid>.txt y, a continuación, lo elimina. Una eliminación denegada es solo una advertencia: permita s3:DeleteObject en esa carpeta, o elimine el objeto usted mismo.

Cuando la prueba falla, el destino se guarda como unverified y no recibe nada. lastCheck contiene un código y una frase:

CódigoSignificado
ROLE_ASSUME_DENIEDRTC no ha podido asumir el rol (política de confianza o ID externo)
WRITE_DENIEDSe ha denegado la escritura
BUCKET_NOT_FOUNDEl depósito no existe
WRONG_REGIONEl depósito se encuentra en otra región
INVALID_ACCESS_KEY, INVALID_SECRET_KEYSe han rechazado las claves
KMS_DENIEDLa clave KMS rechazó el cifrado
ENDPOINT_NOT_ALLOWED, ENDPOINT_NOT_FOUND, ENDPOINT_UNREACHABLEEl punto final ha sido rechazado, es desconocido o no responde
DELIVERY_NOT_CONFIGUREDLos destinos de roles de AWS aún no están disponibles
STORAGE_ERROROtro error de almacenamiento

Solucione la causa y, a continuación, vuelva a realizar la prueba. Un destino pasa a ser active cuando una prueba se realiza con éxito. Un destino desactivado por el servicioCHAMPREP de asistencia no puede ser reactivado por usted (DESTINATION_ADMIN_DISABLED).

La plantilla establece la clave de objeto de cada archivo. El valor por defecto es:

{project}/{yyyy}/{mm}/{dd}/{room}/{recording_id}/{file}
VariableValor
{project}ID del proyecto
{room}ID de sala
{recording_id}ID de la grabación
{external_ref}La sala externalRef; none cuando está ausente o es inusual
{track_id}ID de pista
{artifact}¿Qué archivo de la grabación?
{file}<trackId>.mkv, recording.mp4, audio.m4a, o para un transcripción transcript.json y transcript.vtt
{yyyy}, {mm}, {dd}Partes de la fecha

Los alias project_id, projectId, room_id, roomId, recordingId, externalRef y trackId También se aceptan.

Una plantilla debe contener {recording_id} y termina con {file}. El texto literal puede contener letras, dígitos y ! _ . * ' ( ) / -. No puede comenzar con / o contener //, . o .. carpetas. Una clave puede tener un máximo de 900 bytes.

  • Cuando una grabación es ready, RTC copia cada uno de sus archivos (cada pista y los archivos compuestos, si los hay) a cada destino activo de su proyecto. Una transcripción se entrega de la misma forma que transcript.json y transcript.vtt.
  • Solo se entregan automáticamente las grabaciones que finalizan después de que un destino se haya activado. Para entregar las anteriores, utilice reenviar.
  • Los archivos de más de 16 MiB se envían por partes. RTC informa del SHA-256 de los bytes que ha enviado.
  • Si un intento falla, se vuelve a intentar con un intervalo de espera (1, 2, 4… minutos, con un máximo de una hora de diferencia) durante 72 horas. Transcurrido ese tiempo, la entrega se da por fallida y recording.delivery_failed se envía.
  • Los bytes recibidos cuentan para el límite de descarga de su plan.
  • Desactivar un destino cancela sus envíos en cola. Eliminarlo tiene el mismo efecto y elimina sus credenciales.

Un proceso interrumpido en medio de una subida puede dejar partes incompletas en su depósito. Añada un AbortIncompleteMultipartUpload regla de ciclo de vida (1 día) al depósito.

Suscríbase a su Puntos finales de webhook a estos eventos. Cada entrega de archivo envía su propio evento.

Eventodata
recording.deliveredrecordingId, roomId, destinationId, artifact, trackId (para una pista), bucket, key, size, sha256, checksum, etag, deliveredAt
recording.delivery_failedrecordingId, roomId, destinationId, artifact, trackId (para una pista), bucket, key, attempts, error (code, message)

Una grabación incluye un resumen de entrega: delivery.state (pending, delivered, partial o failed) y la pending, delivered y failed cuenta.

GET /v1/recordings/{recordingId}/deliveries Vuelve a recordingId, es decir, que summary y deliveries: cada tarea con su depósito de destino y su clave, su resultado (tamaño, SHA-256 y ETag) y su último error.

POST /v1/recordings/{recordingId}/redeliver con un { "destinationId": "…" } Reinicia los trabajos fallidos, cancelados y entregados con un nuevo plazo de 72 horas y crea los que falten.

HTTPCódigoSignificado
409RECORDING_NOT_READYSolo un ready La grabación puede entregarse
409NO_ACTIVE_DESTINATIONNo hay ningún destino activo asociado a esta grabación
404NO_ACTIVE_DESTINATIONNingún destino activo tiene esto destinationId

Al eliminar una grabación, esta se envía a la Papelera. Se elimina automáticamente al cabo de 30 días, y puede recuperarla hasta entonces. Cada una de las siguientes llamadas requiere una clave con recordings:write o su sesión de consola.

DELETE /v1/recordings/{recordingId} envía la grabación a la Papelera:

{ "id": "…", "status": "trashed", "trashedAt": "2026-11-08T12:00:00.000Z", "reason": "customer", "purgeAt": "2026-12-08T12:00:00.000Z" }
  • La grabación sale de la lista y GET /v1/recordings/{recordingId}. GET /v1/recordings?trashed=true Muestra las grabaciones que se encuentran en la Papelera.
  • Sus descargas dejan de funcionar, incluidos los enlaces de descarga ya generados.
  • Se cancelan sus envíos en cola.
  • Sigue ocupando espacio de almacenamiento de grabaciones y se factura mientras se encuentra en la Papelera.
  • purgeAt Se produce cuando se elimina automáticamente: 30 días después de haberla enviado a la Papelera. Se establece en el momento en que la grabación se envía a la Papelera: cualquier cambio posterior en la ventana de la Papelera solo se aplica a las grabaciones enviadas a la Papelera a partir de ese momento. purgeAt es null mientras que la eliminación automática de la Papelera está desactivada.
  • recording.deleted se envía.
  • Una grabación que aún se está ejecutando o procesando responde 409 RECORDING_ACTIVE; deténgalo o espere.

POST /v1/recordings/{recordingId}/restore saca la grabación de la Papelera. La respuesta es la grabación, que vuelve a aparecer en sus listas y descargas tal y como estaba antes de ser eliminada. recording.restored se envía. Puede restaurar una grabación hasta que se elimine automáticamente o se elimine de forma permanente. Una restauración que llegue demasiado tarde responde 409 RECORDING_PURGED.

Las entregas a su propio almacenamiento que se cancelaron cuando la grabación pasó a la Papelera se envían de nuevo. Una grabación restaurada se conserva hasta que la elimine de nuevo: la retención no la devuelve a la Papelera.

POST /v1/recordings/{recordingId}/purge elimina definitivamente una grabación de la Papelera. RTC lo acepta de inmediato y responde 202; la eliminación finaliza en breve:

{ "id": "…", "status": "deleting", "purgeRequestedAt": "2026-11-08T12:05:00.000Z" }
  • Nunca se puede restablecer, desde el momento en que RTC acepta la solicitud.
  • Una vez realizada la eliminación, sus archivos se borran, deja de contabilizarse en el almacenamiento de registros y recording.purged se envía.
  • Repetir la solicitud es seguro: responde 202 de nuevo mientras se ejecuta la eliminación, entonces 200 una vez hecho esto: { "id": "…", "status": "purged", "purgedAt": "2026-11-08T12:05:30.000Z" }.
  • Solo un registro de la Papelera puede eliminarse de forma permanente. Cualquier otro registro responde 409 RECORDING_NOT_IN_TRASH: envíelo primero a la Papelera.

Un registro se elimina de forma permanente en su purgeAt (30 días en la Papelera), de la misma manera, y recording.purged se envía con reason: "expired". El servicio de CHAMPREP asistencia también puede eliminar antes una grabación de la Papelera si así lo solicita.

Las copias ya entregadas en su depósito son de su propiedad. Enviar una grabación a la Papelera, eliminarla de forma permanente o activar su eliminación automática nunca las borra.

CHAMPREP conserva su propia copia de una grabación según el periodo de retención de su plan: 7 días en la versión de prueba, 30 días en Starter, 90 días en Growth y 365 días en Business. Una vez transcurrido ese tiempo, la grabación se envía a la Papelera de la misma forma que anteriormente, con reason: "retention": puede recuperarlo durante 30 días y, transcurrido ese plazo, se elimina automáticamente.

La retención solo se aplica a las grabaciones realizadas después de que RTC comenzara a aplicarla. Las grabaciones realizadas antes de esa fecha no caducan por este motivo. La retención nunca afecta a las copias de su propio bucket.

keepCopyDays En un destino (de 0 a 3650, por defecto 7) se registra el tiempo que desea CHAMPREP conservar su copia tras una entrega. La copia CHAMPREPde hoy sigue la retención de su plan; esta configuración no la elimina antes de tiempo.