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.

# Passer un appel sortant pour utiliser le service audio PSTN du SDK Amazon Chime
<a name="use-create-call-api"></a>

Pour créer un appel sortant, vous devez utiliser l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateSipMediaApplicationCall.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateSipMediaApplicationCall.html)API. L'API invoque le point de terminaison d'un paramètre spécifié`SIP media application ID`. Les clients peuvent contrôler le flux de l'appel en émettant différents signaux et [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_SipMediaApplication.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_SipMediaApplication.html)actions depuis le terminal. 

En cas de réponse positive, l'API renvoie un code d'état http 202 ainsi qu'un ID de transaction, que vous pouvez utiliser avec 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 pour mettre à jour un appel en cours.

Le schéma suivant montre les appels effectués vers le point de terminaison de la AWS Lambda fonction pour un appel sortant.

![Schéma illustrant le flux de programmation pour les appels adressés au point de terminaison AWS Lambda.](http://docs.aws.amazon.com/fr_fr/chime-sdk/latest/dg/images/sip-api-1.png)


Le point de terminaison configuré pour l'application multimédia SIP est invoqué pour différents états de l'appel sortant. Lorsqu'un client lance un appel, le SDK Amazon Chime appelle le point de terminaison avec `NEW_OUTBOUND_CALL` un type d'événement d'invocation. 

Cet exemple montre un événement d'invocation typique pour un`NEW_OUTBOUND_CALL`.

```
{
    "SchemaVersion": "1.0",
        "Sequence": 1,
        "InvocationEventType": "NEW_OUTBOUND_CALL",
        "CallDetails": {
            "TransactionId": "{{transaction-id}}",
            "AwsAccountId": "{{aws-account-id}}",
            "AwsRegion": "us-east-1",
            "SipApplicationId": "{{sip-application-id}}",
            "Participants": [
                {
                    "CallId": "{{call-id-1}}",
                    "ParticipantTag": "LEG-A",
                    "To": "+1{{xxxx}}",
                    "From": "+1{{xxxxxxx}}",
                    "Direction": "Outbound",
                    "StartTimeInMilliseconds": "{{159700958834234}}"
                }
            ]
    }
}
```

Toute réponse à un appel lié à un AWS Lambda événement est ignorée.

Lorsque nous recevons une `RINGING` notification du destinataire, le SDK Amazon Chime appelle à nouveau le point de terminaison configuré. 

Cet exemple montre un événement d'invocation typique pour`RINGING`.

```
{
    "SchemaVersion": "1.0",
        "Sequence": 1,
        "InvocationEventType": "RINGING",
        "CallDetails": {
            "TransactionId": "{{transaction-id}}",
            "AwsAccountId": "{{aws-account-id}}",
            "AwsRegion": "us-east-1",
            "SipApplicationId": "{{sip-application-id}}",
            "Participants": [
                {
                    "CallId": "{{call-id-1}}",
                    "ParticipantTag": "LEG-A",
                    "To": "+1{{xxxx}}",
                    "From": "+1{{xxxxxxx}}",
                    "Direction": "Outbound",
                    "StartTimeInMilliseconds": "{{159700958834234}}"
                }
           ]
    }
}
```

Toute réponse à un appel lié à un AWS Lambda événement est ignorée.

Si le récepteur ne répond pas à l'appel ou si l'appel échoue en raison d'une erreur, Chime déconnecte l'appel et appelle le point de terminaison avec le `Hangup` type d'événement. Pour plus d'informations sur le type d'`Hangup`événement, reportez-vous à[Fin d'un appel à l'aide du service audio PSTN du SDK Amazon Chime](case-5.md). 

Si l'appel est répondu, Chime appelle le point de terminaison avec l'`CALL_ANSWERED`action. Cet exemple montre un événement d'invocation typique.

```
{
  "SchemaVersion": "1.0",
    "Sequence": 1,
    "InvocationEventType": "CALL_ANSWERED",
    "CallDetails": {
        ""TransactionId": "{{transaction-id}}",
            "AwsAccountId": "{{aws-account-id}}",
            "AwsRegion": "us-east-1",
            "SipApplicationId": "{{sip-application-id}}",
            "Participants": [
                {
                    "CallId": "{{call-id-1}}",
                    "ParticipantTag": "LEG-A",
                    "To": "+1{{xxxx}}",
                    "From": "+1{{xxxxxxx}}",
                    "Direction": "Outbound",
                    "StartTimeInMilliseconds": "{{159700958834234}}",
                "Status": "Connected"
            }
        ]
    }
}
```

À ce stade, vous pouvez renvoyer des actions en répondant à l'appel par une liste d'actions. Si vous ne souhaitez exécuter aucune action, répondez par une liste vide. Vous pouvez répondre avec un maximum de 10 actions pour chaque AWS Lambda appel, et vous pouvez invoquer une fonction Lambda 1 000 fois par appel. Pour plus d'informations sur la réponse par des ensembles d'actions, reportez-vous à[Répondre aux appels à l'aide de listes d'actions à l'aide du service audio PSTN du SDK Amazon Chime](invoke-on-call-leg.md).