統合

Flowのインテグレーションエレメントを使用して、外部プラットフォームと接続します。

チャットをエージェントに転送する

このエレメントを使用して、テキストベースのチャットのためにエンドユーザーをライブエージェントに転送します。

エレメントを構成する

(オプション)エレメントのサイドパネルで、会話 タグ を割り当てて、次の操作を行います。

• フローを Conversations の関連するキューにルーティングします。
• 会話の内容をエージェントに通知します。例: データ検証 というタグを追加して、エージェントがエンドユーザーの情報を検証する必要があることを示します。

すべての会話タグ セクションで、新しいタグを作成するか、1 つ以上の既存のタグを選択します。

例

このエレメントの使用方法の例については、効率的なサインアップとアカウント検証を設定するチュートリアルを参照してください。

このエレメントは通話セッションで使用します

このエレメントは、次の例に示すように、コール (IVR (自動音声応答) ) セッションで使用できます。

1. Playエレメントを使用して、エンドユーザーが利用可能なエージェントを回線で待機するか、WhatsAppなどのテキストベースのチャネルを使用するかを尋ねます。

   例：

   *エージェントとテキストベースのチャットを行うには、1を選択します。待ち時間は1分です。

   *電話でエージェントと話す場合は、2を選択します。待ち時間は12分です。

2. エンド ユーザーがテキストベースのチャネルを使用する場合は、音声セッションを 電話を切る し、エージェントにチャットを転送する エレメントを追加します。

3. 終了ユーザーがエージェントを待機する場合は、Transfer call to agent エレメントを使用します。

エージェントへの通話の転送

このエレメントを使用して、音声 (IVR （自動音声応答）) 通話を Conversations のライブ エージェントに転送します。

エレメントの設定 を使用し、エレメントの branches を使用して、フローの次のステップを指定します。

エレメントを構成する

エレメントのサイドパネルで、次のフィールドを設定します。

発信元

このフィールドを使用して、会話に関するコンテキストをエージェントに提供します。例: 予定を再スケジュールする。Conversations では、この情報はポップアップ メッセージとして表示されます。

通話元の追加 を選択し、コンテキストを指定します。

このフィールドを設定しない場合は、フロー名がコンテキストとして使用されます。

会話タグ

(オプション)会話 タグ を割り当てて、次の操作を行います。

• フローを Conversations の関連するキューにルーティングします。
• 会話の内容をエージェントに通知します。例: データ検証 というタグを追加して、エージェントがエンドユーザーの情報を検証する必要があることを示します。

すべての会話タグ セクションで、新しいタグを作成するか、1 つ以上の既存のタグを選択します。

次のステップ

エレメントの次のブランチを使用して、次の手順を管理します。

枝	通話セッションの状態
転送された通話	コールが転送されました。エンド ユーザーと宛先の間でコール セッションが正常に確立されました。フローは通話セッションを終了しました。
通話が転送されませんでした	フローは通話を転送できませんでした。エンド ユーザーと宛先の間でコール セッションが確立されませんでした。コール セッションは、エンド ユーザーとフローの間で続行されます。
通話が終了しました	コールは、転送される前に、エンド ユーザーによって、またはネットワークの問題のために終了しました。

通話を音声アプリケーションに転送する

このエレメントを使用して、音声 (IVR (自動音声応答) ) 通話をフローからカスタム Calls API アプリケーションに転送します。これにより、アプリケーション内の呼び出しを管理できます。

前提条件

• IVR （自動音声応答） コールの転送先となる Calls API ベースのアプリケーション (opens in a new tab) 。アプリケーションは、アプリケーション転送要求イベントを処理できる必要があります。
• 一意の ID を持つ コール設定 (opens in a new tab) 。

エレメントを構成する

エレメントのサイドパネルで、次のフィールドを設定します。

• 呼び出し構成 ID: アプリケーションの呼び出し構成 ID を選択します。
• カスタム データ (省略可能): 必要に応じて、キーと値のペアを使用してカスタム データを追加します。このデータはアプリケーションに送信されます。

次のステップ

