

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Como usar a gravação de chamadas
<a name="sip-apps-call-record"></a>

As ações de gravação de chamadas para aplicativos de mídia SIP permitem que você crie soluções de gravação e transcrição pós-chamada para uma variedade de usos. Por exemplo, você pode gravar chamadas de atendimento ao cliente e usá-las para treinamento.

Você usa as ações de gravação de chamadas em conjunto com seus aplicativos de mídia SIP. Você também pode usar as ações sob demanda ou em resposta a um evento SIP. 
+ Para iniciar a gravação sob demanda de uma chamada na aplicação de mídia SIP, use a API [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) para invocar a aplicação e gerar a ação [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). 
+ Para iniciar a gravação de chamadas em resposta a um evento SIP, você retorna a ação `StartCallRecording` em seu aplicativo. 

É possível pausar e retomar uma gravação em andamento. Para pausar, use a ação [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). Para continuar, use a ação `ResumeCallRecording`. Sempre que você pausa ou retoma uma gravação, a ação captura um tom que indica a pausa ou a retomada. Quando você faz uma pausa, a ação registra o silêncio, que o SDK do Amazon Chime usa para rastrear a duração da pausa e incluir as pausas na sua fatura. É possível pausar e retomar a gravação conforme necessário.

Para interromper a gravação de chamadas, você gera a ação [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). No entanto, as gravações de chamadas param automaticamente quando a chamada é interrompida e, nesse caso, você não precisa retornar explicitamente a ação `StopCallRecording`. Você só pode iniciar e parar a gravação uma vez para um trecho de chamada individual.

O SDK do Amazon Chime fornece gravações de chamadas para um bucket do Amazon S3 selecionado por você. O bucket deve pertencer à sua AWS conta. Quando uma chamada é interrompida, o aplicativo de mídia SIP entrega a gravação na pasta especificada no parâmetro `Destination` da ação [StartCallRecording](start-call-recording.md). O SDK do Amazon Chime grava chamadas em um formato WAV aberto. As chamadas que gravam faixas de entrada e saída usam o modo estéreo, com a faixa de entrada no canal esquerdo e a de saída no canal direito. Se você gravar somente a faixa de entrada ou saída, o sistema usará o modo mono.

**nota**  
As gravações feitas usando esse atributo podem estar sujeitas a leis ou regulamentos relacionados à gravação de comunicações eletrônicas. É responsabilidade sua e de seus usuários finais cumprir todas as leis aplicáveis em relação à gravação, incluindo notificar adequadamente todos os participantes de uma sessão ou comunicação gravada de que a sessão ou comunicação está sendo gravada e obter o consentimento deles.

## Como cobrar pela gravação de chamadas
<a name="call-billing"></a>

O SDK do Amazon Chime cobra por minuto pelo tempo em que a gravação de chamadas está habilitada para um trecho de chamada, e esse tempo inclui todas as pausas. Você será cobrado pelo uso da gravação de chamadas quando a gravação for entregue ao seu bucket do Amazon S3.

# Como gravar faixas de áudio
<a name="record-legs"></a>

Você pode gravar apenas as faixas de entrada ou saída da chamada, ou ambas as faixas de uma chamada.

Esta imagem mostra uma chamada típica recebida com um trecho ou sem ancoragem. 

