エントリーポイントと終了

フローのエントリーポイントとは、フローの開始点のことです。これにより、どのプロファイルがフローに入るかが決まります。

エントリーポイントには様々な種類があります。各エントリーポイントには、プロファイルがフローに入るために満たさなければならない特定の基準があります。

フローに関連するエントリーポイントを選択し、エントリー基準を構成します。

事前定義されたオーディエンス

このエントリーポイントを使用して、特定のタグを持つ、または特定のセグメントの一部であるすべてのプロファイルにコミュニケーションを送信します。

フローを起動する前に、オーディエンスを定義する必要があります。Predefined Audience (事前定義されたオーディエンス) のエントリーポイントの種類に応じて、フローがアクティブな間にオーディエンスを更新できます。

事前定義されたオーディエンスのエントリーポイントには、次の種類があります：

• One-time (1回限り)
• Continuous (連続)
• Recurring (再発)

ユースケースに適したエントリーポイントを選択するには、関連するエントリーポイントの選択 について説明しているセクションをご参照ください。

1回限り

単発のブラストキャンペーンを送信する時は、このエントリーポイントを使用します。

フローを起動すると、事前定義されたオーディエンスが含まれたフローが一度だけ実行されます。

機能

エントリーポイントには次の機能があります。

1 回限りのフロー： フローを起動すると、基準を満たすプロファイルがすべてフローに追加されます。すべてのオーディエンスが終了すると、フローが完了します。

例：Juneというタグを持つすべてのプロファイルをオーディエンスに追加して、フローを起動するとします。フローの起動時に June タグを持つすべてのプロファイルがフローに入ります。フローがアクティブな間、このタグは別のプロファイルに追加されます。ただし、このプロファイルはフローに追加されません。

オーディエンスの事前定義： フローを起動する前に、オーディエンスの基準を定義する必要があります。フローがアクティブであっても、起動後にその基準を更新することはできません。

単一のフローエントリー：選択したオーディエンスはフローに一度だけ入ります。

エレメントの構成

コミュニケーションを送信したい オーディエンスを指定 します。

連続

このエントリーポイントは、進行中の自動キャンペーンに使用します。

フローを起動すると、事前定義されたオーディエンスが含まれたフローが実行されます。この後、フローがアクティブな間は、新しいプロファイルがオーディエンス基準を満たすたびにフローが実行されます。

機能

エントリーポイントには次の機能があります。

連続フロー： フローを起動すると、基準を満たすすべてのプロファイルがフローに追加されます。この後、フローがアクティブな間にプロファイルがオーディエンス基準を満たすと、そのプロファイルも自動的にフローに追加されます。

例： June というタグを持つすべてのプロファイルをオーディエンスに追加し、フローを起動するとします。フローの起動時に June タグを持つすべてのプロファイルがフローに入ります。フローがアクティブな間、このタグは別のプロファイルに追加されます。このプロファイルも自動的にフローに追加されます。

オーディエンスの事前定義： フローを起動する前に、オーディエンスの基準を定義する必要があります。ただし、フローがアクティブな間は、起動後に基準を更新できます。

オーディエンスの手動での追加・削除：フローを起動した後、アクティブな間であれば、手動で オーディエンスを追加または削除 することができます。

複数のフローエントリー： エントリー基準によっては、選択したオーディエンスがフローに複数回入る場合があります。

例外: プロファイルがすでにフロー内にある場合、[フリークエンシーキャップ] や [再エントリー] などの設定により、このプロファイルが再びフローに入れないことがあります。

エレメントの構成

コミュニケーションを送信したい オーディエンスを指定 します。

再発

このエントリーポイントは、月刊のニュースレターなど、送信を繰り返すキャンペーンに使用します。

フローは、アクティブな間、再発の設定に基づいて繰り返し実行されます。

機能

エントリーポイントには次の機能があります。

再発フロー： フローは、アクティブな間、再発の設定に基づいて繰り返し実行されます。

例：タグ June を持つすべてのプロファイルをオーディエンスに追加し、フローを開始しました。再発時に、June タグを持つすべてのプロファイルがフローに入ります。フローがアクティブな間、このタグは別のプロファイルに追加されます。フローが次回繰り返されると、このプロファイルも自動的にフローに追加されます。

