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.

# Descripción de los eventos de telefonía para el servicio de audio PSTN de Amazon Chime SDK
<a name="pstn-invocations"></a>

El servicio de audio invoca su AWS AWS Lambda función cuando se producen determinados eventos durante una llamada. El siguiente ejemplo muestra los eventos y el texto que sigue al ejemplo explica cada evento.

```
{ 
    "SchemaVersion": "1.0", 
    "Sequence": 3, 
    "InvocationEventType": "event-type", 
    "CallDetails": { 
        "TransactionId": "transaction-id-1", 
        "AwsAccountId": "aws-acct-id-1", 
        "AwsRegion": "us-east-1", 
        "SipMediaApplicationId": "sip-media-app-id-1", 
        "Participants": [ 
            { 
                "CallId": "call-id-1", 
                "ParticipantTag": "LEG-A", 
                "To": "e164PhoneNumber", 
                "From": "e164PhoneNumber", 
                "Direction": "Inbound/Outbound", 
                "StartTimeInMilliseconds": "1641998241509", 
                "Status": "Connected/Disconnected" 
            } 
        ] 
    } 
}
```

**SchemaVersion**  
La versión del esquema utilizada para crear este objeto de evento.

**Sequence**  
La secuencia de eventos que invocan su función. AWS Lambda Cada vez que se invoca la función durante una llamada, la secuencia se incrementa.

**InvocationEventType**  
El tipo de evento que desencadena una AWS Lambda invocación. Para obtener más información, consulte [Event types (Tipos de eventos)](#pstn-event-types) más adelante en este tema.

**CallDetails**  
Información sobre la llamada asociada a la AWS Lambda invocación.

**TransactionId**  
El ID de una llamada asociada a una AWS Lambda invocación.

**AwsAccountId**  
El ID de AWS cuenta asociado a la aplicación multimedia SIP que dio lugar al enrutamiento de la llamada.

**SipMediaApplicationId**  
El ID de la aplicación multimedia SIP asociada a la llamada.

**Participants**  
Información sobre los participantes de la llamada que invoca una AWS AWS Lambda función.

**CallId**  
Un ID único asignado a cada participante.

**ParticipantTag**  
Cada participante de la llamada recibe una etiqueta, `LEG-A` o `LEG-B`.

**To**  
El número de teléfono «para» del participante en formato E.164.

**From**  
El número de teléfono del participante en formato E.164.

**Direction**  
La dirección de la que proviene el tramo de una llamada. `Inbound` representa una llamada realizada al servicio de audio. `Outbound` representa una llamada realizada desde el servicio de audio.

**StartTimeInMilliseconds**  
El tiempo de la época en milisegundos, que comienza cuando un participante se une a una llamada.

**Status**  
Si un participante está `Connected` o `Disconnected`

## Event types (Tipos de eventos)
<a name="pstn-event-types"></a>

El servicio de audio invoca la función de Lambda con los siguientes tipos de eventos:

**NEW\$1INBOUND\$1CALL**  
Se ha iniciado una nueva llamada mediante un número de teléfono asociado a su aplicación multimedia SIP.

**NEW\$1OUTBOUND\$1CALL**  
Se ha realizado una nueva llamada saliente a través de la [CreateSipMediaApplicationCall](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateSipMediaApplicationCall.html)API.

**ACTION\$1SUCCESSFUL**  
Se ha realizado correctamente una acción devuelta por tu AWS Lambda función. Las acciones finalizadas satisfactoriamente incluyen aquellos `ActionData` que coincidan con la acción.   

```
    "ActionData": {
        // The previous successful action 
    },
```

**ACTION\$1FAILED**  
Una acción devuelta por tu AWS Lambda función no se ha realizado correctamente. Entre las acciones fallidas se incluyen `ActionData` que coinciden con la acción fallida, un tipo de error y un mensaje de error que describe el error:  

```
    "ActionData": {
        // The previous unsuccessful action
        "ErrorType": "error-type",
        "ErrorMessage": "error message"
    },
```

**ACTION\$1INTERRUPTED**  
Una invocación a la [ UpdateSipMediaApplicationCall](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_UpdateSipMediaApplicationCall.html)API interrumpió una acción en proceso de ejecución. Los `ActionData` incluyen las acciones interrumpidas:   

```
"ActionData": {
        // The action that was interrupted
    },
```

**HANGUP**  
Un usuario o la aplicación colgaron el tramo de una llamada. Los `ActionData` incluyen los siguientes detalles sobre el evento:  

```
   "ActionData": {
        "Type": "Hangup",
        "Parameters": {
            "SipResponseCode": 486,
            "CallId": "c70f341a-adde-4406-9dea-1e01d34d033d",
            "ParticipantTag": "LEG-A"
        }
    },
```  
**Type**  
Colgar.  
**Parameters**  
Información sobre el evento `HANGUP`:   
+ **SipResponseCode**— El código de respuesta asociado al evento. Los códigos más comunes son:
  + **0** — Borrado normal
  + **480** — Sin respuesta
  + **486** — Usuario ocupado
+ **CallId**El identificador del participante que colgó el teléfono.
+ **ParticipantTag**La etiqueta del participante que colgó.

**CALL\$1ANSWERED**  
El servicio de audio respondió a una llamada entrante. Este evento se devuelve en una llamada telefónica externa, a menos que la llamada sea transitoria.

**INVALID\$1LAMBDA\$1RESPONSE**  
La respuesta proporcionada a la última AWS Lambda invocación causó un problema. Los `ActionData` incluyen los siguientes campos adicionales:  

```
    "ErrorType": "error-type-1", 
    "ErrorMessage": "error-msg-1"
```

**DIGITS\$1RECEIVED**  
La aplicación recibió los dígitos del DTMF después de completar una acción de `ReceiveDigits`. Los `ActionData` incluyen los dígitos recibidos.  

```
    "ActionData": {
        "ReceivedDigits": ###
        // The ReceiveDigits action data
    },
```

**CALL\$1UPDATE\$1REQUESTED**  
Se ha invocado la [UpdateSipMediaApplicationCall](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_UpdateSipMediaApplicationCall.html)API. Los `ActionData` incluyen información sobre la solicitud de actualización:  

```
    "ActionData": {
        "Type": "CallUpdateRequest", 
        "Parameters": {
            "Arguments": {
                "leg": "LEG-A"
                }
            }
        },
    }
```

**RINGING**  
Está sonando un tramo de llamada