![\[Uma chamada recebida que só se comunica com um aplicativo de mídia SIP.\]](http://docs.aws.amazon.com/pt_br/chime-sdk/latest/dg/images/call-record-sma-one-leg.png)


A chamada tem apenas uma etapa com um `callID` de **call-id-1**. A faixa de áudio `INCOMING` é o áudio do chamador para o aplicativo de mídia SIP. A faixa de áudio `OUTGOING` é o áudio do aplicativo de mídia SIP para o chamador. Seu aplicativo de mídia SIP especifica o `CallId` da chamada que você deseja gravar. Para gravar o participante que fez a chamada, você especifica o `INCOMING`. Para gravar o participante que responde a chamada, você especifica o `OUTGOING`. Para registrar os dois participantes, especifique `BOTH`.

Esta imagem mostra uma chamada ancorada típica com dois participantes.

![\[Uma chamada recebida que se comunica com um aplicativo de mídia SIP e um segundo participante.\]](http://docs.aws.amazon.com/pt_br/chime-sdk/latest/dg/images/call-record-sma-bridged.png)


Neste exemplo, a chamada tem dois trechos de chamada, **call-id-1** e **call-id-2**, e **call-id-1** é ancorado a **call-id-2**. Isso cria quatro faixas de áudio, os fluxos de entrada e saída de áudio para ambas as chamadas. IDs Você pode especificar quais faixas de chamada IDs e áudio devem ser gravadas. Por exemplo, se você quiser gravar a faixa de áudio do participante chamado, você grava a faixa de áudio `INCOMING` especificando **call-id-2** como `CallId` e `INCOMING` como faixa.

Se você quiser gravar tudo o que o chamador ouve, grave a faixa de áudio `OUTGOING` especificando **call-id-1** como `CallId` e `OUTGOING` como faixa. Se você quiser gravar todo o áudio dito e ouvido pelo `Caller`, você grava as faixas de áudio `BOTH` especificando `call-id-1` como `CallId` e `BOTH` como faixa.

# Casos de uso de exemplo
<a name="recording-use-cases"></a>

Os aplicativos de mídia SIP fornecem ações de gravação de chamadas como blocos de construção. Eles oferecem a flexibilidade de criar soluções de gravação de chamadas para seus casos de uso comercial. Os casos a seguir ilustram alguns cenários de uso comuns.

**Topics**
+ [Caso 1: como gravar uma chamada unilateral que envolve ações SIP](#recording-case-1)
+ [Caso 2: gravação seletiva de áudio em uma chamada ancorada](#recording-case-2)
+ [Caso 3: como gravar vários trechos de chamada](#recording-case-3)
+ [Caso 4: gravação sob demanda com pausa e retomada](#on-demand-pause-resume)

## Caso 1: como gravar uma chamada unilateral que envolve ações SIP
<a name="recording-case-1"></a>

Você pode gravar um chamador e qualquer áudio gerado pelas ações do aplicativo de mídia SIP, como as ações [PlayAudio](play-audio.md) e [PlayAudioAndGetDigits](play-audio-get-digits.md). Durante a gravação, se um chamador pressionar um dígito, a gravação captura o tom desse dígito. Este exemplo usa a ação `PlayAudioAndGetDigits`, mas a resposta de voz interativa (IVR) pode ser uma série complexa de ações de aplicativos de mídia SIP.

Neste exemplo, o aplicativo de mídia SIP grava as duas faixas de áudio entre o chamador e o próprio aplicativo de mídia SIP. A gravação começa quando a chamada é estabelecida e é interrompida quando o chamador desliga. A cobrança começa quando a chamada é estabelecida e é interrompida quando o chamador desliga.

![\[Diagrama de um aplicativo de mídia SIP gravando duas faixas de áudio, nesse caso, entre um chamador e o próprio aplicativo.\]](http://docs.aws.amazon.com/pt_br/chime-sdk/latest/dg/images/sma-recording-case-1.png)


## Caso 2: gravação seletiva de áudio em uma chamada ancorada
<a name="recording-case-2"></a>

Você pode gravar seletivamente a faixa de áudio de um único participante da chamada. É possível usar esse atributo para ativar seletivamente a gravação de chamadas somente para um participante específico.

Neste exemplo, o aplicativo de mídia SIP grava as faixas de áudio de entrada entre a parte chamada e o próprio aplicativo de mídia SIP especificando **call-id-2** como `CallId` e `INCOMING` como faixa. A gravação da chamada começa quando o chamador é conectado à parte chamada, e é também quando a cobrança começa. A gravação é interrompida quando a pessoa chamada desliga e é também quando a cobrança termina. Essa gravação tem apenas a faixa de áudio da pessoa chamada. 

![\[Diagrama de um aplicativo de mídia SIP gravando seletivamente uma faixa.\]](http://docs.aws.amazon.com/pt_br/chime-sdk/latest/dg/images/sma-recording-case-2.png)


## Caso 3: como gravar vários trechos de chamada
<a name="recording-case-3"></a>

Você pode gravar vários trechos de chamada. Por exemplo, digamos que você ancora uma ligação a um participante. Quando esse participante desliga, a ligação é transferida para outro participante. Você pode ativar a gravação de chamadas para todos os três trechos de chamada. 

Este exemplo mostra três arquivos de gravação separados. A gravação do primeiro trecho da chamada captura a conversa entre o chamador, seu aplicativo e os dois participantes que foram conectados à chamada. A gravação do segundo trecho da chamada captura a conversa entre o chamador e o primeiro participante. A gravação do terceiro trecho da chamada captura a conversa entre o chamador e o segundo participante. 

Esse caso cria três segmentos de chamada, e a cobrança se aplica ao início e ao final de cada segmento de chamada. Em outras palavras, o sistema entrega três gravações em seu bucket S3, e você é cobrado por cada uma. 

![\[Diagrama de um aplicativo de mídia SIP gravando vários trechos de chamada.\]](http://docs.aws.amazon.com/pt_br/chime-sdk/latest/dg/images/sma-recording-case-3.png)


## Caso 4: gravação sob demanda com pausa e retomada
<a name="on-demand-pause-resume"></a>

É possível iniciar, interromper, pausar e retomar a gravação de chamadas sob demanda usando a 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). Você pode criar um aplicativo cliente que chame a API `UpdateSipMediaApplicationCall` e invoque seu aplicativo de mídia SIP para retornar ações de gravação de chamadas.

Seus usuários finais usam o aplicativo cliente para controlar a gravação da chamada. Por exemplo, em uma central de atendimento, um atendente usaria um aplicativo cliente de desktop para acionar ações de gravação de chamadas sob demanda. No exemplo da central de atendimento, o atendente pode pedir permissão ao chamador para gravar a chamada telefônica e clicar no aplicativo do cliente para iniciar a gravação quando o chamador concordar. Em outro exemplo, o chamador pode precisar fornecer informações como um número da previdência social (SSN). No entanto, a política da central de atendimento exige que o atendente não registre informações como o SSN do cliente. O atendente pode clicar no aplicativo para pausar a gravação enquanto o cliente fornece as informações e clicar novamente para retomá-la. Depois que o atendente processa a solicitação do chamador, ele clica no aplicativo para interromper a gravação e desliga a chamada.

Neste caso de uso, o aplicativo de mídia SIP grava ambas as faixas de áudio entre o chamador e o aplicativo de mídia SIP. Como o trecho `call-id-1` está ancorado ao trecho `call-id-2`, o sistema grava o áudio nos dois trechos, chamador e chamado. A gravação e a cobrança começam quando a API `UpdateSipMediaApplicationCall` invoca a ação `StartCallRecording`. A gravação e a cobrança param quando a API `UpdateSipMediaApplicationCall` invoca a ação `StopCallRecording`. Como lembrete, pausar a gravação não altera sua duração e você é cobrado por todas as pausas. 

![\[Diagrama de um aplicativo de mídia SIP gravando sob demanda com gravação pausada e retomada.\]](http://docs.aws.amazon.com/pt_br/chime-sdk/latest/dg/images/sma-recording-on-demand.png)


# Ações de gravação de chamadas para aplicativos de mídia SIP
<a name="use-recording-apis"></a>

Você pode especificar diferentes ações de gravação de chamadas em uma resposta a partir da AWS Lambda função do seu aplicativo de mídia SIP. Os seguintes tópicos fornecem exemplos de código e explicam como usar as ações.

**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>

A ação `StartCallRecording` inicia a gravação de um trecho de chamada. Você inicia a gravação de chamadas em seus aplicativos de mídia SIP, sob demanda ou em resposta a um evento SIP.
+ Para iniciar a gravação sob demanda de uma chamada, você usa a API `UpdateSipMediaApplication` para invocar seu aplicativo e retornar a ação `StartCallRecording`.
+ Para iniciar a gravação de chamadas em resposta a um evento SIP, você retorna a ação `StartCallRecording` em seu aplicativo. 

Você especifica se deseja gravar a faixa de áudio para a etapa de entrada, a etapa de saída ou ambas. As seções a seguir explicam como usar a ação `StartCallRecording`.

**nota**  
As gravações feitas usando esse atributo podem estar sujeitas a leis ou regulamentos relacionados à gravação de comunicações eletrônicas. É responsabilidade sua e de seus usuários finais cumprir todas as leis aplicáveis em relação à gravação, incluindo notificar adequadamente todos os participantes de uma sessão ou comunicação gravada de que a sessão ou comunicação está sendo gravada e obter o consentimento deles.

**Topics**
+ [Solicitando uma StartCallRecording ação](#request-start)
+ [Como especificar um destino de gravação](#recording-destination)
+ [Como conceder permissões do bucket do Amazon S3](#grant-s3-perms)
+ [Resposta bem-sucedida da ação](#action-successful)
+ [Resposta de erro da ação](#action-error)

## Solicitando uma StartCallRecording ação
<a name="request-start"></a>

O exemplo a seguir mostra como solicitar a ação `StartCallRecording` para faixas `BOTH`.

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

**CallId**  
*Descrição* — `CallId` do participante na `CallDetails` invocação da AWS Lambda função  
*Valores permitidos*: um ID de chamada válido  
*Obrigatório* – Sim  
*Valor-padrão*: nenhum

**Faixa**  
*Descrição* – Áudio da `Track` da gravação da chamada.  
*Valores permitidos*: `BOTH`, `INCOMING` ou `OUTGOING`  
*Obrigatório* – Sim  
*Valor-padrão*: nenhum

**Destination.Type**  
*Descrição* – Tipo de destino. Somente o Amazon S3 é permitido.  
*Valores permitidos*: Amazon S3  
*Obrigatório* – Sim  
*Valor-padrão*: nenhum

**Destination.Location**  
*Descrição* – Um bucket válido do Amazon S3 e um prefixo de chave opcional do Amazon S3. O bucket deve ter permissões para a entidade principal de serviço de conector de voz do SDK do Amazon Chime, o voiceconnector.chime.amazonaws.com.  
*Valores permitidos*: um caminho do Amazon S3 válido para o qual o SDK do Amazon Chime tem acesso às ações `s3:PutObject` e `s3:PutObjectAcl`.  
*Obrigatório* – Sim  
*Valor-padrão*: nenhum

## Como especificar um destino de gravação
<a name="recording-destination"></a>

O SDK do Amazon Chime fornece gravações de chamadas para se bucket do Amazon S3. O bucket deve pertencer à sua AWS conta. Você especifica a localização do bucket no parâmetro `Destination` da ação `StartCallRecording`. O campo `Type` no parâmetro `Destination` deve ser `S3`. O campo `Location` consiste em seu bucket do Amazon S3, além de um prefixo de chave de objeto opcional no qual a gravação da chamada é entregue. 

O aplicativo de mídia SIP usa a `Location` especificada, a data e a hora do trecho da chamada, o ID da transação e o ID da chamada para formatar a chave de objeto do Amazon S3. A resposta da ação `StartCallRecording` retorna a chave de objeto completa do Amazon S3.

Quando você fornece somente o bucket do Amazon S3 no campo `Location`, o aplicativo de mídia SIP acrescenta um prefixo-padrão, `Amazon-Chime-SMA-Call-Recordings`, ao caminho do Amazon S3. O aplicativo de mídia SIP também anexa o ano, mês e dia do horário de início da chamada para ajudar a organizar as gravações. O exemplo a seguir mostra o formato geral de um caminho do Amazon S3 com o prefixo-padrão. Este exemplo usa `myRecordingBucket` como valor de `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
```

O exemplo a seguir mostra os dados representados no nome de registro de caminho do Amazon S3.

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

Quando você fornece o bucket do Amazon S3 e o prefixo da chave do objeto no campo `Location`, o aplicativo de mídia SIP usa seu prefixo de chave de objeto no caminho de destino do Amazon S3 em vez do prefixo-padrão. O exemplo a seguir mostra o formato geral de um caminho do Amazon S3 de gravação de chamadas com seu prefixo. Por exemplo, você pode especificar myRecordingBucket /TechnicalSupport/English como o. `Location` 

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

O exemplo a seguir mostra os dados no caminho do Amazon S3.

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

A gravação enviada para seu bucket do Amazon S3 contém [metadados de objetos do Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingMetadata.html) adicionais sobre o trecho da chamada. A tabela a seguir lista os metadados do objeto do Amazon S3 compatíveis.


| Name (Nome) | Description | 
| --- | --- | 
| transaction-id | O ID da transação da chamada telefônica | 
| call-id | CallId do participante na invocação CallDetails da AWS Lambda função | 
| recording-duration | Duração da gravação de chamadas em segundos | 
| recording-audio-file-format | Formato de arquivo de áudio de gravação de chamadas representado como tipo de mídia da Internet | 

## Como conceder permissões do bucket do Amazon S3
<a name="grant-s3-perms"></a>

Seu bucket Amazon S3 de destino deve pertencer à mesma AWS conta do seu aplicativo. Além disso, a ação deve conceder permissão `s3:PutObject` e `s3:PutObjectAcl` à entidade principal responsável pelo serviço de conector de voz do SDK do Amazon Chime, `voiceconnector.chime.amazonaws.com`. O exemplo a seguir concede a permissão apropriada. 

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

------

O serviço de áudio PSTN lê e grava no bucket do S3 em nome da aplicação de mídia Sip. Para evitar o [problema do substituto confuso](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html), você pode restringir as permissões do bucket do S3 a um único aplicativo de mí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"
                }
            }
        }
    ]
}
```

------

## Resposta bem-sucedida da ação
<a name="action-successful"></a>

Quando a gravação da chamada é iniciada com sucesso em um trecho de chamada, o aplicativo de mídia SIP invoca uma AWS Lambda função com o `ACTION_SUCCESSFUL` tipo de evento. A localização da gravação da chamada é retornada na resposta. 

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

## Resposta de erro da ação
<a name="action-error"></a>

Para erros de validação, o aplicativo de mídia SIP chama a AWS Lambda função com a mensagem de erro apropriada. A seguinte tabela lista as mensagens de erro.




| Erro | Mensagem | Motivo | 
| --- | --- | --- | 
| `InvalidActionParameter` | O parâmetro `CallId` para a ação é inválido | Qualquer parâmetro é inválido. | 
| `SystemException` | Erro do sistema ao executar uma ação. | Ocorreu outro tipo de erro do sistema na execução de uma ação. | 

Quando a ação falha ao gravar a mídia em um trecho de chamada, o aplicativo de mídia SIP invoca uma função AWS Lambda com o tipo de evento `ActionFailed`. 

O exemplo a seguir mostra uma resposta de erro típica.

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

Veja um exemplo prático em 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>

A ação `StopCallRecording` para a gravação de um trecho de chamada. A gravação é interrompida automaticamente quando uma chamada termina, e seu aplicativo não precisa retornar explicitamente a ação `StopCallRecording`. Quando a gravação de um trecho de chamada é interrompida, ela não pode ser iniciada novamente e a gravação é entregue ao destino especificado na ação `StartCallRecording`. 

O exemplo a seguir interrompe a gravação do trecho de chamada `call-id-1`. 

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

**CallId**  
*Descrição* — `CallId` do participante na `CallDetails` invocação da AWS Lambda função  
*Valores permitidos*: um ID de chamada válido  
*Obrigatório* – Sim  
*Valor-padrão*: nenhum

Veja um exemplo prático em 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>

A ação `PauseCallRecording` pausa a gravação de um trecho de chamada. Sempre que você pausa uma gravação, a gravação captura um tom que indica a pausa. Quando você pausa, a gravação continua, mas captura apenas o silêncio. Pausar a gravação não afeta a duração total da gravação. É possível pausar e retomar a gravação conforme necessário.

O exemplo a seguir pausa a gravação. 

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

**CallId**  
*Descrição* — `CallId` do participante na `CallDetails` invocação da AWS Lambda função  
*Valores permitidos*: um ID de chamada válido  
*Obrigatório* – Sim  
*Valor-padrão*: nenhum

Veja um exemplo prático em 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>

A ação `ResumeCallRecording` retoma a gravação de um trecho de chamada. Antes de a gravação ser reiniciada, um breve tom é reproduzido. Você pode pausar e retomar uma gravação várias vezes durante o trecho da chamada. 

O exemplo a seguir retoma a gravação. 

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

**CallId**  
*Descrição* — `CallId` do participante na `CallDetails` invocação da AWS Lambda função  
*Valores permitidos*: um ID de chamada válido  
*Obrigatório* – Sim  
*Valor-padrão*: nenhum

Veja um exemplo prático em GitHub: [https://github.com/aws-samples/amazon-chime-sma-on-demand-recording](https://github.com/aws-samples/amazon-chime-sma-on-demand-recording)