オーディエンスの事前定義： フローを起動する前に、オーディエンスの基準を定義する必要があります。ただし、フローがアクティブな間は、起動後に基準を更新できます。

オーディエンスの手動での追加・削除：フローを起動した後、アクティブな間であれば、手動で オーディエンスを追加または削除 することができます。

複数のフローエントリー： 再発の基準によっては、選択したオーディエンスがフローに複数回入る場合があります。

例：同じパーソンが週刊のニュースレターを毎週受け取ることができます。

例外: プロファイルがすでにフロー内にある場合、[フリークエンシーキャップ] や [再エントリー] などの設定により、このプロファイルが再びフローに入れないことがあります。

エレメントの構成

このエントリーポイントへのオーディエンスの追加

構成したオーディエンスがフローに入る頻度を定義します。次のいずれかの繰り返しオプションを選択します：

• Daily (毎日)： 例：日々の予定に関するリマインダー。
• Weekly (毎週)： 例：週刊ニュースレター。
• Monthly (毎月)： 例：毎月の支払いに関するリマインダー。
• Yearly (毎年)： 例：誕生日や記念日のお祝い。

要件に合わせて再発を調整できます。

例：毎月の特定の日付または特定の平日 (毎月第1水曜日など) に対して、毎月の再発を設定できます。

People からオーディエンスを追加

コミュニケーションを送信したい オーディエンスを指定 します。

People からオーディエンスを追加

このセクションのプロセスと画像は、連続 エレメント用です。他の 事前定義されたオーディエンス エレメントについても同じ手順に従います。

1. 選択した 事前定義されたオーディエンス のエントリーポイントの構成ウィンドウで、**Add audience from People (People からオーディエンスを追加)**を選択します。

   

2. 次の基準を1つ以上選択します。各タイプの複数のオプションを選択できます。選択した基準に一致するすべてのプロファイルがオーディエンスに追加されます。

   • タグ：選択したタグを持つすべてのプロファイルを追加します。
   • オーディエンスセグメント：選択したセグメントに属するすべてのプロファイルを追加します。
   • パーソンプロファイル: 選択したすべてのプロファイルを追加します。
   • 企業: 選択したすべての企業を追加します。

   さらにアイテムを表示するには、[View all (すべて表示)] を選択します。

   

   特定のアイテムを検索することもできます。**View all (すべて表示)**を選択すると検索フィールドにアクセスできます。

   

