

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Utilisation de l'enregistrement des appels
<a name="sip-apps-call-record"></a>

Les actions d'enregistrement d'appels pour les applications multimédia SIP vous permettent de créer des solutions d'enregistrement d'appels et de transcription post-appel pour une variété d'utilisations. Par exemple, vous pouvez enregistrer les appels du service client et les utiliser à des fins de formation.

Vous utilisez les actions d'enregistrement des appels de concert avec vos applications multimédia SIP. Vous pouvez également utiliser les actions à la demande ou en réponse à un événement SIP. 
+ Pour démarrer l'enregistrement à la demande d'un appel dans votre application multimédia SIP, vous utilisez 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 pour appeler votre application et renvoyer l'[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)action. 
+ Pour démarrer l'enregistrement des appels en réponse à un événement SIP, vous devez renvoyer l'`StartCallRecording`action dans votre application. 

Vous pouvez suspendre et reprendre un enregistrement en cours. Pour faire une pause, utilisez l'[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)action. Pour reprendre, utilisez l'`ResumeCallRecording`action. Chaque fois que vous interrompez ou reprenez un enregistrement, l'action capte une tonalité indiquant la pause ou la reprise. Lorsque vous faites une pause, l'action enregistre le silence, que le SDK Amazon Chime utilise pour suivre la durée de la pause et inclure les pauses dans votre facture. Vous pouvez suspendre et reprendre l'enregistrement aussi souvent que nécessaire.

Pour arrêter l'enregistrement des appels, vous devez retourner à 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)action. Cependant, les enregistrements d'appels s'arrêtent automatiquement lorsque l'appel s'arrête, et dans ce cas, il n'est pas nécessaire de renvoyer explicitement l'`StopCallRecording`action. Vous ne pouvez démarrer et arrêter l'enregistrement qu'une seule fois pour un cycle d'appel individuel.

Le SDK Amazon Chime fournit les enregistrements d'appels vers un compartiment Amazon S3 que vous sélectionnez. Le bucket doit appartenir à votre AWS compte. Une fois qu'un appel s'arrête, l'application multimédia SIP envoie l'enregistrement dans le dossier spécifié dans le `Destination` paramètre de l'[StartCallRecording](start-call-recording.md)action. Le SDK Amazon Chime enregistre les appels dans un format WAV ouvert. Les appels qui enregistrent des pistes entrantes et sortantes utilisent le mode stéréo, la piste entrante étant sur le canal gauche et la piste sortante sur le canal droit. Si vous enregistrez uniquement la piste entrante ou sortante, le système utilise le mode mono.

**Note**  
Les enregistrements réalisés à l'aide de cette fonctionnalité peuvent être soumis aux lois ou réglementations relatives à l'enregistrement des communications électroniques. Il est de votre responsabilité et de celle de vos utilisateurs finaux de respecter toutes les lois applicables concernant l'enregistrement, notamment d'informer correctement tous les participants à une session ou à une communication enregistrée que la session ou la communication est enregistrée, et d'obtenir leur consentement.

## Facturation de l'enregistrement des appels
<a name="call-billing"></a>

Le SDK Amazon Chime vous facture à la minute la durée pendant laquelle l'enregistrement des appels est activé pour un segment d'appel, et cette durée inclut toutes les pauses. L'utilisation de l'enregistrement des appels vous est facturée une fois que l'enregistrement des appels est envoyé à votre compartiment Amazon S3.

# Enregistrement de pistes audio
<a name="record-legs"></a>

Vous pouvez enregistrer uniquement les pistes d'appel entrant ou sortant, ou les deux pistes d'un appel.

Cette image montre un appel entrant unijambiste classique ou non ponté. 

