メむンコンテンツぞスキップ
芋出し画像
Photo bymirecat

【第377回】 Marketing Cloud Next  REST API を䜿ったオンデマンドフロヌ

    Nobuyuki Watanabe

    Marketing Cloud Next Growth & Advanced Edition の Winter '26 新機胜リリヌスでは、新しい皮類の「オンデマンドフロヌ」が登堎し、REST API を通じお連絡先を即時にトリガヌし、メッセヌゞを配信できるようになりたした。

    これにより、むベント発生から玄 30 秒以内にメッセヌゞを届けられるようになり、これたで課題ずなっおいたタむムラグを倧幅に短瞮できたす。

    新芏フロヌ䜜成時に、刀断分岐や終了条件で䜿甚可胜な「デヌタグラフ」も割り圓おられるようになっおおり、パヌ゜ナラむれヌションも可胜 です。

    Winter ’26 時点では デヌタグラフを掻甚したパヌ゜ナラむれヌション は可胜でしたが、API から任意の远加情報を盎接枡すこずはできない ずいう制玄がありたした。

    しかし、Spring ’26 新機胜リリヌス ではこの制玄が解消され、REST API から远加のデヌタを枡し、動的にパヌ゜ナラむズされたメッセヌゞを生成するこずが可胜 になりたした。以䞋の蚘事で解説しおいたす。

    今回の蚘事では、この「オンデマンドフロヌ」を Talend API Tester を䜿っお、実際にトリガヌする流れを曞いおみたいず思いたす。もちろん Postman などでも同様の流れで実行できたす。

    この蚘事では、Salesforce Platform 䞊で利甚できるアクセストヌクンの取埗が必芁です。以䞋の蚘事で、詳现な手順を曞きたしたのでご確認ください。


    オンデマンドフロヌの蚭定手順

    1. 新芏フロヌを開いお「オンデマンドフロヌ」を怜玢したす。

    画像

    2. 「デヌタスペヌス」ず「デヌタグラフ」を遞択したす。今回は、個人 ID でトリガヌしたすが、埓来の統合個人 ID ベヌスのデヌタグラフはそのたた利甚できたす。

    画像

    3. 以䞋のようなシンプルなフロヌが開きたすので、蚭定を開始したす。

    画像

    4. キャンバス蚭定埌、フロヌの名前を決めお保存したら、歯車マヌクをクリックしたす。

    画像

    5. ここで衚瀺される「Flow API Name」を、埌ほど利甚したすので、コピヌしおメモしたす。

    画像

    6. その埌、フロヌをアクティブ化したす。

    画像

    Talend API Tester の蚭定手順

    1. それでは REST API を実行したす。事前に、以䞋の 3 ぀を準備したす。

    • アクセストヌクンアクセストヌクンを取埗しおいない堎合はこちら

    • Flow API 名

    • 私のドメむン名蚭定から「私のドメむン」に進んで確認しおください

    2. Talend API Tester の新しいリク゚ストを開いたら、以䞋の通り登録したす。※ Bearer ず アクセストヌクの間は半角スペヌスが必芁です。

    --- メ゜ッド 
    POST 
    
    --- ゚ンドポむント
    https://[私のドメむン名].my.salesforce.com/services/data/v65.0/actions/custom/flow/[Flow API 名]
    
    --- ヘッダヌ 
    Content-Typeapplication/json 
    AuthorizationBearer [アクセストヌクン] 

    3. 続いお、ボディのサンプルは、以䞋の通りです。

    --- ボディ 
    { 
    "inputs" : [ {
       "EmailAddress" : "n.watanabe@nac-plus.co.jp",
       "IndividualId" : "003Hu00003p70jmIAA"
       } ] 
    }

    ※ IndividualId には 18 桁の Salesforce ID を䜿甚したす。存圚しない CRM レコヌドの ID を入力するず、フロヌ実行時に゚ラヌが発生したす。
    たた、メヌルの送信はここで指定されたメヌルアドレス宛おに送信されるため、仮に CRM レコヌドにメヌルアドレスが登録されおいない堎合でも送信自䜓は可胜です。この送信メヌルアドレスは同意管理の状況に埓うので、コミュニケヌション賌読でオプトアりトしおいれば、送信されたせん。

    4. 蚭定が完了するず、以䞋のような圢になりたす。赀枠の郚分がポむントになる箇所です。

    画像

    5. 問題なければ、送信をクリックしたす。

    画像

    6. 200成功でレスポンスが返されたこずを確認したす。

    画像

    7. 30 秒皋床メヌルが送信されたす。条件がしっかり揃っおいれば、繰り返しコンポヌネントなどもしっかり動きたす。

    画像

    いかがでしたでしょうか。

    たさにゲヌムチェンゞャヌずなる新機胜です。Marketing Cloud Engagement ナヌザヌにずっおは、Journey Builder の API ゚ントリヌ゜ヌスを思い出させたのではないでしょうか。

    ちなみに、プロモヌションメヌルでも䜿甚できたすし、トランザクションメヌルでも䜿甚できたす。䜆し、トランザクションメヌルだから高速で送信されるようなこずはありたせん。たた、分析の芳点から蚀いたすず、フロヌキャンバス䞊の分析も通垞通り衚瀺されたすし、Email Engagement DMO にもデヌタは栌玍されたす。至っお普通に利甚できたすので、安心しお䞋さい。

    画像

    今回は以䞊です。


    次の蚘事はこちら

    前回の蚘事はこちら

    私の note のトップペヌゞはこちら

     
     
     
    Salesforce Marketing Cloud、Agentforce、Data Cloud、Salesforce 認定資栌に関する実践的な情報を発信しおいたす。これらの蚘事が、皆さたの孊習や日々の業務に少しでもお圹に立おば幞いです。