会員登録から施策実行を自動化するフローAPI連携

新規登録という重要なタイミングを逃さず、フローAPIを活用して即時に施策を自動実行するための具体的な手順を解説します。

2026/03/24

目的

ユーザーの行動をトリガーに施策をうつことでよりユーザー体験の向上につながります。
新規登録という重要なタイミングを逃さず、フローAPIを活用して即時に施策を自動実行するための具体的な手順を解説します。

サービス

▶ アカウントをお持ちでない方へ｜60日間無料トライアルを開始

チュートリアルの内容は、トライアル環境ですぐにお試しいただけます。クレジットカード情報の登録は不要、自動で課金されることもありません。送信テストや動作確認に、ぜひ無料トライアルをご活用ください。

事前準備

ステップ1:フローAPIで利用するAPIについて

https://ib.nttcpaas.com/docs/api/customer-engagement/moments/add-flow-participant

フローAPIでは上記のドキュメントのAPIを利用します。

必須項目として以下の項目があります。

cmpaignId: フローの識別子　※確認方法はステップ2にて記載
participants: フローへの参加者の情報
- ・identifyBy: フローへの参加者の識別子
  - ・type: ユーザーの識別を行う値を設定
  - ・identifier: フローに参加させるユーザーのID
  - ※設定する値は上のtypeにより変わります

メールアドレスが「user@example.com」のユーザーをフローにエントリーさせ、姓「山田」、名「太郎」を連携するためのサンプルコード（Python）は以下のようになります。

import http.client
import json

conn = http.client.HTTPSConnection("{xxx}.ibapi.nttcpaas.com")
payload = json.dumps({
  "participants": [
    {
      "identifyBy": {
        "identifier": "user@example.com",
        "type": "EMAIL"
      },
      "person": {
        "lastName": "山田",
        "firstName": "太郎"
      }
    }
  ]
})

headers = {
  'Authorization': '{authorization}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

conn.request("POST", "/moments/1/flows/{yyyyyyyyyyyyyyy}/participants", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

補足: ※conn内「{xxx}」には、各テナントのドメインを設定します。（NTT CPaaSログイン状態でAPIドキュメントを開くと、自動で表示されます。）; ※「{yyyyyyyyyyyyyy}」にはフローのcampaignIdを設定します。
※「{authorization}」には「<APIキー>」の値など認証情報を設定します。

ステップ2: campaignId（フローの識別子）の確認方法

campaignIdはフローを開いた際のURLから確認できます。
画像の例では、「200000036065250」になります。

実施手順

このユースケースの手順は、次の3つのセクションに分かれています。

プロファイル属性の準備
フローの構成
APIの実行

ステップ1:プロファイル属性の準備

今回のシナリオでは、会員登録日を利用して待機、クーポンの利用有無を判定して分岐を行います。
そのために事前にプロファイルのカスタム属性を作成します。

①People > 構成 > パーソンカスタム属性を開き、「カスタム属性を作成」から新規の属性を作成します。

②属性の名前とデータのタイプを選択し保存をクリックします。

今回は、以下の2つを作成します。

1) 属性の名前を「会員登録日」、データタイプを「日付」に設定します。

2) 属性の名前を「クーポン利用判定」、データタイプを「真/偽 (Boolean)」に設定します。

ステップ2:フローの構成

全体の構成は以下のようになります。

新規会員登録が行われフローAPIが実行されたら、クーポン付きのお礼メールを送信、その後クーポンの期日の前日の15:00にもメールを送信するシナリオになります。

①フローのエントリーポイントとして「フローAPI」を設定します。
フローの作成から外部ソース > フローAPI を選択します。

②「パーソンプロファイルを更新」の設定をし、用意したカスタム属性「会員登録日」に当日の日付を格納します。

{register_date}はフロー変数という、フロー内でのみ利用できる変数を設定します。フロー変数はフローの設定から可能です。

today()関数を利用して、当日の日付を設定することで会員登録が行われた日を設定できるようにします。

③メールの送信を設定し、会員登録時のメールコンテンツを準備します。
今回はすでに作成済みのお礼メールを設定します。「既存のメッセージを選択」から、該当のメールを検索・クリックします。

今回のメールには会員登録のお礼とクーポン獲得用の画像(URL)を含めています。

補足: プレースホルダーについて
{$lastName}、{$firstName}は、プレースホルダーというCPaaS内に保存されているプロファイルの属性などを差し込むものです。
テキストブロックを選択後、プレースホルダー > 標準の属性からLastName(姓)とFirstName(名)をメールに表示するようにします。
姓、名の情報はAPI実行時に連携します。