対象プランオプション機能
本ページではワークフローを利用し、EventHubの出展フォームからリードスキャンで読み取った名刺情報をHubSpotに自動登録するためのテンプレートレシピをご紹介します。
<tips>本機能は有償のオプション機能です。利用を希望する場合は、ワークフローとはをご確認の上、担当のカスタマーサクセス または 画面右下にある吹き出しマークからカスタマーサポートへお問い合わせください。</tips>
1. レシピの概要
EventHubの出展フォームからリードスキャンで読み取った名刺情報のメールアドレスをキーに以下を実施します。
- リードスキャンで新規ユーザー登録があると、ユーザー登録Webhookが発火
-
HubSpot内のコンタクトをメールアドレスをキーに検索
- 一致するコンタクトが存在する場合は情報を「更新」し、リストに追加
- 一致するコンタクトがない場合は、コンタクトを「新規作成」し、リストに追加
HubSpot内に重複するメールアドレスが存在している場合は、重複ユーザーのデータは連携されません。重複するメールアドレスが存在していても連携させたい場合は、貴社自身でHubSpotの仕様に合わせてレシピをカスタマイズしていただきますようお願いいたします。
<attention>本レシピは、リードスキャンにてユーザー登録Webhookが発火した場合（＝新規ユーザー登録時）に連携が行われます。既存ユーザー情報が更新された場合には発火しません。既存ユーザー更新時のデータも連携したい場合は、本レシピの内容を参考にユーザー更新Webhookをトリガーとしたレシピをご実装ください。</attention>
2. 利用するテンプレートレシピ
本ヘルプページでご紹介しているレシピは、ワークフロー上のPROJECTSからご確認いただけます。
ご利用するレシピは、レシピを利用するよりダウンロードしてください。
3. 事前準備：WorkatoとHubSpotを連携させる
連携を開始するために必要な事前準備として、WorkatoとHubSpot間の認証設定が必要です。認証設定が完了していない場合は、【事前準備】 WorkatoとHubSpotを連携するための認証設定 をご確認の上、設定を完了させてください。
4.出展フォームのプロフィール項目を作成する
本レシピでは、EventHubのユーザー登録のWebhookからWorkatoへ送信される情報（詳細はこちら）を元に、ワークフロー上でHubSpotに渡したい項目をマッピングし、EventHubに登録されたユーザー情報をHubSpotに自動登録する処理を行っています。
まずはじめに、出展フォーム経由の登録者からどういったプロフィール項目を取得するかEventHub管理画面上部の[出展イベント一覧]から設定してください。EventHubで取得した項目のうち、HubSpotに連携したい項目がある場合は、HubSpotのプロパティと同様のカスタム項目を作成する必要があります。
作成方法の詳細はLead Scan：出展イベント・出展フォームを作成するをご確認ください。
5. ワークフローにログインする
① EventHubの管理画面から[設定]＞[ワークフロー]をクリックし、[利用する]を選択します。
<tips> -ワークフローのメニューが表示されない場合は、担当のカスタマーサクセスサクセス または 画面右下にある吹き出しマークからカスタマーサポートへお問い合わせください。
-メニューは表示されるものの、うまくログインできない場合はセッションが切れている可能性があります。一度EventHubの管理画面をリロードしてください。</tips>
6. 該当レシピ上でWebhookを発火させる
該当レシピの1行目のWebhookを編集します。初期レシピはデフォルトで設定されているWebhookの値になるため、貴社管理画面から送信されたWebhook情報がトリガーになるよう[Reset]をクリックし、Webhookを新規に設定し直します。出展フォームで作成した最新のプロフィール項目を一括で取得することができます。
設定方法の詳細は、ワークフロー：トリガーに設定しているWebhookを発火させるをご確認ください。
出展フォームで作成したプロフィール項目を1つずつ追加する方法
プロフィール項目を一括で取得する方法以外に、以下の手順でプロフィール項目を1つずつ追加することも可能です。
①1行目の[Eh参加登録 via HTTP webhook]をクリックし、Payload schemeにある[+ Add Field]を選択します。
② 追加したいプロフィール項目を設定します。
| Name | 追加するプロフィール項目の名称を入力します。 例: customFieldXXXXX 「XXXX」にはEventHub管理画面の[基本設定]＞[プロフィール項目]に表示される[項目ID]を入力してください。 |
| Date type | 追加するプロフィール項目のデータ型を入力します。 [String]を選択してください。 |
| Optional | [Yes]を選択してください。 |
7. HubSpotのプロパティ項目を呼び出す
出展フォームで取得したプロフィール項目のうち、HubSpotに連携したいプロパティ項目を設定します。初期テンプレートレシピは、デフォルトの値が入っているため、[Reset]をクリックし、貴社HubSpotのプロパティ項目のフィールドを呼び出します。
① 4行目の[Update a contact in HubSpot]を選択し、画面右上の[Reset]をクリックします。
② 以下項目を入力します。
| Object | [Contact]を選択します |
| ID | [Provided ID]を選択し、HubSpotのコンタクト[ID]の出力データ（※データピル）を割り当てます。 |
8. HubSpotに連携したいプロフィール項目のマッピングをする
出展フォームで取得したプロフィール項目のうち、HubSpotに渡したいプロフィール項目のマッピングをします。
① 手順3. のEventHubのユーザー登録Webhookで取得したペイロードの出力データ（※データピル）をHubSpotのPropertiesの箇所に割り当てます。EventHubに登録されるメールアドレスをKeyに各種アクションの処理を行っているため、メールアドレスのマッピングは必須で行ってください。
上記の画像のように、トリガーであるEventHubのユーザー登録webookの出力データ（※データピル）が表示されています。HubSpotのPropertiesの箇所に、各項目一致するデータピルを割り当ててください。
② 表示されている[Properties]以外にHubSpotに連携させたい項目がある場合は、設定画面の最下部[ + 数字 optional Fields available]をクリックし、連携させたい該当フィールドを選択します。
（※ 表示されるプロパティ項目の詳細のフィールドの内容は、貴社MAで作成している項目によって表示内容が異なります。）
③ 選択した該当フィールドに対し、EventHubのユーザー登録Webhookで取得したペイロードの出力データ（※データピル）を[Enter text]を選択の上、HubSpotのPropertiesの箇所に割り当てます。編集後は、画面右上の[Save]をクリックし、変更内容を保存してください。
※ EventHubで取得した項目をHubSpotに連携させる必要がない場合は、この操作は不要です。
項目タイプ（チェックボックス：複数選択可）を連携させる場合
複数選択の項目を連携させる場合、ワークフロー上で文字列処理を行う関数を入力する必要があります。
[Enter text]＞[Formula]を選択の上、Webhookで取得したペイロードの出力データ（※データピル）の後ろに関数.gsub(",", ";")を入力してください。
<tips> 4行目の[Update a contact in HubSpot]で設定した操作を、6行目の[Create a contact in HubSpot]でも同様に実施してください。 </tips>
④ [Start recipe]をクリックし、レシピをアクティブにします。
これでテンプレートレシピの設定は完了です🎉
9. ユーザー登録のWebhookをEventHubに設定する
① 1行目の[User registration via HTTP webhook]を選択し、[Workato webhook address]をコピーします。
② EventHubの管理画面[設定]＞[Webhook]から[ユーザー登録(登録フォーム)]を選択します。
③ URLの欄に②で取得したURLを入力し、[保存]を選択します。
10. 出展フォームからLeadScanしたユーザー情報をHubSpotへ登録する
実際にリードスキャンを立ち上げ、名刺の読み取りを行います。リードスキャンを利用するにあたって必要なフォーム作成および名刺読み取り方法等の詳細は、以下ページをご参考ください。
リードスキャン後、一連のフローが実行され、読み取った情報がHubSpotのコンタクトとして新規作成/更新されているかご確認ください。
11. サポート対応について
弊社から提供する上記テンプレートレシピに対する質問は、画面右下の吹き出しマークからカスタマーサポートまでお問い合わせください。貴社の環境にログインし、設定内容およびエラーの詳細を確認させていただきます。
貴社独自の実装およびテンプレートレシピを流用する形でのカスタマイズを実施された場合は、弊社サポート対象外となります。
また連携先のHubSpotに関しましても、企業によってHubSpotのデータの持ち方が異なりますので、提供する情報の継続や正確性を完全に保証するものではありません。HubSpotに関するご不明な点はHubSpotカスタマーサポート、もしくは社内のHubSpot Adminへお問い合わせください。