エレメント内の出口ブランチごとに、次のステップを構成します。

次の表に、各ブランチの説明を示します。

出来事	形容
通話が転送されました	フローは、IVR （自動音声応答）呼び出しをアプリケーションに転送しました。エンド ユーザーとアプリケーションの間で呼び出しセッションが正常に確立されました。フローは通話セッションを終了しました。
通話が転送されませんでした	フローは、IVR （自動音声応答）呼び出しをアプリケーションに転送できませんでした。これにはいくつかの理由が考えられます。例: API 呼び出しが失敗しました。エンド ユーザーとアプリケーションの間で呼び出しセッションが確立されませんでした。コール セッションは、エンド ユーザーとフローの間で続行されます。
通話が終了しました	IVR （自動音声応答） コールは、転送される前に、終了ユーザーまでに、またはネットワークの問題のために終了しました。

エレメントの機能をテストする

音声アプリケーションへの通話の転送 エレメントの機能を確認するには、カスタム Webhook を使用します。フローから Webhook への通話の転送をテストします。

通話転送用にシステムをセットアップする

1. IVR （自動音声応答） コールの転送先となる Webhook を設定します。
2. 一意の ID を持つ Calls 構成 (opens in a new tab) を作成します。
3. 通知プロファイルを作成します。
   • Webhook の URL を使用します。
4. サブスクリプションを作成します。
   • Voice チャンネルを選択します。
   • 必要なイベントを選択します。
   • 作成した通知プロファイルを選択します。

フローを構成する

1. フロー の IVR （自動音声応答） セッションで、通話を音声アプリケーションに転送する エレメントを追加します。

2. エレメントで次のフィールドを設定します。

   • 通話構成 ID: 作成した通話構成 ID を選択します。
   • カスタム データ (省略可能): 必要に応じて、キーと値のペアを使用してカスタム データを追加します。このデータは、要求本文で Webhook に送信されます。
   

3. エレメント内の出口ブランチごとに、次のステップを構成します。

4. 必要に応じてフローを設定します。

5. フローをアクティブにします。

これで、Webhook で呼び出し情報を取得できるようになりました。

Start チャットボット (Answers)

Start チャットボット (Answers) エレメントを使用して、フローからAnswers チャットボットに終了ユーザーを指示します。チャットボットセッションが終了すると、終了ユーザーはフローに戻ります。

前提条件

• Answers enabled を Infobip アカウントで作成します。そうして初めて、フロー内のStartチャットボット(Answers) エレメントにアクセスできます。

• SMS、Viber、WhatsAppなどのテキストベースのチャネルを使用するアクティブなAnswersチャットボット。チャットボットを作成するには、Answersドキュメントを参照してください。

  Answers チャットボットは、フローで使用されているものと同じチャネルと送信者を使用する必要があります。

フローを設計するための基準

