

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Utilizzo della registrazione delle chiamate
<a name="sip-apps-call-record"></a>

Le azioni di registrazione delle chiamate per le applicazioni multimediali SIP consentono di creare soluzioni di registrazione e trascrizione post-chiamata per una varietà di usi. Ad esempio, è possibile registrare le chiamate all'assistenza clienti e utilizzarle per la formazione.

Le azioni di registrazione delle chiamate vengono utilizzate insieme alle applicazioni multimediali SIP. È inoltre possibile utilizzare le azioni su richiesta o in risposta a un evento SIP. 
+ Per avviare la registrazione su richiesta di una chiamata nell'applicazione multimediale SIP, è necessario utilizzare l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice_chime_UpdateSipMediaApplication.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice_chime_UpdateSipMediaApplication.html)API per richiamare l'applicazione e restituire l'azione. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartCallRecording.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartCallRecording.html) 
+ Per avviare la registrazione delle chiamate in risposta a un evento SIP, restituite l'`StartCallRecording`azione nell'applicazione. 

È possibile mettere in pausa e riprendere una registrazione in corso. Per mettere in pausa, usa l'azione. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_PauseCallRecording.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_PauseCallRecording.html) Per riprendere, usa l'azione`ResumeCallRecording`. Ogni volta che metti in pausa o riprendi una registrazione, l'azione acquisisce un tono che indica la pausa o la ripresa. Quando fai una pausa, l'azione registra il silenzio, che Amazon Chime SDK utilizza per tenere traccia della durata della pausa e includerla nella fattura. Puoi mettere in pausa e riprendere la registrazione tutte le volte che vuoi.

Per interrompere la registrazione delle chiamate, si ripristina l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StopCallRecording.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StopCallRecording.html)azione. Tuttavia, le registrazioni delle chiamate si interrompono automaticamente al termine della chiamata e in tal caso non è necessario restituire esplicitamente l'azione`StopCallRecording`. È possibile avviare e interrompere la registrazione una sola volta per una singola sessione di chiamata.

L'SDK Amazon Chime fornisce le registrazioni delle chiamate su un bucket Amazon S3 selezionato dall'utente. Il bucket deve appartenere al tuo account. AWS Una volta interrotta una chiamata, l'applicazione multimediale SIP invia la registrazione nella cartella specificata nel `Destination` parametro dell'[StartCallRecording](start-call-recording.md)azione. L'SDK Amazon Chime registra le chiamate in un formato WAV aperto. Le chiamate che registrano tracce in entrata e in uscita utilizzano la modalità stereo, con la traccia in entrata nel canale sinistro e la traccia in uscita sul canale destro. Se si registra solo la traccia in entrata o in uscita, il sistema utilizza la modalità mono.

**Nota**  
Le registrazioni effettuate utilizzando questa funzione possono essere soggette a leggi o regolamenti relativi alla registrazione delle comunicazioni elettroniche. È responsabilità dell'utente e degli utenti finali rispettare tutte le leggi applicabili in materia di registrazione, inclusa la corretta notifica a tutti i partecipanti a una sessione o comunicazione registrata che la sessione o la comunicazione è in corso di registrazione e l'ottenimento del loro consenso.

## Fatturazione per la registrazione delle chiamate
<a name="call-billing"></a>

L'SDK Amazon Chime ti fattura al minuto per il periodo in cui la registrazione delle chiamate è abilitata per una sessione di chiamata e tale tempo include tutte le pause. Ti viene fatturato l'utilizzo della registrazione delle chiamate una volta che la registrazione viene consegnata al tuo bucket Amazon S3.

# Registrazione di tracce audio
<a name="record-legs"></a>

Puoi registrare solo le tracce della chiamata in entrata o in uscita o entrambe le tracce di una chiamata.

Questa immagine mostra una tipica chiamata in arrivo con una sola gamba, o senza bridge. 