関連するエントリーポイント [#predefined-audience-choose-entry-point] を選択します。

次の情報を使用して、フローに関連するエントリーポイントを選択します。

機能	1回限り	連続	再発
オーディエンスがフローに入る時	フローを起動した時。	フローを起動した時。フロー起動後、オーディエンスが事前定義された基準を満たすたびに。	指定した間隔に基づく。
複数のフローエントリー	いいえ プロファイルは一度だけフローに入ります。	はい	はい
フロー起動後にオーディエンスを手動で追加および削除する	いいえ	はい	はい
シナリオ	1 回限りの短いバーストキャンペーン。 例：季節限定のプロモーション。	進行中の自動化されたキャンペーン。 例：予定のリマインダー。	再発のキャンペーン。 例：週刊ニュースレターの送信。

トリガー

フローは、様々なイベントやアクションでもトリガーできます。つまり、トリガー内で定義されたアクティビティを実行するパーソンがフローに入るということになります。以下のガイドラインは、ビジネスシナリオに最適なトリガーを決定するのに役立ちます。

Peopleプロファイルの変更

このエントリーポイントは、パーソンプロファイルへの変更が指定した条件を満たした時にトリガーされます。

例：コミュニケーションにオプトインしたエンドユーザーにウェルカムメッセージを送信したいとします。Change in people profile (パーソンプロファイルの変更) トリガーで、OptInStatus プロファイル属性が True でなければならないという条件を指定します。このフローは、エンドユーザーの OptInStatus プロファイル属性が True に変更された時にトリガーされます。

また、このトリガーを使用して、パーソンがコミュニケーションフローに入ることができるように、事前に決定した時期まで待機することもできます。

例：エンドユーザーの誕生日にグリーティングを送りたいとします。Change in people profile (パーソンプロファイルの変更) トリガーで、BirthDate プロファイル属性が today であるという条件を指定します。

トリガーの構成

トリガーで、パーソンプロファイル属性、関連する演算子、および条件値を選択します。条件値にフロー変数を使用することもできます。

条件には複数の基準を指定できます。

複数の条件を指定できます。

使用可能な演算子は、パーソン属性のデータ型によって異なります。次の表に、各データ型の演算子が一覧表示されています。List (リスト) データ型のパーソンプロファイル属性を使用することもできます。

ブール値 (真/偽)	テキスト	数 (小数、整数)	日付 (日付、日時)
is	is	is	is
is not (ではない)	is not (ではない)	is not (ではない)	is not (ではない)
is empty (は空)	contains関数	less than (小なり)	before
	does not contain (含まない)	less than or equal (以下)	until (迄に)
	startswith関数	greater than or equal (以上)	since (いつから)
	endswith関数	greaterthan (大なり)	after
	is empty (は空)	is empty (は空)	is empty (は空)
	is empty (は空でない)	is empty (は空でない)	is empty (は空でない)
			is today (は今日)
			will be in (にある)
			will be within (内にある)
			will be more than (を上回る)
			was (であった)
			was within (内にあった)
			was more than (を上回った)

People リアルタイムイベント

このエントリーポイントを使用して、イベントに基づいてフローをトリガーします。例：Webサイトで、Web SDK を使用して addToCart イベントを追跡します。イベント addToCart を People リアルタイムイベント エントリーポイントに追加します。エンドユーザーが Webサイトのカートにアイテムを追加すると、イベントがエンドユーザーのプロファイルに割り当てられ、フローがトリガーされます。

その後、イベントに基づいてフローを分岐できます。例：addToCart イベントが発生したら、フォローアップメッセージを送信します。

このエントリーポイントを使用して、エンドユーザーがWebサイトなどのデジタル資産をどのように操作するか、メッセージにどのように反応するか、およびプロファイル情報に変更があるかどうかを確認します。

イベントの詳細については、Peopleのドキュメントをご参照ください。

トリガーのユースケース

次に、このトリガーの使用例をいくつか示します。

• 放棄されたカート キャンペーンで、選択した商品がまだカートにあることを顧客にリマインドしたい時
• 7 日以内に同じアイテムを 3 回以上表示したエンドユーザーに割引を提供します。
• その他の高度なマルチステップキャンペーン。

トリガーの構成

次の手順に従って、トリガーを構成します。

1. フローをトリガーする必要がある条件を定義します。
2. (任意) 変数に情報を保存します。
3. (任意) 履歴データを含めます。

複数のオーディエンスセグメントを使用して顧客属性を追加する場合は、セグメントオーディエンスエレメントをご参照ください。

詳細については、次のセクションをご参照ください。

条件の定義

フローをトリガーする条件を1つ以上定義します。

各条件で、次の操作を行います：

1. イベントを選択します。
2. イベントの演算子を選択します。アクションを実行した顧客またはアクションを実行しなかった顧客のいずれかをターゲットにすることができます。
3. イベントの基準を定義します。
4. (任意) イベントにプロパティがある場合は、それらを条件に追加してターゲットオーディエンスを絞り込むことができます。

イベントを選択します

イベントを選択します。イベントの詳細については、Events のドキュメントを People にインストールしてください。

次のガイドラインに従ってください。

• カスタム イベントを選択するには、イベントとそのプロパティを People で定義する必要があります。

• チャネル イベントの場合は、コミュニケーションに関する詳細を選択することもできます。例：リンクがクリックされました イベントの場合、リンクがエンドユーザーに送信されたフローの名前を選択します。

  

• 製品イベントでは、人が入ったフローイベントと人がフローを終了したイベントを使用できます。イベント プロパティ フィールドを使用して、以下を追加します。

  • イベントが発生したフローまたはフローバージョン(コミュニケーション)の名前。
  • ときは、イベントが発生した時刻と発生回数。

イベント名で検索し、イベントタイプでフィルタリングできます。

演算子を選択

ターゲットとするエンドユーザーを選択します。

• Happened (起きた)： アクションを実行したエンドユーザーをターゲットにします。発生の時間と回数を設定できます。例：フローをトリガーし、7 日以内にイベントが 3 回目に発生した時にコミュニケーションを送信するには、時刻を 過去 7 日以内 として指定し、発生回数を 3 回 として指定します。

  

• Not happened (起きなかった)：アクションを実行しなかったエンドユーザーをターゲットにします。 例：エンドユーザーが一定期間後にアプリを起動しませんでした。

条件の基準の定義

各イベントには、基準の特定のフィールドがあります。すべてのフィールドに入力します。

条件にイベントプロパティを追加 (任意)

イベントにプロパティがある場合は、それらを条件に追加してターゲットオーディエンスを絞り込むことができます。Property (プロパティ) を選択します。

プロパティを必要な数だけ追加します。

次の図に示す例では、Item viewed イベントのプロパティである itemId がフィルターとして追加されています。

イベントプロパティをフロー変数にマッピング (任意)

イベントにプロパティがある場合は、それらをフロー変数にマップできます。これらの変数は、後でフローで再利用できます。

例：フローで、イベントを待つ エレメントを使用して、エンドユーザーが予定を予約するのを待機します。イベントには、予定時刻 や 予定名 などのプロパティがあります。これらのプロパティはフロー変数として保存できます。フローの後の段階で、これらの変数を使用して、予定の詳細を含む確認メッセージをエンドユーザーに送信できます。

構成によっては、マップされた変数の値は、エンドユーザーがフロー内を移動する時に変化する可能性があります。

例：フローでは、注文 配送状況 を変数として使用します。配信 イベントが次のステージに進むと、配信ステータス 変数が 保留中 から 発送済み に変わります。

リスト属性をフローに渡すことができます。詳細については、イベント内のリストをフローに渡すのドキュメントをご参照ください。

変数の作成と使用に関する詳細については、フロー変数へのイベントプロパティのマッピング について説明しているドキュメントをご参照ください。

履歴データを含める (任意)

このオプションを選択すると、フローの開始前に発生したイベントが含まれます。

フローが開始される前に条件内のすべてのイベントがすでに発生している場合、その人はフローに入りません。ただし、フローが 再発、これらのイベントが再び発生した場合にのみ、その人はフローに入ります。

インバウンドメッセージ

このエントリーポイントは、エンドユーザーが設定した番号に特定のキーワードを送信した時にフローをトリガーします。チャネルに応じて、エンドユーザーは、メッセージ本文、ボタン テキスト、ボタン ペイロードなど、様々な方法でキーワードを送信できます。

このエントリーポイントを使用して、指定した条件に基づいて動的なオーディエンスを作成します。

トリガーの構成

次の手順に従って、トリガーを構成します。

1. トリガーを作成するチャネルを選択します。
2. 受信者を選択。
3. エンドユーザーのメッセージを指定した値と比較する条件を定義します。条件が満たされると、フローがトリガーされます。
4. (任意) インバウンドメッセージの情報を変数に保存します。

詳しくは、下記kの詳細手順をご参照ください。

チャネルの選択

[チャネルと条件] セクションで、トリガーを作成するチャネルを選択します。エンドユーザーとのコミュニケーションは、選択したチャネルを介して行われます。

デフォルトのチャネルはSMS です。別のチャネルを使用するには、既存のチャネルを削除し、必要なチャネルを選択します。

受信者を選択

チャネル名を選択してカードを開きます。宛先受信者 セクションで、受信者を選択します。

インバウンドメッセージの条件定義

エンドユーザーのメッセージを指定した値と比較する条件を定義します。条件が満たされると、フローがトリガーされます。

エントリーポイント内に複数の条件を指定できます。

次の条件を設定できます：

• Message body (メッセージ本文)： メッセージの本文を条件値と比較します。

• Anything (何でも)： このオプションを使用すると、メッセージに条件に含まれていないものが含まれている場合でも、エンドユーザーがフローに入ります。

  完全一致は、Anything (何でも) よりも優先度が高くなります。例：同じエンドユーザーからのメッセージを待機している 2 つのフローがあるとします。1 つのフローでは、条件は yes という単語と完全に一致することです。もう一方のフローでは、条件は Anything (何でも) です。エンドユーザーは はい と応答します。この場合、完全一致キーワードに一致するフローがトリガーされます。

• Button text (ボタンテキスト) (WhatsAppのみ)：エンドユーザーが応答するボタンを選択すると、この条件はボタンのテキストを条件値と比較します。

• ボタンペイロード (WhatsAppのみ):エンドユーザーが応答するボタンを選択すると、この条件はボタンペイロードを条件値と比較します。

条件では、次の演算子を使用します。

• Is equal to person attribute (パーソン属性と等しい) - 選択したパーソン属性がメッセージ本文に含まれているかどうかをチェックします。

  値を比較する場合、大文字と小文字は無視されます。

• Matches text (テキストに一致) - エンドユーザーの応答が条件値と完全に一致するかどうかを確認します。エンドユーザーの応答に条件値のみが含まれ、他には何も含まれていない場合、条件が満たされます。複数の条件値を指定できます。

  例： 条件値： time (時間) エンドユーザーの応答：time (時間)。条件が満たされます。 エンドユーザーの応答：timezone (タイムゾーン)、 time!! (時間!!)、what is the time (何時?) 応答に条件値の一部ではない追加の文字が含まれているため、条件は満たされません。

  値を比較する場合、大文字と小文字は無視されます。

• Matches RegEx (正規表現に一致) - 定義した正規表現パターンがメッセージ本文に含まれているかどうかを確認します。

  Ignore case (大文字と小文字を区別しない) (任意) : 条件を評価する時に大文字と小文字を無視するかどうかを指定します。

  Multiline (複数行) (任意)：このオプションは、メッセージ本文を複数行のテキストと照合する場合に使用します。いずれかの行が一致する場合、検証は成功します。

  

• Contains text (テキストを含む) - メッセージ本文に、条件値で指定したキーワードが含まれているかどうかをチェックします。条件値には、記号やキーワードなどの文字のグループを指定できます。複数の条件値を指定できます。

  例： 条件値： time (時間) エンドユーザーの応答：time (時間)、timeframe (タイムフレーム)、3 times (3回)、time!! (時間!!)、what is the time (何時?) メッセージにキーワードが含まれているため、条件が満たされます。

  値を比較する場合、大文字と小文字は無視されます。

• Contains word (単語を含む) - メッセージ本文に、条件値で指定した正確な単語が含まれているかどうかをチェックします。メッセージ本文の単語には、単語の前後に記号またはスペースを含めることができますが、数字やその他の文字を含めることはできません。

  例： 条件値： time (時間) エンドユーザーの応答：time (時間)。メッセージに正確な単語が含まれているため、条件が満たされます。 エンドユーザーの応答：time!! (時間!!)、what is the time (何時?) メッセージには、単語の前後に記号またはスペースを含む正確な単語が含まれているため、条件が満たされます。 エンドユーザーの応答：times (回数)、timeframe (タイムフレーム)、timezone (タイムゾーン)、3times (3回)。メッセージ内の単語に、条件値の一部ではない追加の文字が含まれているため、条件が満たされません。

  値を比較する場合、大文字と小文字は無視されます。

複数の条件値を指定できます。

システムは、上記の順序に従ってインバウンドメッセージを処理します。そのため、優先順位の高い条件が満たされた場合、フローはその条件に対してアクションを実行し、他の条件を無視します。

インバウンドメッセージ情報を変数に保存

また、インバウンドメッセージ情報をキャプチャーして保存する変数を定義することもできます。

インバウンドメッセージメッセージからキャプチャするデータを定義します。キャプチャできる情報は次のとおりです。

• メッセージ本文
• 受信者
• Sender (送信者)
• Message ID (メッセージ ID)
• ゲートウェイ ID

情報の全部または一部を保存できます。

• 全文： 情報全体を保存します。
• RegExp 解析変数： 正規表現を使って、メッセージコンテンツ内の特定のキーワードをキャプチャします。

詳細については、フロー変数をご参照ください。

インバウンドコール開始

エンドユーザーがお使いの電話番号に電話をかけてきたら、そうしたユーザーをインバウンドコール開始 エントリーポイントを使ってフローに追加できます。このエレメントは、IVR (音声自動応答) のインバウンドコールセッションを開始します。

このエレメントの使用方法の詳細については、IVR (音声自動応答) につじて説明しているドキュメントをご参照ください。

日付または時刻

日付または時刻 トリガーは、時間的制約のあるコミュニケーションに使用します。このトリガーは、People内のパーソンプロファイル に保存されている日付または時刻情報を使用します。

タイミングが重要なメッセージングキャンペーンには、Wait for a Date (日付を待機)フローエレメントを使用することもできます。

前提条件

トリガーを使用するための前提条件は次のとおりです。

• パーソンプロファイルが People に存在する必要があります。
• プロファイルには カスタム属性 に日付または日時が含まれている必要があります。この属性はトリガーで使用します。

カスタム属性の作成

People でカスタム属性を作成します。例：エンドユーザーにアポイントメントについて通知します。AppointmentDateTime カスタム属性を作成します。

属性をパーソンプロファイルに追加し、属性値を更新します。これを行うには、NTT CPaaSのWebインターフェイスの People で手動インポートを使用するか、People API (opens in a new tab)、Web SDK、または Mobile SDK を使用します。

これで、この属性をトリガーで使用できるようになります。

トリガーの構成

トリガーで、カスタム属性、関連する演算子、および条件値を選択します。

(任意) 同じアクションは毎年繰り返すことができます。そうしたい場合、Do this action every year (このアクションは毎年繰り返す) を選択します。このオプションは、カスタム属性の年を無視します。

トリガーの演算子

条件では、次の演算子を使用できます。

Is in： カスタム属性で設定された日付／時刻より以前の特定の期間にメッセージを送信します。この期間は時間単位または日単位で設定できます。

例：パーソンプロファイルには、AppointmentDateTimeカスタム属性に試用期間の詳細があります。アポイントメントの 4 時間前にエンドユーザーに通知したいとします。その場合、次の条件を使用します：

AppointmentDateTime まであと4 時間

エンドユーザーは、現在の日付／時刻が AppointmentDateTime 属性で設定された日付／時刻の 4 時間前になるとフローに入ります。

Was： カスタム属性で設定された日付／時刻より以後の特定の期間にメッセージを送信します。この期間は時間単位または日単位で設定できます。

例：パーソンプロファイルには TrialExpiryDate カスタム属性があります。有効期限の 1 日後にエンドユーザーをフローに含めたいとします。その場合、次の条件を使用します：

TrialExpiryDateは1日前

今日： カスタム属性で設定された日付にメッセージを送信します。

例：パーソンプロファイルには DueDate カスタム属性があります。その場合、次の条件を使用します：

DueDateは今日

明日： カスタム属性で設定した日付の 1 日前にメッセージを送信します。

昨日： カスタム属性で設定した日付の 1 日後にメッセージを送信します。

外部ソース

フローAPIや既存のフローなどを通じて、またはSFTPインポートを使って、外部ソースからコミュニケーションに新しいパーソンを追加します。

フローAPI

フローAPIは、WebページやCRMシステムなどの外部システムから、NTT CPaaSのWebインターフェイスで作成したフローにデータを送信します。このエントリーポイントを使用して、外部トリガーに基づいてフローにパーソンを自動的に追加します。例：エンドユーザーがWebページからフォームを送信した時、またはお使いのCRMシステムに新たなエントリーがあった場合に、ウェルカムメッセージやリードナーチャリング、リマインダーなどのプロセスを自動化できます。

フローAPIを介して変数を転送することもできます。フロー内で変数を作成すると、この変数をフローAPIトリガーで使用できるようになります。

フローAPIでエントリーポイントとしてフローを作成するには、次の操作を行います：

1. NTT CPaaSのWebインターフェイス (opens in a new tab)で、Moments > **Flows (フロー)**に移動します。

2. Create flow (フローの作成) を選択します。

3. Start from scratch (一から開始) を選択します。

4. External source (外部ソース) > Flow API (フローAPI) の順に選択します。

   

   エントリーポイントには、エンドユーザーのデータが送信される一意のURLが含まれています。

   

5. 参加者をフローに自動的に追加するには、次のいずれかの操作を行います：

   • フローへの参加者の追加 (opens in a new tab) エンドポイントを使用すると、1 回のリクエストで最大 1,000 人の参加者をフローに非同期で追加できます。
   • フローへのパーソンの追加 (opens in a new tab) (非推奨) エンドポイントを使用すると、1 回のリクエストで 1 人の参加者をフローに追加できます。
   備考

   フローへのパーソンの追加 エンドポイントは非推奨になりました。新しいフローを作成する時は、代わりに フローに参加者を追加 エンドポイントを使用してください。

   

6. 必要に応じて、フローの他の部分を設定します。

7. フローを Launch (起動) します。

外部システムからデータを受信すると、フローは次の処理を行います：

• Peopleの既存のプロファイルを更新します。
• Peopleで新しいパーソンのプロファイルを作成します。
• そうした新規パーソンをコミュニケーションに追加します。

統合に関する技術情報については、API 開発者ハブ (opens in a new tab)をご参照ください。

フローAPIを使って自動ウェルカムメッセージを送信する方法については、チュートリアルをご参照ください。

既存のフロー

既存のフローのエントリーポイントを フローに追加 と組み合わせて使用すると、強力なモジュラーフローを構築できます。このエントリーポイントは、ユーザーが別のアクティブなフローからフローに参加する最初のステップとして機能します。[フローに追加] エレメントを持つフローは、このエントリーポイントでフローを作成する時に選択できます。

SFTPインポート

SFTPインポートのエントリーポイントは、セキュアファイル転送プロトコル (SFTP) を使用してリモートの外部サーバーからMomentsにcsvデータまたはtsvデータをインポートする場合に使用できます。このアプローチは、フローAPI 経由で外部ソースに接続できない場合に有用です。

Momentsとお使いのサーバー間の接続が確立されると、SFTPコネクタがサーバー上のターゲットフォルダーを3分ごとにチェックするようになります。最後のチェック以降にフォルダーに追加した新しいファイルは、ターゲットフローに追加されます。コネクタによって既に処理されているサーバー内の古いファイルや既存のファイルが、フォルダーから変更、削除、移動されることはありません 。NTT CPaaSでは、いかなる方法においても一切データは変更しません。csvデータやtsvデータはお使いのサーバーでホストされているため、お持ちのデータは常に独自で完全に管理できます。

フローを作成する時に、外部ソース を選択し、SFTP インポート エントリーポイントを選択します。エントリーポイントのサイドバーメニューで、ファイルの処理方法を定義します。

オプション	説明
SFTPサーバー	既存のサーバーの中からSFTP接続に使用するサーバーを選択するか、アップロードするファイルをホストするサーバーへのSFTP接続を新規作成します。[Create New SFTP Connection (SFTP接続の新規作成)] を選択する場合、お使いのサーバーのアドレス、ポートと認証情報を指定する必要があります。接続が成功したかどうかテストして確認し、準備ができたらアクティブ化します。
ファイルパス	フェッチしたいSFTPサーバー上のファイルへのパスを設定します。フローごとに異なるフォルダーがある場合、または部門データごとに異なるフォルダーを使用している場合に適用できます。
ファイル名パターン (任意)	任意のファイル名パターンを設定して命名規則またはパターンのみに従うファイルを抽出し、フローに挿入します。 使用する記号は以下のとおりです： - ワイルドカードのアスタリスク* は、一連の記号をマスクします。例えば、*.csvとすると、すべてのcsvファイルをフェッチします。 - 疑問符 (?)は、特定の記号1つをマスクします。例えば、J???Data.csvとすると、JuneData.csvとJulyData.csvの両ファイルをフェッチします。
区切り文字	ファイル内の値を分割するために使用する区切り文字を選択します。選択した区切り文字は、ファイルで使用されている区切り文字と必ず一致していなければなりません。; (セミコロン)、| (パイプ)、タブ、カスタム (いずれかの文字、最大1文字)、, (コンマ)
列マッピング	ファイル列をフローの正確な属性／変数にマップします。これは、システムが自動的にファイルの構造を認識しないためです。 ここに入力する値がファイル内の列名 と完全に一致していることを確認し、すべてのデータ型が一致していることも確認します。システムは、一致しないデータ型を正しく「読み取る」ことができません。例えば、日付フィールドで日時データ型を使用する場合、ファイルのアップロード時にエラーが表示されることがあります。 次のセクションを使用できます。 - 連絡先情報：連絡先情報 (電話番号／メールアドレス) の列を少なくとも1つ用意する必要があります。 連絡先情報列の上限は 2 つで、1 列は電話番号、もう 1 列はメール アドレスです。 csv のエントリーの連絡先情報が正しくない場合、そのエントリーは無効としてマークされ、処理されません。 エントリに正しい電話番号と電子メール アドレスの両方が指定されているシナリオでは、エントリはコネクタによって処理され、SFTP インポート パフォーマンス レポートで 有効 としてマークされます。 連絡先情報の1つが有効で、もう1つが無効である場合、エントリーはシステムによって 無効としてマークされ、処理されません。 ただし、連絡先情報の1つが有効で、もう1つの連絡先情報が 空である (連絡先情報が提供されていない) 場合は、エントリー全体が 有効としてカウントされ、システムによって処理されます。 SFTPインポートのパフォーマンスデータにSFTP Import (SFTPインポート) のReport (レポート) タブのView Flow Performance (フローパフォーマンスの表示) に表示される有効と無効のエントリーが含まれているのが見えます。 - パーソン属性： パーソナライゼーション／セグメンテーションのためにフローで使用される標準／カスタム 属性のことです。ここで使用するすべての属性は、インポート前に People で作成する必要があります。 - 変数： この情報を People (セッションベースのデータ) に保持したくない場合に使用します。ここで使用する 変数は、インポートする前にMomentsで作成する必要があります。

インポートスケジュールの例

ジェーンは 12:00 に Folder1 にFile_Aをアップロードします (この時点では、Folder1 にはこのファイルのみが含まれています)。SFTPコネクターは 12:01 にフォルダーをチェックし、File_A から Moments のターゲットフローにデータを送信します。12:02 に、ジェーンは Folder1 にFile_Bをアップロードします (フォルダー 1 には File_A と File_B が含まれています)。SFTPコネクターは 12:03 にフォルダーを再度チェックし、File_Bからターゲットフローにデータを送信します (File_Aは以前の実行で既に処理されているため)。

SFTPインポートを介して作成された新しいユーザーは、システムにどのように入ったかを示すために、Peopleで一意の識別子でマークされます。その後、このデータをフィルタリングして、システム内のこれらのユーザーを追跡できます。

ユーザーが [SFTPインポート]エントリーポイントを含むフローを複製した場合、元のフローで最初にアップロードされたすべてのファイルが、最初にアップロードされたファイルから新しいフローにアップロードされます。

アップロード履歴は複製プロセスで保持されないため、新しいフローには元のフローで何が起こったかの記録がありません。新しいフローがアクティブになると、すべてのファイルデータが再度追加されます。フローの目的によっては、予期しない結果が生じる場合があります。これは、以下の警告メッセージで説明されているように、リスクです。

SFTP サーバー接続の管理

SFTP インポート エントリーポイントを開き、[SFTP サーバー] フィールドに移動して、SFTP サーバーへの接続を管理します。

ここでは、ドロップダウンリストからサーバーを選択し、鉛筆アイコンをクリックして接続の編集ポップアップを展開して、新しい接続を作成するか、既存の接続を編集できます。

編集モードでは、接続を使用しているフローの数が表示されます。データの整合性を確保するために、この接続を使用するすべてのフローが終了するまで、サーバーに加えた編集は保存できません。See n instances (n 個のインスタンスを表示) ボタンをクリックして、接続を使用しているフローを表示します。

特定の接続にどのフローも接続されていない場合は、必要に応じて接続を編集できます。接続をテストして、すべてが正しく機能することを確認することを忘れないでください。

フローバージョンの管理

[SFTPインポート]エントリーポイントを使用している既存のフローまたはアクティブなフローに変更を加えたい場合、フローのバージョンの新規作成 を行えば、それができるようになります。

新しいフローバージョンを起動すると、元のフローバージョンで未処理だった記録が、新しいフローバージョンに転送されます。

終了

フローの準備ができたら、次のステップは検証です。Validate (検証) をクリックすると、報告するエラーがない場合、フロー内の接続されていない各エレメントの後に Exit (終了) エレメントが自動的に表示されます。IVR (音声自動応答)フローに関しては、終了エレメントがアクティブコールを終了します。そのため、まだ通話中の状態でコミュニケーションを検証することにした場合、そのコールは終了します。

[Exit (終了)] は、特定のコミュニケーションのブランチからフローを終了した顧客の数を計算するのにも役立ちます。