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á.

# JoinChimeMeeting
<a name="join-chime-meeting"></a>

Participe de uma reunião do SDK do Amazon Chime fornecendo o token de participação do participante. Para fazer isso, você faz chamadas AWS do SDK para o [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeeting.html) e [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateAttendee.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateAttendee.html) APIs para obter o token e repassá-lo na ação. Veja o exemplo a seguir. 

**nota**  
Você não pode executar essa ação em uma chamada ancorada.

```
{
    "Type": "JoinChimeMeeting",
    "Parameters": {
        "JoinToken": "meeting-attendee-join-token",
        "CallId": "call-id-1",
        "ParticipantTag": "LEG-A",
        "MeetingId": "meeting-id"
    }
}
```

**JoinToken**  
*Descrição*: um token de participação válido do participante da reunião do SDK do Amazon Chime  
*Valores permitidos*: token de participação válido  
*Obrigatório* – Sim  
*Valor-padrão*: nenhum

**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* – Não  
*Valor-padrão*: nenhum

**ParticipantTag**  
*Descrição* – `ParticipantTag` de um dos participantes conectados no `CallDetails`  
*Valores permitidos*: `LEG-A`  
*Obrigatório* – Não  
*Valor-padrão*: `ParticipantTag` do `callLeg` invocado ignorado se você especificar `CallId`

**MeetingId**  
*Descrição*: um ID de reunião válido do SDK do Amazon Chime associado ao `JoinToken`. Se a reunião foi criada usando uma API no namespace [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html), o ID da reunião não é necessário. Se a reunião foi criada usando uma API no namespace [SDK do Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html), o ID da reunião é necessário. A reunião é ingressada usando o endpoint da API usado para criar a reunião.  
*Valores permitidos*: um ID de reunião válido.  
*Obrigatório* – Não.  
*Valor-padrão*: nenhum.

O aplicativo de mídia SIP sempre invoca uma AWS Lambda função depois de executar essa ação. Ele retorna os tipos de eventos de invocação `ACTION_SUCCESSFUL` ou `ACTION_FAILED`. O exemplo a seguir mostra uma estrutura de evento de invocação bem-sucedida.

```
{
    "SchemaVersion": "1.0",
    "Sequence": 4,
    "InvocationEvent": "ACTION_SUCCESSFUL",
    "ActionData": {
        "Type": "JoinChimeMeeting",
        "Parameters": {
            "JoinToken": "meeting-attendee-join-token",
            "CallId": "call-id-1"
            "ParticipantTag": "LEG-A"
        }
    }
    "CallDetails": {
        ...
    }
}
```

**Gerenciamento de erros**  
Quando ocorre um erro de validação ao interligar uma reunião, o aplicativo SIP chama sua AWS Lambda função com uma das mensagens de erro mostradas na tabela a seguir.


|  Erro  |  Mensagem  |  Motivo  | 
| --- | --- | --- | 
|  `InvalidActionParameter`  |  O valor do parâmetro `JoinToken` é inválido.  |  Qualquer um dos outros parâmetros da ação é inválido ou está ausente.  | 
|  `SystemException`  |  Erro do sistema ao executar a ação.  |  Ocorreu outro tipo de erro do sistema na execução da ação.  | 

O exemplo a seguir mostra um evento de falha típico.

```
{
    "SchemaVersion": "1.0",
    "Sequence": 3,
    "InvocationEvent": "ACTION_FAILED",
    "ActionData": {
        "Type": "JoinChimeMeeting",
        "Parameters": {
            "JoinToken": "meeting-attendee-join-token",
            "CallId": "call-id-1",
            "ParticipantTag": "LEG-A"
        },
        "Error": "ErrorJoiningMeeting: Error while joining meeting."
    }
    "CallDetails": {
        ...
    }
}
```

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