• チャットボット セッションは、エンド ユーザーから最初のメッセージを受信した後にのみ開始できます。受信メッセージの評価 エレメントを使用して、エンド ユーザーのメッセージを取得します。
• Start チャットボット (Answers) エレメントは、受信メッセージエレメントの評価 の後にのみ追加できます。したがって、これら 2 つの要素はフロー内の同じブランチにある必要があります。
• エージェントへの転送はフローで行う必要があります。チャットボットにエージェント エレメントが含まれていて、エンドユーザーがこのエレメントに到達した場合、エンドユーザーはフローに戻ります。フローのエージェントへのチャットの転送(統合#チャットからエージェントへの統合の転送) エレメントを使用して、エンド ユーザーをエージェントに接続します。

プロセスの概要

1. 受信メッセージの評価 エレメントからの終了ユーザーのメッセージは、LastInboundMessage 変数を介して Start チャットボット (Answers) エレメントに送信されます。
2. 終了ユーザーが Start チャットボット (Answers) エレメントに達すると、フローは、受信メッセージの評価 エレメントで構成されているのと同じチャネルと送信者を使用するチャットボットを自動的に選択します。
3. チャットボットは、Start チャットボット (Answers) エレメントからメッセージを受信します。
4. チャットボットセッションが開始され、終了ユーザーがチャットボットにリダイレクトされます。
5. チャットボットセッションが終了すると、終了ユーザーはフローに戻ります。
6. エンドユーザーは、フロー設定に基づいてジャーニーを続行します。

フローの作成

1. 受信メッセージの評価 エレメントをフローに追加します。

2. 送信者と条件をエレメントで構成します。

3. Start チャットボット (Answers) エレメントを同じブランチに追加します。

4. エレメントで次のフィールドを設定します。

   • チャットボットの送信者: このフィールドには、受信メッセージの評価 エレメントの 宛先受信者 フィールドの送信者が事前に入力されています。

     受信メッセージの評価 エレメントで送信者を更新する場合は、Start チャットボット (Answers) エレメントで送信者を更新する必要があります。これを行うには、チャットボット 送信者の更新 を選択します。

     

   • チャットボットが受信したメッセージ: このフィールドには、既定で LastInboundMessage 変数が含まれています。チャットボットと共有する追加情報とコンテキストを指定します。

     このフィールドの内容はチャットボットに送信されます。

   • 条件 (オプション): 1 つ以上の終了条件を選択して、チャットボット セッションで発生する内容に基づいてフローをリダイレクトします。Start チャットボット (Answers) エレメントでは、選択した条件ごとに出口分岐が自動的に追加されます。

     

5. Start チャットボット (Answers) エレメントの出口分岐ごとに、次の手順を構成します。

次の表に、各条件の説明と、条件の次の手順の例を示します。

条件	形容	次のステップの例
セッションが開始されていません	チャットボット セッションを開始できませんでした。これにはいくつかの理由が考えられます。例: フローがアクティブ化された後、チャットボットが非アクティブ化されました。
セッションが外部で終了しました (新しいセッションが開始されました)	新しい外部セッションが開始されたため、チャットボットセッションが終了しました。例: エンド ユーザーに対して Conversations を介して新しいセッションが開始されました。
セッションがタイムアウトによって期限切れになりました	チャットボットがエンド ユーザーから応答を受信しなかったため、チャットボット セッションがタイムアウトしました。	翌日にエンドユーザーを再ターゲットして、リクエストが正常に解決されたかどうかを確認します。
クローズ・セッション・エレメントによるクローズ	チャットボット セッションは、チャットボットの セッションを閉じる エレメントによって終了しました。
チャットボットの無効化	チャットボットは、エンドユーザーがチャットボットセッション中に非アクティブ化されました。
エージェントへのリダイレクトに失敗しました	チャットボットは会話をエージェントに転送できませんでした。	チャットをエージェントに転送 エレメントをこのブランチに追加して、エンド ユーザーをエージェントにリダイレクトします。
セッションがユーザーによって終了しました	終了ユーザーがチャットボットセッションを終了しました。

解析学

Start チャットボット (Answers) エレメントの分析を表示するには、フローのエレメントにカーソルを合わせます。

Add to Flow (フローを追加)

[フローに追加] エレメントは、ユーザーを別の "セカンダリ" フローに送信する場合に使用します。これは、非常に複雑なフローをより小さく、より管理しやすいフローに分割するのに役立つモジュラーフローの作成に貢献する非常に強力なエレメントです。 詳細については、モジュラーフローのすべての利点とそれらを使用するタイミングをキャプチャし、ドキュメントのモジュラーフローの利点セクションにいくつかの例を提供しました。

[Add to Flow (フローを追加)] エレメントは、フロー内の任意の位置で使用できます。[ exit (終了) ] エレメントの直前に [Add to Flow (フローを追加)] エレメントを使用すると、ユーザーは現在のフローを終了し、定義した別のフローに移動します。一方、フローの別のステップ（最後のステップ以外）にエレメントを追加した場合、ユーザーは両方のフローでジャーニーを続行します。

変数と変数値は、[Add to Flow (フローを追加)] エレメントを使用して、フローから選択したフローに移動することもできます。これにより、ユーザーがフロー間を移動するときに、対応するプレースホルダーのデータも確実に移動されます。

また、グッドプラクティスとして、[Add to Flow (フローを追加)] エレメントの「in all other cases (その他のすべての場合)」にフェイルオーバーのブランチを含めておくことをお勧めします。これにより、ユーザーをセカンダリフローに転送できない場合（たとえば、セカンダリフローが下書きに設定されている場合やキャンセルされている場合）でも、ユーザーはジャーニーを続行できます。

Secondary Flow Participants（セカンダリフローの参加者）

デフォルトでは、[Add to Flow (フローを追加)] エレメントを通過するユーザーはすべて、セカンダリフローにも入るようになっています。ユーザーはフローを終了するまで、プライマリフローとセカンダリフローの両方に参加することになります。

また、連絡先情報に基づいて別のユーザーがフローを通過できるようにエレメントを構成することもできます。これを行うには、[Add to Flow (フローを追加)] エレメントを追加するときに、別の参加者を追加するように切り替えます。すると、この参加者に使用する主要連絡先情報（電話番号またはメール）でフロー変数、または現在フローに参加している人の標準／カスタム属性に一致するものを定義できるようになります

参加者がPeopleにいる場合、連絡先情報によって識別されるユーザーに対してフローが開始され、フロー内で言及されている属性はすべて更新されます。ユーザーがPeopleにいない場合は、そのユーザーのプロファイルが作成され、属性値がプロファイルに割り当てられます。

セカンダリフロー参加者機能を使用する良いユースケースは、紹介プログラムがクライアントに友人や家族の連絡先情報を共有して特典を受けさせることです。たとえば、メッセンジャーで友人のメールを共有するようにクライアントに依頼します。次に、受信メッセージから電子メールを解析し、値を変数に保存します。

これにより、[Add to Flow (フローを追加)] エレメントを使用して、変数から抽出された連絡先情報とメールで、別のユーザーのフローを開始できるようになります。これはリーチを拡大するための優れた方法ですが、お住まいの地域のデータ要件を順守するため、友人や家族からは必ずオプトインの承諾を得るようにしてください。

Call API（APIコール）

コール API を使用すると、フローと外部システム (Web サイトや CRM など) とのリアルタイムの対話が可能になります。このエレメントを使用して、サードパーティのシステムまたはデータベースから情報を要求し、応答をフロー変数に保存します。その後、応答を使用して通信をパーソナライズし、通信フローをルーティングできます。

エレメントのサイドパネルで、次のフィールドを設定します。

依頼

次の要求パラメーターを構成します。

リクエスト URL

フローが通信するサードパーティシステムの URL。サード・パーティー・サービスは、フローが必要とするデータを受信または送信します。

予約文字、安全でない文字、および非 ASCII 文字を含む属性が URL に含まれている場合は、[URL 文字のエスケープを有効にする] を選択します。

方式

API を呼び出すために使用されるメソッド。各方法は、さまざまなユースケースに使用されます。

次のいずれかの方法を選択します。

• POST: 呼び出される API は、指定された要求を処理する必要があります。多くの場合、POSTは、サードパーティシステムで新しいエンティティを作成したり、既存のを更新したりするために使用されます。
• GET: サードパーティのシステムから情報を取得するために使用されます。
• PUT: サードパーティのシステムに情報を保存するために使用されます。
• DELETE: サードパーティのシステムから情報を削除するために使用します。
• パッチ: サードパーティシステムの情報を部分的に変更するために使用されます。

ヘッダ

URLと共に送信する必要があるデータのヘッダー。

データを Key-Value 形式で入力します。

例：

*ユーザー名:user1
パスワード:password123 *

既定では、ヘッダーは空です。ただし、ほとんどの Web フレームワークとサービスでは、要求を正しく処理するために要求に content-type ヘッダーが必要です。そのため、ヘッダーを含めることをお勧めします。

例: JSON 形式でデータを送信する場合は、Key として Content-type 、Value として application/json を含むヘッダーを追加します。

体

URL と共に送信する必要があるデータの本文。

データは、次のいずれかの形式で入力できます。

• キーと値の形式: 例 - 名前: Tom、または外部ユーザー ID。

• JSON 形式: 例 - {'name': 'Tom'}.この形式は、次の型をサポートしています。

  • JSON: 既定では、データは JSON として送信されます。
  • URL エンコード形式: この形式でデータを送信するには、Key として Content-type を、Value として application/x-www-form-urlencoded を含むヘッダーを追加します。

各 API 呼び出しを承認する

すべての呼び出しを承認するには、次の操作を行います。

• ヘッダー に、ユーザー名とパスワードを入力します。
• Body で、API 呼び出しに含める各エンド ユーザー プロファイルの外部 ID を渡します。これにより、サードパーティシステムは、どのエンドユーザーのデータを保存またはフェッチする必要があるかを知ることができます。エンド ユーザー プロファイルの外部 ID は People に格納されます。

応答

次の応答パラメーターを構成します。

応答が受信されるまで待機します

フローの次のステップを応答の受信後にのみアクティブにする場合は、このオプションを有効にします。

応答ヘッダー変数

サーバーが、ステータス LINE に配置できない応答に関する追加情報を渡すことができるようにします。ヘッダー フィールドは、サーバーに関する情報と、Request-URI によって識別されるリソースへのさらなるアクセスを提供します。

応答本文変数

外部システムから受信したAPIデータをフロー変数に保存し、フローの残りの部分で使用することができます。

フロー変数への保存は、次のいずれかの方法で行うことができます。

• JSON パス
• 応答の本文全体を保存する

JSON パスを保存する

データを変数に保存するには、次の操作を行います。

1. 本文応答 フィールドで、JSON パス を選択します。
2. データを変数に保存するには、$ などの JSON パス式を入力します。loyalty_points です。パスは 1 つの値を指す必要があります。値が配列またはオブジェクトの場合、エラーと見なされ、変数は NULL に設定されます。
3. 変数 フィールドで、フロー変数を選択します。

応答の本文全体を保存する

本文全体を保存できるのは、テキスト または ファイル 型のフロー変数のみです。

1. Body response フィールドで、Whole body を選択します。
2. 変数 フィールドで、フロー変数を選択します。
3. フロー変数が ファイル 型の場合は、ファイル名 とその拡張子を追加します。

状態コードを処理する

応答が受信されたかどうか、および応答状態コードに基づいてフローを分岐できます。必要なステータスコードを選択します。状態コードごとに、呼び出し API エレメントに分岐が追加されます。各ブランチに対して実行するアクションを指定します。

応答状態コードには、次の種類があります。

• 成功時 - 終了:2XXエラーの場合。アクションは必要ありません。
• エラー時 - 終了: エラーが発生した場合。
• すべてのクライアント エラー コード - 終了: 4XX エラーの場合。
• サーバーエラーコード - 終了:5XXエラーの場合。

スケジューリング

スケジュール オプションは、データ交換の合理化に役立ちます。スケジュール設定を開始するには、スケジュール タブで次の機能の 1 つ以上を有効にします。

納期

フローがサードパーティシステムと通信する期間を設定します。

詳細については、配信時間枠 のドキュメントを参照してください。

メッセージ送信速度の定義

特定の期間内に配信するメッセージの数を指定します。

詳細については、メッセージ送信速度 のドキュメントを参照してください。

[Custom Exchange (カスタムExchange)] エレメント

Exchange でカスタム要素を作成し、フローで使用してフローに新しい機能を追加します。

例: カスタムエレメントを作成して、フローをサードパーティシステムと統合します。サードパーティの API を呼び出し、応答に基づいてフロージャーニーをパーソナライズします。

エレメントを一度構成すると、複数の通信で再利用できます。

以下は、ユースケースの例です。

• フローをウェビナープラットフォームと統合して、エンドユーザーを会議に自動的に登録します。
• フローをGenAIプラットフォームに接続して、フロー内でパーソナライズされたコンテンツを生成します。
• フローをCRMに接続して、データを転送したり、特定のグループにプロファイルを追加したりします。

詳細については、[Infobip を使用した開発](/infobip を使用した開発#モーメント-フロー-エレメント-統合ポイント-) のドキュメントを参照してください。