![\[Una chiamata in arrivo che comunica solo con un'applicazione multimediale SIP.\]](http://docs.aws.amazon.com/it_it/chime-sdk/latest/dg/images/call-record-sma-one-leg.png)


**La chiamata ha solo una parte con call-id-1. `callID`** La traccia `INCOMING` audio è l'audio inviato dal chiamante all'applicazione multimediale SIP. La traccia `OUTGOING` audio è l'audio trasmesso dall'applicazione multimediale SIP al chiamante. L'applicazione multimediale SIP specifica la `CallId` chiamata che si desidera registrare. Per registrare il partecipante che ha effettuato la chiamata, si specifica. `INCOMING` Per registrare il partecipante che risponde a una chiamata, si specifica. `OUTGOING` Per registrare entrambi i partecipanti, specificare. `BOTH`

Questa immagine mostra una tipica chiamata intermedia con due partecipanti.

![\[Una chiamata in arrivo che comunica con un'applicazione multimediale SIP e un secondo partecipante.\]](http://docs.aws.amazon.com/it_it/chime-sdk/latest/dg/images/call-record-sma-bridged.png)


****In questo esempio, la chiamata ha due fasi di chiamata, call-id-1 e call-id-2, e **call-id-1** viene collegato a **call-id-2**.**** In questo modo vengono create quattro tracce audio, i flussi audio in entrata e in uscita per entrambe le chiamate. IDs È possibile specificare la chiamata IDs e le tracce audio da registrare. Ad esempio, se si desidera registrare la traccia audio del partecipante chiamato, si registra la traccia `INCOMING` audio specificando **call-id-2** come e come traccia. `CallId` `INCOMING`

**Se desiderate registrare tutto ciò che il chiamante sente, registrate la traccia `OUTGOING` audio specificando call-id-1 come e come traccia.** `CallId` `OUTGOING` Se desideri registrare tutto l'audio che hai `Caller` detto e sentito, registri le tracce `BOTH` audio `call-id-1` specificandole come e come traccia. `CallId` `BOTH`

# Esempi di casi d'uso
<a name="recording-use-cases"></a>

Le applicazioni multimediali SIP forniscono azioni di registrazione delle chiamate come elementi costitutivi. Ti offrono la flessibilità necessaria per creare soluzioni di registrazione delle chiamate per i tuoi casi d'uso aziendali. I seguenti casi illustrano alcuni scenari di utilizzo comuni.

**Topics**
+ [Caso 1: registrazione di una chiamata con una sola gamba che prevede azioni SIP](#recording-case-1)
+ [Caso 2: registrazione selettiva dell'audio in una chiamata interconnessa](#recording-case-2)
+ [Caso 3: registrazione di più sessioni di chiamata](#recording-case-3)
+ [Caso 4: registrazione su richiesta con pausa e ripresa](#on-demand-pause-resume)

## Caso 1: registrazione di una chiamata con una sola gamba che prevede azioni SIP
<a name="recording-case-1"></a>

È possibile registrare un chiamante e qualsiasi audio generato dalle azioni dell'applicazione multimediale SIP, come le azioni and. [PlayAudio](play-audio.md) [PlayAudioAndGetDigits](play-audio-get-digits.md) Durante la registrazione, se un chiamante preme una cifra, la registrazione acquisisce il tono di quella cifra. Questo esempio utilizza l'`PlayAudioAndGetDigits`azione, ma la risposta vocale interattiva (IVR) può essere una serie complessa di azioni dell'applicazione multimediale SIP.

In questo esempio, l'applicazione multimediale SIP registra entrambe le tracce audio tra il chiamante e l'applicazione multimediale SIP stessa. La registrazione inizia quando viene stabilita la chiamata e si interrompe quando il chiamante riaggancia. La fatturazione inizia quando viene stabilita la chiamata e si interrompe quando il chiamante riaggancia.

![\[Diagramma di un'applicazione multimediale SIP che registra due tracce audio, in questo caso, tra un chiamante e l'app stessa.\]](http://docs.aws.amazon.com/it_it/chime-sdk/latest/dg/images/sma-recording-case-1.png)


## Caso 2: registrazione selettiva dell'audio in una chiamata interconnessa
<a name="recording-case-2"></a>

È possibile registrare selettivamente la traccia audio di un singolo partecipante alla chiamata. È possibile utilizzare questa funzione per abilitare selettivamente la registrazione delle chiamate solo per un partecipante specifico.

In questo esempio, l'applicazione multimediale SIP registra le tracce audio in entrata tra la parte chiamata e l'applicazione multimediale SIP stessa specificando **call-id-2** come e come traccia. `CallId` `INCOMING` La registrazione della chiamata inizia quando il chiamante viene collegato alla parte chiamata, e questo è anche il momento in cui inizia la fatturazione. La registrazione si interrompe quando la persona chiamata riaggancia, e in quel momento termina anche la fatturazione. Questa registrazione contiene solo la traccia audio della persona chiamata. 

![\[Diagramma di un'applicazione multimediale SIP che registra selettivamente una traccia.\]](http://docs.aws.amazon.com/it_it/chime-sdk/latest/dg/images/sma-recording-case-2.png)


## Caso 3: registrazione di più sessioni di chiamata
<a name="recording-case-3"></a>

È possibile registrare più sessioni di chiamata. Ad esempio, supponiamo di collegare una chiamata a un partecipante. Quando quel partecipante riaggancia, la telefonata viene trasferita a un altro partecipante. È possibile abilitare la registrazione delle chiamate per tutte e tre le fasi di chiamata. 

Questo esempio mostra tre file di registrazione separati. La registrazione della prima sessione di chiamata registra la conversazione tra il chiamante, l'applicazione e i due partecipanti che hanno partecipato alla chiamata. La registrazione per la seconda fase della chiamata cattura la conversazione tra il chiamante e il primo partecipante. La registrazione per la terza fase di chiamata cattura la conversazione tra il chiamante e il secondo partecipante. 

In questo caso vengono create tre fasi di chiamata e la fatturazione si applica all'inizio e alla fine di ciascuna fase di chiamata. In altre parole, il sistema invia tre registrazioni al tuo bucket S3 e ti viene fatturata ciascuna. 

![\[Diagramma di un'applicazione multimediale SIP che registra più fasi di chiamata.\]](http://docs.aws.amazon.com/it_it/chime-sdk/latest/dg/images/sma-recording-case-3.png)


## Caso 4: registrazione su richiesta con pausa e ripresa
<a name="on-demand-pause-resume"></a>

È possibile avviare, interrompere, mettere in pausa e riprendere la registrazione delle chiamate su richiesta utilizzando l'API. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_UpdateSipMediaApplicationCall.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_UpdateSipMediaApplicationCall.html) È possibile creare un'applicazione client che richiami l'`UpdateSipMediaApplicationCall`API e richiami l'applicazione multimediale SIP per restituire azioni di registrazione delle chiamate.

Gli utenti finali utilizzano l'applicazione client per controllare la registrazione delle chiamate. Ad esempio, in un call center, un agente utilizzerebbe un'applicazione client desktop per attivare azioni di registrazione delle chiamate su richiesta. Nell'esempio del call center, l'agente potrebbe chiedere al chiamante l'autorizzazione per registrare la telefonata e può fare clic nell'applicazione client per avviare la registrazione una volta che il chiamante acconsente. In un altro esempio, il chiamante potrebbe dover fornire informazioni come un numero di previdenza sociale (SSN). Tuttavia, la politica del call center richiede che l'agente non registri informazioni come il SSN del cliente. L'agente può fare clic sull'applicazione per sospendere la registrazione mentre il cliente fornisce le informazioni, quindi fare nuovamente clic per riprendere la registrazione. Una volta che l'agente ha gestito la richiesta del chiamante, fa clic sull'applicazione per interrompere la registrazione e interrompe la chiamata.

In questo caso d'uso, l'applicazione multimediale SIP registra le tracce audio tra il chiamante e l'applicazione multimediale SIP. Poiché la `call-id-1` gamba è collegata alla `call-id-2` gamba, il sistema registra l'audio su entrambe le gambe, chiamante e chiamata. La registrazione e la fatturazione iniziano quando l'`UpdateSipMediaApplicationCall`API richiama l'azione. `StartCallRecording` La registrazione e la fatturazione si interrompono quando l'`UpdateSipMediaApplicationCall`API richiama l'azione. `StopCallRecording` Ti ricordiamo che mettere in pausa la registrazione non ne modifica la durata e tutte le pause ti verranno addebitate. 

![\[Diagramma di un'applicazione multimediale SIP che registra su richiesta con registrazione sospesa e ripresa.\]](http://docs.aws.amazon.com/it_it/chime-sdk/latest/dg/images/sma-recording-on-demand.png)


# Azioni di registrazione delle chiamate per applicazioni multimediali SIP
<a name="use-recording-apis"></a>

È possibile specificare diverse azioni di registrazione delle chiamate in risposta dalla AWS Lambda funzione dell'applicazione multimediale SIP. I seguenti argomenti forniscono codice di esempio e spiegano come utilizzare le azioni.

**Topics**
+ [StartCallRecording](start-call-recording.md)
+ [StopCallRecording](stop-call-recording.md)
+ [PauseCallRecording](pause-call-recording.md)
+ [ResumeCallRecording](resume-call-recording.md)

# StartCallRecording
<a name="start-call-recording"></a>

L'`StartCallRecording`azione avvia la registrazione di una sessione di chiamata. Si avvia la registrazione delle chiamate nelle applicazioni multimediali SIP, su richiesta o in risposta a un evento SIP.
+ Per avviare la registrazione su richiesta di una chiamata, si utilizza l'`UpdateSipMediaApplication`API per richiamare l'applicazione e restituire l'azione. `StartCallRecording`
+ Per avviare la registrazione delle chiamate in risposta a un evento SIP, restituite l'`StartCallRecording`azione nell'applicazione. 

È possibile specificare se si desidera registrare la traccia audio per la tappa in entrata, la tratta in uscita o entrambe. Le sezioni seguenti spiegano come utilizzare l'azione`StartCallRecording`.

**Nota**  
Le registrazioni effettuate utilizzando questa funzione possono essere soggette a leggi o regolamenti relativi alla registrazione delle comunicazioni elettroniche. È responsabilità dell'utente e degli utenti finali rispettare tutte le leggi applicabili in materia di registrazione, inclusa la corretta notifica a tutti i partecipanti a una sessione o comunicazione registrata che la sessione o la comunicazione è in corso di registrazione e l'ottenimento del loro consenso.

**Topics**
+ [Richiedere un'azione StartCallRecording](#request-start)
+ [Specificare una destinazione di registrazione](#recording-destination)
+ [Concessione delle autorizzazioni per i bucket Amazon S3](#grant-s3-perms)
+ [Azione, risposta riuscita](#action-successful)
+ [Azione, errore, risposta.](#action-error)

## Richiedere un'azione StartCallRecording
<a name="request-start"></a>

L'esempio seguente mostra come richiedere l'`StartCallRecording`azione per `BOTH` le tracce.

```
{
    "SchemaVersion": "1.0",
    "Actions": [
        {
            "Type": "StartCallRecording",
            "Parameters":
            {
                "CallId": "call-id-1",
                "Track": "BOTH",
                "Destination":
                {
                    "Type": "S3",
                    "Location": "valid-bucket-name-and-optional-prefix"
                }
            }
        }
    ]
}
```

**CallId**  
*Descrizione*: `CallId` del partecipante all'`CallDetails`invocazione della AWS Lambda funzione  
*Valori consentiti*: un ID di chiamata valido  
*Obbligatorio*: sì  
*Valore predefinito* - nessuno

**Traccia**  
*Descrizione*: audio `Track` della registrazione della chiamata.  
*Valori consentiti*: `BOTH``INCOMING`, o `OUTGOING`  
*Obbligatorio*: Sì  
*Valore predefinito* - nessuno

**Destinazione. Tipo**  
*Descrizione:* tipo di destinazione. È consentito solo Amazon S3.  
*Valori consentiti*: Amazon S3  
*Obbligatorio*: Sì  
*Valore predefinito* - nessuno

**Destinazione. Ubicazione**  
*Descrizione*: un bucket Amazon S3 valido e un prefisso chiave Amazon S3 opzionale. Il bucket deve disporre delle autorizzazioni per il principale servizio Amazon Chime SDK Voice Connector, voiceconnector.chime.amazonaws.com.  
*Valori consentiti*: un percorso Amazon S3 valido per il quale Amazon Chime SDK dispone delle autorizzazioni per le azioni e. `s3:PutObject` `s3:PutObjectAcl`  
*Obbligatorio*: sì  
*Valore predefinito* - nessuno

## Specificare una destinazione di registrazione
<a name="recording-destination"></a>

L'SDK Amazon Chime fornisce le registrazioni delle chiamate nel tuo bucket Amazon S3. Il bucket deve appartenere al tuo account. AWS Specificate la posizione del bucket nel `Destination` parametro dell'`StartCallRecording`azione. Il `Type` campo nel `Destination` parametro deve essere`S3`. Il `Location` campo è composto dal tuo bucket Amazon S3, più un prefisso object-key opzionale in cui viene consegnata la registrazione delle chiamate. 

L'applicazione multimediale SIP utilizza la data e l'ora specificate`Location`, la data e l'ora della chiamata, l'ID della transazione e l'ID della chiamata per formattare la chiave oggetto Amazon S3. La risposta `StartCallRecording` all'azione restituisce la chiave dell'oggetto Amazon S3 completa.

Quando fornisci solo il bucket Amazon S3 `Location` sul campo, l'applicazione multimediale SIP aggiunge un prefisso predefinito `Amazon-Chime-SMA-Call-Recordings` al percorso Amazon S3. L'applicazione multimediale SIP aggiunge anche l'anno, il mese e il giorno dell'ora di inizio della chiamata per facilitare l'organizzazione delle registrazioni. L'esempio seguente mostra il formato generale di un percorso Amazon S3 con il prefisso predefinito. Questo esempio utilizza `myRecordingBucket` come valore. `Location`

```
myRecordingBucket/Amazon-Chime-SMA-Call-Recordings/2019/03/01/2019–03–01–17–10–00–010_c4640e3b–1478–40fb-8e38–6f6213adf70b_7ab7748e–b47d–4620-ae2c–152617d3333c.wav
```

L'esempio seguente mostra i dati rappresentati nel percorso di registrazione delle chiamate Amazon S3.

```
s3Bucket/Amazon-Chime-SMA-Call-Recordings/year/month/date/year-month-date-hour-minute-second-millisecond_transactionId_callId.wav
```

Quando fornisci il bucket Amazon S3 e il prefisso della chiave oggetto `Location` sul campo, l'applicazione multimediale SIP utilizza il prefisso della chiave oggetto nel percorso Amazon S3 di destinazione anziché il prefisso predefinito. L'esempio seguente mostra il formato generale di un percorso di registrazione delle chiamate in Amazon S3 con il tuo prefisso. Ad esempio, puoi specificare myRecordingBucket /TechnicalSupport/English come. `Location` 

```
myRecordingBucket/technicalSupport/english/2019/03/01/2019–03–01–17–10–00–010_c4640e3b1478–40fb–8e38-6f6213adf70b_7ab7748e–b47d–4620–ae2c–152617d3333c.wav
```

L'esempio seguente mostra i dati nel percorso Amazon S3.

```
s3Bucket/yourObjectKeyPrefix/year/month/date/year-month-date-hour-minute-second-millisecond_transactionId_callId.wav
```

La registrazione inviata al tuo bucket Amazon S3 contiene [metadati di oggetti Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingMetadata.html) aggiuntivi relativi alla sessione di chiamata. La tabella seguente elenca i metadati degli oggetti Amazon S3 supportati.


| Nome | Description | 
| --- | --- | 
| id della transazione | ID della transazione della telefonata | 
| ID di chiamata | CallId del partecipante all'invocazione CallDetails della funzione AWS Lambda  | 
| durata della registrazione | Durata della registrazione delle chiamate in secondi | 
| recording-audio-file-format | Formato di file audio per la registrazione delle chiamate rappresentato come tipo di supporto Internet | 

## Concessione delle autorizzazioni per i bucket Amazon S3
<a name="grant-s3-perms"></a>

Il bucket Amazon S3 di destinazione deve appartenere allo stesso AWS account dell'applicazione. Inoltre, l'azione deve concedere `s3:PutObject` l'`s3:PutObjectAcl`autorizzazione al responsabile del servizio Amazon Chime SDK Voice Connector,. `voiceconnector.chime.amazonaws.com` L'esempio seguente concede l'autorizzazione appropriata. 

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "SIP media applicationRead",
            "Effect": "Allow",
            "Principal": {
                "Service": "voiceconnector.chime.amazonaws.com"
            },
            "Action": [                
                "s3:PutObject",
                "s3:PutObjectAcl"
            ],
            "Resource": "arn:aws:s3:::bucket-name/*",
	    "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "123456789012"
                }
            }
        }
    ]
}
```

------

Il servizio audio PSTN legge e scrive nel bucket S3 per conto dell'applicazione multimediale Sip. Per evitare il [confuso problema secondario](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html), puoi limitare le autorizzazioni del bucket S3 a una singola applicazione multimediale SIP.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "SIP media applicationRead",
            "Effect": "Allow",
            "Principal": {
                "Service": "voiceconnector.chime.amazonaws.com"
            },
            "Action": [                
                "s3:PutObject",
                "s3:PutObjectAcl"
            ],
            "Resource": "arn:aws:s3:::bucket-name/*",
	    "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "111122223333",
                    "aws:SourceArn": "arn:aws:chime:us-east-1:111122223333:sma/sip-media-application-id"
                }
            }
        }
    ]
}
```

------

## Azione, risposta riuscita
<a name="action-successful"></a>

Quando la registrazione della chiamata viene avviata correttamente durante una sessione di chiamata, l'applicazione multimediale SIP richiama una AWS Lambda funzione con il `ACTION_SUCCESSFUL` tipo di evento. La posizione della registrazione della chiamata viene restituita nella risposta. 

```
{
    "SchemaVersion": "1.0",
    "Sequence": INTEGER,
    "InvocationEventType": "ACTION_SUCCESSFUL",
    "ActionData": {
        "Type" : "StartCallRecording",
        "Parameters": {
            "CallId": "call-id-1",
            "Track": "BOTH",
            "Destination": {
                "Type": "S3",
                "Location": "valid-bucket-name"
            }
        }
        "CallRecordingDestination": {
            "Type": "S3",
            "Location": "call-recording-bucket-and-key"
        }
    }
    "CallDetails": {
        ...
    }
}
```

## Azione, errore, risposta.
<a name="action-error"></a>

In caso di errori di convalida, l'applicazione multimediale SIP richiama la AWS Lambda funzione con il messaggio di errore appropriato. La tabella seguente elenca i messaggi di errore.




| Errore | Messaggio | Motivo | 
| --- | --- | --- | 
| `InvalidActionParameter` | `CallId`il parametro per l'azione non è valido | Qualsiasi parametro non è valido. | 
| `SystemException` | Errore di sistema durante l'esecuzione di un'azione. | Si è verificato un altro tipo di errore di sistema durante l'esecuzione di un'azione. | 

Quando l'azione non riesce a registrare i file multimediali su una sessione di chiamata, l'applicazione multimediale SIP richiama una AWS Lambda funzione con il `ActionFailed` tipo di evento. 

L'esempio seguente mostra una tipica risposta di errore.

```
{
    "SchemaVersion": "1.0",
    "Sequence": 5,
    "InvocationEventType": "ACTION_FAILED",
    "ActionData": {
        "Type" : "StartCallRecording",
        "Parameters": {
            "CallId": "call-id-1",
            "Track": "BOTH",
            "Destination": {
                "Type": "S3",
                "Location": "valid-bucket-name"
            }
        }
        "Error": "NoAccessToDestination: Error while accessing destination"
    }
    "CallDetails": {
        ...
    }
}
```

Vedi un esempio funzionante su GitHub: [https://github.com/aws-samples/amazon-chime-sma-on-demand-recording](https://github.com/aws-samples/amazon-chime-sma-on-demand-recording)

# StopCallRecording
<a name="stop-call-recording"></a>

L'`StopCallRecording`azione interrompe la registrazione di una chiamata. La registrazione si interrompe automaticamente al termine di una chiamata e l'applicazione non deve restituire esplicitamente l'`StopCallRecording`azione. Una volta interrotta la registrazione di una chiamata, non può essere riavviata e la registrazione viene recapitata alla destinazione specificata nell'`StartCallRecording`azione. 

L'esempio seguente interrompe la registrazione per la `call-id-1` sessione di chiamata. 

```
{
    "SchemaVersion": "1.0",
    "Actions":[
        {
            "Type": "StopCallRecording",
            "Parameters": {
                "CallId": "call-id-1"
            }
        }
    ]
}
```

**CallId**  
*Descrizione*: `CallId` del partecipante all'`CallDetails`invocazione della AWS Lambda funzione  
*Valori consentiti*: un ID di chiamata valido  
*Obbligatorio*: sì  
*Valore predefinito* - nessuno

Vedi un esempio funzionante su GitHub: [https://github.com/aws-samples/amazon-chime-sma-on-demand-recording](https://github.com/aws-samples/amazon-chime-sma-on-demand-recording)

# PauseCallRecording
<a name="pause-call-recording"></a>

L'`PauseCallRecording`azione sospende la registrazione di una sessione di chiamata. Ogni volta che si mette in pausa una registrazione, la registrazione acquisisce un tono che indica la pausa. Quando si mette in pausa, la registrazione continua, ma cattura solo il silenzio. La messa in pausa della registrazione non influisce sulla durata totale della registrazione. È possibile mettere in pausa e riprendere la registrazione tutte le volte che è necessario.

L'esempio seguente mette in pausa la registrazione. 

```
{
    "SchemaVersion": "1.0",
    "Actions":[
        {
            "Type": "PauseCallRecording",
            "Parameters": {
                "CallId": "call-id-1"
            }
        }
    ]
}
```

**CallId**  
*Descrizione*: `CallId` del partecipante all'`CallDetails`invocazione della funzione AWS Lambda   
*Valori consentiti*: un ID di chiamata valido  
*Obbligatorio*: sì  
*Valore predefinito* - nessuno

Vedi un esempio funzionante su GitHub: [https://github.com/aws-samples/amazon-chime-sma-on-demand-recording](https://github.com/aws-samples/amazon-chime-sma-on-demand-recording)

# ResumeCallRecording
<a name="resume-call-recording"></a>

L'`ResumeCallRecording`azione riprende la registrazione di una sessione di chiamata. Prima del riavvio della registrazione, viene riprodotto un breve tono. È possibile mettere in pausa e riprendere una registrazione più volte per tutta la durata della sessione di chiamata. 

L'esempio seguente riprende la registrazione. 

```
{
    "SchemaVersion": "1.0",
    "Actions":[
        {
            "Type": "ResumeCallRecording",
            "Parameters": {
                "CallId": "call-id-1"
            }
        }
    ]
}
```

**CallId**  
*Descrizione*: `CallId` del partecipante all'invocazione `CallDetails` della funzione AWS Lambda   
*Valori consentiti*: un ID di chiamata valido  
*Obbligatorio*: sì  
*Valore predefinito* - nessuno

Vedi un esempio funzionante su GitHub: [https://github.com/aws-samples/amazon-chime-sma-on-demand-recording](https://github.com/aws-samples/amazon-chime-sma-on-demand-recording)