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

# Amazon Connect: AWS Lambda function のフローブロック
<a name="invoke-lambda-function-block"></a>

このトピックでは、 を呼び出すためのフローブロックを定義します AWS Lambda。取得したレスポンスは、[[コンタクト属性の設定](set-contact-attributes.md)] ブロックで使用できます。

## 説明
<a name="invoke-lambda-function-block-description"></a>
+ 呼び出し AWS Lambda。
+ 返されたデータを使用して、[[コンタクト属性の設定](set-contact-attributes.md)] ブロックでコンタクト属性を設定できます。
+ 例については、[チュートリアル: Lambda 関数を作成してフローで呼び出す](connect-lambda-functions.md#tutorial-invokelambda)を参照してください。

## サポートされるチャネル
<a name="invoke-lambda-channels"></a>

次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。


| [チャネル] | サポート対象? | 
| --- | --- | 
| 音声 | はい | 
| Chat | はい | 
| タスク | はい | 
| E メール | はい | 

## フロータイプ
<a name="invoke-lambda-function-block-types"></a>

このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ 着信フロー
+ [Customer Queue flow (顧客キューフロー)]
+ [Customer Hold flow (顧客の保留フロー)]
+ [Customer Whisper flow (顧客ウィスパーフロー)]
+ エージェント保留フロー
+ エージェントウィスパーフロー
+ エージェントへの転送フロー 
+ キューへの転送フロー

## プロパティ
<a name="invoke-lambda-function-block-properties"></a>

次の画像は、**[AWS Lambda 関数]** ブロックの **[プロパティ]** ページを示しています。

![\[AWS Lambda 関数ブロックのプロパティページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/aws-lamdba-function-properties.png)


**[アクションを選択]** ボックスで、以下のオプションから選択します。
+ [Lambda を呼び出す](#properties-invoke-lamdba)
+ [Lambda 結果をロード](#properties-load-lamdba) (非同期的に実行する場合)

### Lambda を呼び出す
<a name="properties-invoke-lamdba"></a>

![\[[アクションを選択] ボックスで設定された [Lambda を呼び出す] と、[実行モード] のオプション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/invoke-lambda-properties2.png)


**[アクションを選択]** を **[Lambda を呼び出す]** に設定する場合は、以下のプロパティに注意してください。
+ **実行モード**:
  + **同期**: [同期] を選択すると、Lambda 呼び出しが完了した後にのみ、コンタクトは次のブロックにルーティングされます。
  + **非同期**: Lambda が完了するのを待たずに、コンタクトは次のブロックにルーティングされます。

    非同期実行モードを使用して呼び出される Lambda を待機するように [[待機](wait.md)] ブロックを設定できます。
+ **タイムアウト**: Lambda がタイムアウトするまでの待機時間を入力します。**[同期モード]** では最大 8 秒、**[非同期モード]** では最大 60 秒を入力できます。

  Lambda 呼び出しが調整されると、リクエストが再試行されます。一般的なサービス障害 (500 エラー) が発生した場合も再試行されます。

  Lambda の呼び出しがエラーを返した場合、Amazon Connect は指定したタイムアウトまでの間に最大 3 回再試行します。その時点で、問い合わせは [**Error (エラー)**] ブランチにルーティングされます。
+ **レスポンスの検証**: Lambda 関数のレスポンスは、STRING\$1MAP または JSON のいずれかです。フローで **[AWS Lambda 関数]** ブロックを設定するときに、これを設定する必要があります。
  + レスポンスの検証を STRING\$1MAP に設定すると、Lambda 関数は文字列型のキーバリューペアのフラットオブジェクトを返します。
  + レスポンスの検証を JSON に設定すると、Lambda 関数は、ネストされた JSON を含む任意の有効な JSON を返します。

### Lambda 結果をロード
<a name="properties-load-lamdba"></a>

![\[Config タブの Lambda AWS Lambda 結果のロードアクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/load-lambda-result.png)


**[アクションを選択]** を **[Lambda 結果をロード]** に設定する場合は、以下のプロパティに注意してください。
+ **Lambda 呼び出し RequestId**: これは、**[非同期モード]** で実行する場合の Lambda の requestId です。

  `$.LambdaInvocation.InvocationId` は、非同期に実行された直近の Lambda の requestId を示します。

**[Lambda 結果をロード]** アクションを選択する場合は、**[Lambda 呼び出し RequestId]** で以下のオプションを選択します。
+ **名前空間** = **Lambda 呼び出し**
+ **キー** = **呼び出し ID**

## 設定のヒント
<a name="invoke-lambda-function-block-tips"></a>
+ フローで AWS Lambda 関数を使用するには、まず関数をインスタンスに追加します。詳細については、「[Amazon Connect インスタンスに Lambda 関数を追加する](connect-lambda-functions.md#add-lambda-function)」を参照してください。
+ 関数をインスタンスに追加したら、ブロックの **[Select a function]** (関数の選択) ドロップダウンリストから関数を選択し、フローで使用することができます。

## 設定されているブロック
<a name="invoke-lambda-function-block-configured"></a>

次の画像は、このブロックが設定されているときの表示例を示しています。**[成功]** と **[エラー]** の 2 つのブランチがあります。ブロックは、**[非同期]** 実行モードに設定されています。**[同期]** 実行モードに設定すると、**[タイムアウト]** ブランチが表示されます。

![\[設定された AWS Lambda 関数ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/invoke-lambda-configured.png)


## サンプルフロー
<a name="invoke-lambda-function-block-samples"></a>

Amazon Connect には、サンプルフローのセットが含まれています。フローデザイナーでサンプルフローにアクセスする方法については、「[Amazon Connect のサンプルフロー](contact-flow-samples.md)」を参照してください。以下のトピックでは、このブロックを含むサンプルフローについて説明します。

[Amazon Connect での Lambda 統合フローのサンプル](sample-lambda-integration.md)

## シナリオ
<a name="invoke-lambda-function-block-scenarios"></a>

このブロックを使用するシナリオについては、次のトピックを参照してください。
+ [AWS Lambda 関数へのアクセスを Amazon Connect に許可する](connect-lambda-functions.md)