

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

Para unirse a una reunión de Amazon Chime SDK, proporcione el token de acceso de los asistentes. Para ello, debe realizar llamadas del AWS SDK a las [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateAttendee.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateAttendee.html)API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeeting.html)y obtener el token y transferirlo a la acción. Consulte el siguiente ejemplo. 

**nota**  
No puede ejecutar esta acción en una llamada puente.

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

**JoinToken**  
*Descripción*: un token de unión válido del asistente a la reunión de Amazon Chime SDK  
*Valores permitidos:* token de unión válido  
*Obligatorio*: sí  
*Valor predeterminado:* ninguno

**CallId**  
*Descripción*: `CallId` del participante en la invocación `CallDetails` de la AWS Lambda función  
*Valores permitidos*: un identificador de llamada válido  
*Obligatorio:* no  
*Valor predeterminado:* ninguno

**ParticipantTag**  
*Descripción*: la `ParticipantTag` de uno de los participantes conectados en los `CallDetails`  
*Valores permitidos*: -`LEG-A`  
*Obligatorio:* no  
*Valor predeterminado*: `ParticipantTag` del `callLeg` invocado ignorado si se especifica el `CallId`

**MeetingId**  
*Descripción*: un ID de reunión de Amazon Chime SDK válido asociado al `JoinToken`. Si la reunión se creó mediante una API en el espacio de nombres [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html), no se requiere el ID de la reunión. Si la reunión se creó mediante una API en el espacio de nombres de [Amazon Chime SDK Meetings](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html), se requiere el ID de la reunión. Se accede a la reunión mediante el punto de conexión de la API utilizado para crear la reunión.  
*Valores permitidos*: un identificador de reunión válido.  
*Obligatorio:* no.  
*Valor predeterminado:* ninguno.

La aplicación multimedia SIP siempre invoca una AWS Lambda función después de ejecutar esta acción. Devuelve el tipo de evento `ACTION_SUCCESSFUL` o el tipo de evento `ACTION_FAILED` de invocación. En el siguiente ejemplo se muestra una estructura de eventos de invocación correcta.

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

**Gestión de errores**  
Cuando se produce un error de validación al cerrar una reunión, la aplicación SIP llama a su AWS Lambda función con uno de los mensajes de error que se muestran en la siguiente tabla.


|  Error  |  Mensaje  |  Motivo  | 
| --- | --- | --- | 
| `InvalidActionParameter` | El valor del parámetro `JoinToken` no es válido. | Falta alguno de los demás parámetros de la acción o no es válido. | 
| `SystemException` | Error del sistema al ejecutar la acción. | Se ha producido otro tipo de error de sistema al ejecutar la acción. | 

En el siguiente ejemplo, se muestra un evento típico de fallo.

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

Vea un ejemplo práctico sobre GitHub: [https://github.com/aws-samples/amazon-chime-sma-update-call](https://github.com/aws-samples/amazon-chime-sma-update-call)