# Capture

Registra schermo, azioni e audio facoltativo nella cronologia dell’account.

Canonical page: https://beeuni.ai/docs/it/capture

Beeuni Capture è un’app di registrazione separata. Registra schermo, applicazione, titolo della finestra, URL, testo visibile e azioni di input. Se l’organizzazione abilita l’audio, salva anche suono e trascrizione. Puoi cercare e rivedere le registrazioni. Questa versione registra, carica e indicizza i dati; non trasforma automaticamente le azioni in competenze.

## Attivare Capture

Capture appartiene all’account dell’organizzazione, non a un progetto, ed è disattivato per impostazione predefinita. Con `capture.manage`, scegli l’organizzazione in `/capture` e attivalo. Proprietari e amministratori hanno questo permesso. Quando è disattivato, i dispositivi non possono accedere, caricare nuove registrazioni o ottenere nuove credenziali di caricamento.

## Installare Beeuni Capture

[Windows](/download/capture/windows) · [macOS](/download/capture/macos) · [Linux](/download/capture/linux)

1. Scarica e installa il pacchetto adatto al computer.
2. Apri Beeuni Capture e scegli **Accedi con Beeuni**. Confronta il codice nel browser e seleziona un’organizzazione con Capture attivo.
3. Su macOS, concedi i permessi necessari per registrazione schermo, accessibilità, monitoraggio input e microfono.

## Regole e accesso

In **Capture → Impostazioni**, scegli cosa registrare, intervallo, risoluzione, conservazione, pausa dell’organizzazione e avviso ai membri. L’audio è inizialmente disattivato. Le opzioni sperimentali di privacy consentono il mascheramento locale dei dati personali e l’esclusione di app e siti prima della registrazione.

Ogni membro vede i propri dispositivi e la propria cronologia. `capture.read_all` consente di leggere le registrazioni altrui; ogni accesso viene registrato nel log di audit. `capture.manage` consente di cambiare regole e revocare qualsiasi dispositivo. I dispositivi distribuiti in gruppo possono restare senza membro finché un amministratore non li associa.

## Agent e API

Un agent legge solo la cronologia della persona per cui agisce la sua sessione privata. Le sessioni condivise o automatiche non agiscono per una persona e ricevono `403 capture_no_human`.

Usa una chiave API dell’account o `beeuni.capture.account(accountId)` nel SDK TypeScript. Valgono gli stessi permessi dell’interfaccia web.

```bash
curl -s -H "Authorization: Bearer $BEEUNI_API_KEY" \
  "https://api.beeuni.ai/v1/accounts/$ACCOUNT/capture/search?q=invoice&limit=5"
```

[SDK](/docs/it/sdk/reference)

## Installazione su più computer

Gli amministratori creano un token in **Capture → Dispositivi → Installazione aziendale** e approvano i computer. Il token serve solo alla registrazione e non può leggere dati.

[Istruzioni di distribuzione](/docs/it/capture/rollout)

## Fermare e rimuovere dispositivi

Metti in pausa sul dispositivo oppure, come amministratore, per tutta l’organizzazione. Revocare un dispositivo invalida subito il suo token. Revocare un token di registrazione blocca solo nuove registrazioni. Disinstallare l’app non elimina immediatamente le vecchie registrazioni locali.