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.
Planes que lo incluyen
Sección titulada «Planes que lo incluyen»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.
Elija un tipo de destino
Sección titulada «Elija un tipo de destino»| Tipo | Úselo para | Lo que almacena RTC |
|---|---|---|
aws-role (preferible) | Un depósito de AWS S3 | Nada confidencial. RTC asume un rol de IAM que usted crea, con un ID externo. |
s3-compatible | Cloudflare R2, MinIO, Wasabi, Backblaze B2 o AWS con claves de acceso | Su 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.
Gestionar destinos
Sección titulada «Gestionar destinos»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 ruta | Credencial | Resultado |
|---|---|---|
GET /v1/storage/destinations | Sesión de la consola, o una clave con recordings:read | Los destinos, ordenados por antigüedad |
GET /v1/storage/destinations/{destinationId} | Sesión de la consola, o una clave con recordings:read | Un destino |
GET /v1/storage/aws-setup | Sesión de la consola | Su ID externo y las políticas de IAM que debe pegar (Rol de AWS) |
POST /v1/storage/destinations | Sesión de la consola | 201, el destino tras su escritura de prueba |
PATCH /v1/storage/destinations/{destinationId} | Sesión de la consola | Modifique la configuración, rote las claves o active o desactive la función |
POST /v1/storage/destinations/{destinationId}/test | Sesión de la consola | Ejecute de nuevo la prueba de escritura |
DELETE /v1/storage/destinations/{destinationId} | Sesión de la consola | { "id": "…", "deleted": true } |
GET /v1/recordings/{recordingId}/deliveries | recordings:read | Las entregas de la grabación (Realice los envíos) |
POST /v1/recordings/{recordingId}/redeliver | recordings:write | 202, vuelve a entregar la grabación |
DELETE /v1/recordings/{recordingId} | recordings:write | Envía la grabación a la Papelera (Eliminar una grabación) |
GET /v1/recordings?trashed=true | recordings:read | Las grabaciones en la Papelera |
POST /v1/recordings/{recordingId}/restore | recordings:write | Recupera la grabación de la Papelera |
POST /v1/recordings/{recordingId}/purge | recordings:write | Elimina la grabación de forma permanente de la Papelera |
Las credenciales nunca se devuelven. Las respuestas se envían con
Cache-Control: no-store.
| Campo | Ambos tipos | Notes |
|---|---|---|
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, kmsKeyId | aws-role | Su rol y, opcionalmente, su clave KMS para SSE-KMS |
provider, endpoint, forcePathStyle, accessKeyId, secretAccessKey | s3-compatible | forcePathStyle 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.
AWS S3 con un rol de IAM
Sección titulada «AWS S3 con un rol de IAM»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.
- Llame a
GET /v1/storage/aws-setup?bucket=<your-bucket>(añadapathTemplateykmsKeyArnsi los utiliza), o abra la misma configuración en la consola. - Cree un rol de IAM. Pegue el texto devuelto
trustPolicy: confía enprincipalArnsolo cuando la solicitud incluya suexternalId. - Asigne el devuelto
permissionsPolicy. Permites3:PutObjectys3:AbortMultipartUploaden su ruta,s3:DeleteObjectsolo en la carpeta de validación, ykms:GenerateDataKeyykms:Encrypten su clave KMS cuando ha indicado una. - Cree el destino con
type: "aws-role"y el rolroleArn:
{ "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.
Almacenamiento compatible con S3 con claves
Sección titulada «Almacenamiento compatible con S3 con claves»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.
endpointdebe 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 responde400ENDPOINT_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,
PATCHaccessKeyIdysecretAccessKeyen conjunto. - Cuando el almacenamiento de claves no está disponible, RTC responde
503CREDENTIALS_UNAVAILABLE; utilice un rol de AWS mientras tanto.
Prueba de validación de escritura
Sección titulada «Prueba de validación de escritura»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ódigo | Significado |
|---|---|
ROLE_ASSUME_DENIED | RTC no ha podido asumir el rol (política de confianza o ID externo) |
WRITE_DENIED | Se ha denegado la escritura |
BUCKET_NOT_FOUND | El depósito no existe |
WRONG_REGION | El depósito se encuentra en otra región |
INVALID_ACCESS_KEY, INVALID_SECRET_KEY | Se han rechazado las claves |
KMS_DENIED | La clave KMS rechazó el cifrado |
ENDPOINT_NOT_ALLOWED, ENDPOINT_NOT_FOUND, ENDPOINT_UNREACHABLE | El punto final ha sido rechazado, es desconocido o no responde |
DELIVERY_NOT_CONFIGURED | Los destinos de roles de AWS aún no están disponibles |
STORAGE_ERROR | Otro 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).
Plantillas de ruta
Sección titulada «Plantillas de ruta»La plantilla establece la clave de objeto de cada archivo. El valor por defecto es:
{project}/{yyyy}/{mm}/{dd}/{room}/{recording_id}/{file}| Variable | Valor |
|---|---|
{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.
Entrega
Sección titulada «Entrega»- 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 quetranscript.jsonytranscript.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_failedse 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.
Webhooks
Sección titulada «Webhooks»Suscríbase a su Puntos finales de webhook a estos eventos. Cada entrega de archivo envía su propio evento.
| Evento | data |
|---|---|
recording.delivered | recordingId, roomId, destinationId, artifact, trackId (para una pista), bucket, key, size, sha256, checksum, etag, deliveredAt |
recording.delivery_failed | recordingId, roomId, destinationId, artifact, trackId (para una pista), bucket, key, attempts, error (code, message) |
Seguir envíos
Sección titulada «Seguir envíos»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.
Reenviar
Sección titulada «Reenviar»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.
| HTTP | Código | Significado |
|---|---|---|
409 | RECORDING_NOT_READY | Solo un ready La grabación puede entregarse |
409 | NO_ACTIVE_DESTINATION | No hay ningún destino activo asociado a esta grabación |
404 | NO_ACTIVE_DESTINATION | Ningún destino activo tiene esto destinationId |
Eliminar una grabación
Sección titulada «Eliminar una grabación»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.
Enviarlo a la Papelera
Sección titulada «Enviarlo a la Papelera»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=trueMuestra 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.
purgeAtSe 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.purgeAtesnullmientras que la eliminación automática de la Papelera está desactivada.recording.deletedse envía.- Una grabación que aún se está ejecutando o procesando responde
409RECORDING_ACTIVE; deténgalo o espere.
Restáurelo
Sección titulada «Restáurelo»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.
Elimínelo de forma permanente
Sección titulada «Elimínelo de forma permanente»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.purgedse envía. - Repetir la solicitud es seguro: responde
202de nuevo mientras se ejecuta la eliminación, entonces200una 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
409RECORDING_NOT_IN_TRASH: envíelo primero a la Papelera.
Eliminación automática
Sección titulada «Eliminación automática»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.
Conservación
Sección titulada «Conservación»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.