![\[Appel entrant qui communique uniquement avec une application multimédia SIP.\]](http://docs.aws.amazon.com/fr_fr/chime-sdk/latest/dg/images/call-record-sma-one-leg.png)


L'appel n'a qu'une seule étape avec un identifiant `callID` de **call-id-1**. La piste `INCOMING` audio est le son transmis par l'appelant à l'application multimédia SIP. La piste `OUTGOING` audio est le son envoyé par l'application multimédia SIP à l'appelant. Votre application multimédia SIP indique `CallId` l'appel que vous souhaitez enregistrer. Pour enregistrer le participant qui a passé l'appel, vous devez spécifier`INCOMING`. Pour enregistrer le participant qui répond à un appel, vous devez spécifier`OUTGOING`. Pour enregistrer les deux participants, spécifiez`BOTH`.

Cette image montre un appel ponté typique avec deux participants.

![\[Appel entrant qui communique avec une application multimédia SIP et un deuxième participant.\]](http://docs.aws.amazon.com/fr_fr/chime-sdk/latest/dg/images/call-record-sma-bridged.png)


****Dans cet exemple, l'appel comporte deux segments d'appel, call-id-1 et **call-id-2, et call-id-1** **est relié à call-id-2**.**** Cela crée quatre pistes audio, les flux audio entrants et sortants pour les deux appels IDs. Vous pouvez spécifier les pistes audio IDs et les appels à enregistrer. Par exemple, si vous souhaitez enregistrer la piste audio du participant appelé, vous devez l'`INCOMING`enregistrer en spécifiant **call-id-2** comme piste `CallId` et `INCOMING` comme piste.

Si vous souhaitez enregistrer tout ce que l'appelant entend, vous devez enregistrer la piste `OUTGOING` audio en spécifiant **call-id-1** comme piste `CallId` et `OUTGOING` comme piste. Si vous souhaitez enregistrer tout le son qu'ils ont `Caller` dit et entendu, vous devez enregistrer les pistes `BOTH` audio en spécifiant `call-id-1` « `CallId` et » `BOTH` comme piste.

# Exemples de cas d'utilisation
<a name="recording-use-cases"></a>

Les applications multimédia SIP fournissent des actions d'enregistrement d'appels comme éléments de base. Ils vous offrent la flexibilité nécessaire pour créer des solutions d'enregistrement des appels adaptées à vos cas d'utilisation professionnels. Les cas suivants illustrent certains scénarios d'utilisation courants.

**Topics**
+ [Cas 1 : enregistrement d'un appel unijambiste impliquant des actions SIP](#recording-case-1)
+ [Cas 2 : enregistrement audio sélectif lors d'un appel ponté](#recording-case-2)
+ [Cas 3 : enregistrement de plusieurs étapes d'appel](#recording-case-3)
+ [Cas 4 : enregistrement à la demande avec pause et reprise](#on-demand-pause-resume)

## Cas 1 : enregistrement d'un appel unijambiste impliquant des actions SIP
<a name="recording-case-1"></a>

Vous pouvez enregistrer un appelant et tout son généré par les actions de l'application multimédia SIP, telles que les [PlayAudioAndGetDigits](play-audio-get-digits.md) actions [PlayAudio](play-audio.md) et. Pendant l'enregistrement, si un appelant appuie sur un chiffre, l'enregistrement capture la tonalité de ce chiffre. Cet exemple utilise l'`PlayAudioAndGetDigits`action, mais la réponse vocale interactive (IVR) peut être une série complexe d'actions d'applications multimédia SIP.

Dans cet exemple, l'application multimédia SIP enregistre les deux pistes audio entre l'appelant et l'application multimédia SIP elle-même. L'enregistrement commence lorsque l'appel est établi et s'arrête lorsque l'appelant raccroche. La facturation commence lorsque l'appel est établi et s'arrête lorsque l'appelant raccroche.

![\[Schéma d'une application multimédia SIP enregistrant deux pistes audio, dans ce cas, entre un appelant et l'application elle-même.\]](http://docs.aws.amazon.com/fr_fr/chime-sdk/latest/dg/images/sma-recording-case-1.png)


## Cas 2 : enregistrement audio sélectif lors d'un appel ponté
<a name="recording-case-2"></a>

Vous pouvez enregistrer de manière sélective la piste audio d'un seul participant à un appel. Vous pouvez utiliser cette fonctionnalité pour activer de manière sélective l'enregistrement des appels uniquement pour un participant spécifique.

Dans cet exemple, l'application multimédia SIP enregistre les pistes audio entrantes entre l'appelé et l'application multimédia SIP elle-même en spécifiant **call-id-2** comme piste `CallId` et `INCOMING` comme piste. L'enregistrement des appels commence lorsque l'appelant est relié à l'appelé, et c'est également à ce moment-là que la facturation commence. L'enregistrement s'arrête lorsque l'appelé raccroche, et c'est également à ce moment-là que la facturation prend fin. Cet enregistrement contient uniquement la piste audio de l'appelé. 

![\[Schéma d'une application multimédia SIP enregistrant sélectivement une piste.\]](http://docs.aws.amazon.com/fr_fr/chime-sdk/latest/dg/images/sma-recording-case-2.png)


## Cas 3 : enregistrement de plusieurs étapes d'appel
<a name="recording-case-3"></a>

Vous pouvez enregistrer plusieurs étapes d'appel. Imaginons, par exemple, que vous reliez un appel à un participant. Lorsque ce participant raccroche, l'appel téléphonique est transféré à un autre participant. Vous pouvez activer l'enregistrement des appels pour les trois étapes d'appel. 

Cet exemple montre trois fichiers d'enregistrement distincts. L'enregistrement de la première partie de l'appel capture la conversation entre l'appelant, votre application et les deux participants qui ont participé à l'appel. L'enregistrement du deuxième segment d'appel capture la conversation entre l'appelant et le premier participant. L'enregistrement du troisième segment d'appel capture la conversation entre l'appelant et le deuxième participant. 

Ce cas crée trois segments d'appel, et la facturation s'applique au début et à la fin de chaque segment d'appel. En d'autres termes, le système fournit trois enregistrements à votre compartiment S3, et chacun vous est facturé. 

![\[Schéma d'une application multimédia SIP enregistrant plusieurs étapes d'appel.\]](http://docs.aws.amazon.com/fr_fr/chime-sdk/latest/dg/images/sma-recording-case-3.png)


## Cas 4 : enregistrement à la demande avec pause et reprise
<a name="on-demand-pause-resume"></a>

Vous pouvez démarrer, arrêter, suspendre et reprendre l'enregistrement des appels à la demande à l'aide de l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_UpdateSipMediaApplicationCall.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_UpdateSipMediaApplicationCall.html)API. Vous pouvez créer une application client qui appelle l'`UpdateSipMediaApplicationCall`API et appelle votre application multimédia SIP pour renvoyer les actions d'enregistrement des appels.

Vos utilisateurs finaux utilisent l'application cliente pour contrôler l'enregistrement des appels. Par exemple, dans un centre d'appels, un agent utiliserait une application client de bureau pour déclencher des actions d'enregistrement d'appels à la demande. Dans l'exemple du centre d'appels, l'agent peut demander à l'appelant l'autorisation d'enregistrer l'appel téléphonique, et il peut cliquer dans l'application cliente pour démarrer l'enregistrement une fois que l'appelant est d'accord. Dans un autre exemple, l'appelant peut avoir besoin de fournir des informations telles qu'un numéro de sécurité sociale (SSN). Cependant, la politique du centre d'appels exige que l'agent n'enregistre pas d'informations telles que le SSN d'un client. L'agent peut cliquer sur l'application pour suspendre l'enregistrement pendant que le client fournit les informations, puis cliquer à nouveau pour reprendre l'enregistrement. Une fois que l'agent a traité la demande de l'appelant, il clique sur l'application pour arrêter l'enregistrement et raccroche l'appel.

Dans ce cas d'utilisation, l'application multimédia SIP enregistre les pistes audio entre l'appelant et l'application multimédia SIP. Comme la `call-id-1` jambe est attachée à la `call-id-2` jambe, le système enregistre le son sur les deux jambes, celui de l'appelant et celui de l'appelant. L'enregistrement et la facturation commencent lorsque l'`UpdateSipMediaApplicationCall`API appelle l'`StartCallRecording`action. L'enregistrement et la facturation s'arrêtent lorsque l'`UpdateSipMediaApplicationCall`API appelle l'`StopCallRecording`action. Pour rappel, la mise en pause de l'enregistrement ne modifie pas sa durée et toutes les pauses vous sont facturées. 

![\[Schéma d'une application multimédia SIP enregistrant à la demande avec enregistrement suspendu et repris.\]](http://docs.aws.amazon.com/fr_fr/chime-sdk/latest/dg/images/sma-recording-on-demand.png)


# Actions d'enregistrement d'appels pour les applications multimédia SIP
<a name="use-recording-apis"></a>

Vous pouvez spécifier différentes actions d'enregistrement d'appels dans une réponse à partir de la AWS Lambda fonction de votre application multimédia SIP. Les rubriques suivantes fournissent des exemples de code et expliquent comment utiliser les actions.

**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`action lance l'enregistrement d'un segment d'appel. Vous démarrez l'enregistrement des appels dans vos applications multimédia SIP, soit à la demande, soit en réponse à un événement SIP.
+ Pour démarrer l'enregistrement à la demande d'un appel, vous utilisez l'`UpdateSipMediaApplication`API pour appeler votre application et renvoyer l'`StartCallRecording`action.
+ Pour démarrer l'enregistrement des appels en réponse à un événement SIP, vous devez renvoyer l'`StartCallRecording`action dans votre application. 

Vous spécifiez si vous souhaitez enregistrer la piste audio de l'étape entrante, de la partie sortante ou des deux. Les sections suivantes expliquent comment utiliser cette `StartCallRecording` action.

**Note**  
Les enregistrements réalisés à l'aide de cette fonctionnalité peuvent être soumis aux lois ou réglementations relatives à l'enregistrement des communications électroniques. Il est de votre responsabilité et de celle de vos utilisateurs finaux de respecter toutes les lois applicables concernant l'enregistrement, notamment d'informer correctement tous les participants à une session ou à une communication enregistrée que la session ou la communication est enregistrée, et d'obtenir leur consentement.

**Topics**
+ [Demander une StartCallRecording action](#request-start)
+ [Spécification d'une destination d'enregistrement](#recording-destination)
+ [Octroi d'autorisations de compartiment Amazon S3](#grant-s3-perms)
+ [Action, réponse réussie](#action-successful)
+ [Réponse à une erreur d'action](#action-error)

## Demander une StartCallRecording action
<a name="request-start"></a>

L'exemple suivant montre comment demander l'`StartCallRecording`action pour les `BOTH` pistes.

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

**CallId**  
*Description* — `CallId` du participant à l'`CallDetails`invocation de la AWS Lambda fonction  
*Valeurs autorisées* : un identifiant d'appel valide  
*Obligatoire* — Oui  
*Valeur par défaut* – Aucune

**Piste**  
*Description* — Audio `Track` de l'enregistrement de l'appel.  
*Valeurs autorisées* — `BOTH``INCOMING`, ou `OUTGOING`  
*Obligatoire* — Oui  
*Valeur par défaut* – Aucune

**Type de destination**  
*Description* — Type de destination. Seul Amazon S3 est autorisé.  
*Valeurs autorisées* — Amazon S3  
*Obligatoire* — Oui  
*Valeur par défaut* – Aucune

**Destination. Emplacement**  
*Description* — Un compartiment Amazon S3 valide et un préfixe de clé Amazon S3 facultatif. Le bucket doit disposer d'autorisations pour accéder au principal service Amazon Chime SDK Voice Connector, voiceconnector.chime.amazonaws.com.  
*Valeurs autorisées* : chemin Amazon S3 valide pour lequel le SDK Amazon Chime dispose des autorisations relatives aux actions et. `s3:PutObject` `s3:PutObjectAcl`  
*Obligatoire* — Oui  
*Valeur par défaut* – Aucune

## Spécification d'une destination d'enregistrement
<a name="recording-destination"></a>

Le SDK Amazon Chime fournit les enregistrements d'appels à votre compartiment Amazon S3. Le bucket doit appartenir à votre AWS compte. Vous spécifiez l'emplacement du compartiment dans le `Destination` paramètre de l'`StartCallRecording`action. Le `Type` champ du `Destination` paramètre doit être`S3`. Le `Location` champ comprend votre compartiment Amazon S3, plus un préfixe de clé d'objet facultatif dans lequel l'enregistrement des appels est transmis. 

L'application multimédia SIP utilise la date et l'heure spécifiées`Location`, la date et l'heure du segment d'appel, l'ID de transaction et l'ID d'appel pour formater la clé d'objet Amazon S3. La réponse à l'`StartCallRecording`action renvoie la clé complète de l'objet Amazon S3.

Lorsque vous fournissez uniquement le compartiment Amazon S3 `Location` sur le terrain, l'application multimédia SIP ajoute un préfixe par défaut`Amazon-Chime-SMA-Call-Recordings`, au chemin Amazon S3. L'application multimédia SIP ajoute également l'année, le mois et le jour de début de l'appel pour aider à organiser les enregistrements. L'exemple suivant montre le format général d'un chemin Amazon S3 avec le préfixe par défaut. Cet exemple utilise `myRecordingBucket` comme `Location` valeur.

```
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'exemple suivant montre les données représentées dans le chemin Amazon S3 qui enregistre les appels.

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

Lorsque vous fournissez le compartiment Amazon S3 et le préfixe de clé d'objet `Location` sur le terrain, l'application multimédia SIP utilise votre préfixe de clé d'objet dans le chemin Amazon S3 de destination au lieu du préfixe par défaut. L'exemple suivant montre le format général d'un appel enregistrant le chemin Amazon S3 avec votre préfixe. Par exemple, vous pouvez spécifier myRecordingBucket /TechnicalSupport/English comme. `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'exemple suivant montre les données du chemin Amazon S3.

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

L'enregistrement envoyé à votre compartiment Amazon S3 contient des [métadonnées d'objet Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingMetadata.html) supplémentaires concernant le segment d'appel. Le tableau suivant répertorie les métadonnées d'objets Amazon S3 prises en charge.


| Nom | Description | 
| --- | --- | 
| identifiant de transaction | Numéro de transaction de l'appel téléphonique | 
| identifiant d'appel | CallId du participant à l' CallDetails invocation de la AWS Lambda fonction | 
| durée d'enregistrement | Durée d'enregistrement des appels en secondes | 
| recording-audio-file-format | Format de fichier audio d'enregistrement d'appels représenté par le type de média Internet | 

## Octroi d'autorisations de compartiment Amazon S3
<a name="grant-s3-perms"></a>

Votre compartiment Amazon S3 de destination doit appartenir au même AWS compte que votre application. En outre, l'action doit donner une `s3:PutObject` `s3:PutObjectAcl` autorisation au responsable du service Amazon Chime SDK Voice Connector,. `voiceconnector.chime.amazonaws.com` L'exemple suivant accorde l'autorisation appropriée. 

------
#### [ 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"
                }
            }
        }
    ]
}
```

------

Le service audio PSTN lit et écrit dans votre compartiment S3 pour le compte de votre application Sip Media. Pour éviter le [problème des adjoints confus](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html), vous pouvez limiter les autorisations du bucket S3 à une seule application multimédia 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"
                }
            }
        }
    ]
}
```

------

## Action, réponse réussie
<a name="action-successful"></a>

Lorsque l'enregistrement d'appel est démarré avec succès sur un segment d'appel, l'application multimédia SIP invoque une AWS Lambda fonction du type d'`ACTION_SUCCESSFUL`événement. L'emplacement de l'enregistrement des appels est renvoyé dans la réponse. 

```
{
    "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": {
        ...
    }
}
```

## Réponse à une erreur d'action
<a name="action-error"></a>

En cas d'erreur de validation, l'application multimédia SIP appelle la AWS Lambda fonction avec le message d'erreur approprié. Le tableau suivant répertorie les messages d'erreur.




| Erreur | Message | Raison | 
| --- | --- | --- | 
| `InvalidActionParameter` | `CallId`le paramètre d'action n'est pas valide | Tout paramètre n'est pas valide. | 
| `SystemException` | Erreur système lors de l'exécution d'une action. | Un autre type d'erreur système s'est produit lors de l'exécution d'une action. | 

Lorsque l'action ne parvient pas à enregistrer le contenu multimédia lors d'un segment d'appel, l'application multimédia SIP invoque une AWS Lambda fonction du type d'`ActionFailed`événement. 

L'exemple suivant montre une réponse d'erreur typique.

```
{
    "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": {
        ...
    }
}
```

Voir un exemple pratique sur 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`action arrête l'enregistrement d'un segment d'appel. L'enregistrement s'arrête automatiquement à la fin d'un appel, et votre application n'a pas besoin de renvoyer explicitement l'`StopCallRecording`action. Une fois que l'enregistrement d'un segment d'appel s'arrête, il ne peut pas recommencer et l'enregistrement est livré à la destination spécifiée dans l'`StartCallRecording`action. 

L'exemple suivant arrête l'enregistrement pour le segment `call-id-1` d'appel. 

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

**CallId**  
*Description* — `CallId` du participant à l'`CallDetails`invocation de la AWS Lambda fonction  
*Valeurs autorisées* : un identifiant d'appel valide  
*Obligatoire* — Oui  
*Valeur par défaut* – Aucune

Voir un exemple pratique sur 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`action interrompt l'enregistrement d'un segment d'appel. Chaque fois que vous interrompez un enregistrement, celui-ci capte une tonalité indiquant la pause. Lorsque vous faites une pause, l'enregistrement continue, mais il ne capture que le silence. La suspension de l'enregistrement n'a aucune incidence sur la durée totale de l'enregistrement. Vous pouvez suspendre et reprendre l'enregistrement aussi souvent que nécessaire.

L'exemple suivant met en pause l'enregistrement. 

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

**CallId**  
*Description* — `CallId` du participant à l'`CallDetails`invocation de la AWS Lambda fonction  
*Valeurs autorisées* : un identifiant d'appel valide  
*Obligatoire* — Oui  
*Valeur par défaut* – Aucune

Voir un exemple pratique sur 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`action reprend l'enregistrement d'un segment d'appel. Avant le redémarrage de l'enregistrement, une courte tonalité est jouée. Vous pouvez suspendre et reprendre un enregistrement plusieurs fois pendant toute la durée de la phase d'appel. 

L'exemple suivant reprend l'enregistrement. 

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

**CallId**  
*Description* — `CallId` du participant à l'`CallDetails`invocation de la AWS Lambda fonction  
*Valeurs autorisées* : un identifiant d'appel valide  
*Obligatoire* — Oui  
*Valeur par défaut* – Aucune

Voir un exemple pratique sur GitHub : [https://github.com/aws-samples/amazon-chime-sma-on-demand-recording](https://github.com/aws-samples/amazon-chime-sma-on-demand-recording)