翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon Chime SDK PSTN オーディオサービスを使用するために発信通話を行う
<a name="use-create-call-api"></a>

発信通話を行うには、[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 を使用します。API は、指定された `SIP media application ID` のエンドポイントを呼び出します。顧客は、エンドポイントから異なるシグナリングと [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_SipMediaApplication.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_SipMediaApplication.html) アクションを提供することで、発信のフローを制御できます。

レスポンスが成功した場合、API は 202 HTTP ステータスコードと transactionId を返します。これは、[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 で使用して、進行中の発信を更新できます。

次の図は、アウトバウンドコールの AWS Lambda 関数エンドポイントに対して行われた呼び出しを示しています。

![AWS Lambda エンドポイントに対して行われた呼び出しのプログラミングフローを示す図。](http://docs.aws.amazon.com/ja_jp/chime-sdk/latest/dg/images/sip-api-1.png)


SIP メディアアプリケーション用に設定されたエンドポイントは、発信通話のさまざまなステータスに対して呼び出されます。顧客が通話を開始すると、Amazon Chime SDK は、`NEW_OUTBOUND_CALL` 呼び出しイベントタイプでエンドポイントを呼び出します。

この例は、`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}}"
                }
            ]
    }
}
```

イベント関連の AWS Lambda 呼び出しに対する応答は無視されます。

受信者から `RINGING` 通知を受け取ると、Amazon Chime SDK は設定されたエンドポイントを再度呼び出します。

この例は、`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}}"
                }
           ]
    }
}
```

イベント関連の AWS Lambda 呼び出しに対する応答は無視されます。

受信者が発信に応答しない場合、またはエラーによって発信が失敗した場合、Chime は発信を切断し、`Hangup` イベントタイプでエンドポイントを呼び出します。`Hangup` イベントタイプの詳細については、「[Amazon Chime SDK PSTN オーディオサービスを使用した発信の終了](case-5.md)」を参照してください。

発信に応答した場合、Chime は `CALL_ANSWERED` アクションでエンドポイントを呼び出します。この例は、典型的な呼び出しイベントを示しています。

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

この時点で、アクションリストを使用して呼び出しに応答してアクションを返すことができます。アクションを実行しない場合は、空のリストで応答します。 AWS Lambda 呼び出しごとに最大 10 個のアクションで応答でき、呼び出しごとに 1,000 回 Lambda 関数を呼び出すことができます。一連のアクションによる応答の詳細については、「[Amazon Chime SDK PSTN オーディオサービスを使用したアクションリストによる呼び出しへの応答](invoke-on-call-leg.md)」を参照してください。