ドキュメントWorkfrontWorkfront ガイド

HubSpot CRM モジュール

Last update: Mon Feb 05 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • ユーザー

Adobe Workfront FusionHubSpot CRMモジュールを使用すると、イベント、レコード、連絡先、エンゲージメント、ファイルやフォームの送信を監視したり、HubSpot CRMアカウント内のレコード、連絡先、エンゲージメント、イベント、ファイルを作成、取得、アップデート、削除したりすることができます。

アクセス要件

この記事で説明している機能を使用するには、次のアクセス権が必要です。

Adobe Workfront プラン*
Pro 以降
Adobe Workfront ライセンス*
Plan、Work
Adobe Workfront Fusion ライセンス**

現在のライセンス要件：Workfront Fusion ライセンス要件なし。

または

従来のライセンス要件：Workfront Fusion for Work Automation and Integration

製品

現在の製品要件：Select または Prime Adobe Workfront プランをご利用の場合、この記事で説明されている機能を使用するには、組織は Adobe Workfront に加えて Adobe Workfront Fusion も購入する必要があります。Workfront Fusion は、Workfront Ultimate プランに含まれています。

または

従来の製品要件：この記事で説明している機能を使用するには、Adobe Workfront Fusion と Adobe Workfrontを組織で購入する必要があります。

ご利用のプラン、ライセンスタイプまたはアクセス権を確認するには、Workfront 管理者にお問い合わせください。

Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。

前提条件

HubSpot CRM モジュールを使用するには、HubSpot CRM アカウントが必要です。

Adobe Workfront Fusion を HubSpot CRM に接続

HubSpot CRM アカウントを Workfront Fusion に接続する手順については、 Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。

HubSpot CRM モジュールとそのフィールド

Hubspot CRM モジュールを設定する際、Workfront Fusion に以下のフィールドが表示されます。これらに加えて、アプリまたはサービスのアクセスレベルなどの要因に応じて、追加の Hubspot CRM フィールドが表示される場合があります。モジュール内の太字のタイトルは、必須フィールドを示します。

フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、 Adobe Workfront Fusion でモジュールから別のモジュールに情報をマッピングを参照してください。

CRM オブジェクト

CRM オブジェクトを検索

この検索モジュールは、カスタムプロパティまたはクエリで CRM オブジェクトを検索します。製品や明細項目を検索するには、必要なカスタムスコープで特別な接続を使用します。

Connection
HubSpot CRM アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Limit
モジュールが 1 回の実行サイクルで返す最大項目数を入力またはマッピングします。
Object Type to Search
検索する Hubspot CRM オブジェクトのタイプを選択します。
Output properties
モジュールの出力に表示するプロパティを選択します。使用可能なフィールドは、選択したオブジェクトによって異なります。
Filter by

検索のフィルター方法を選択

  • Query

    クエリを入力またはマッピング

  • Properties

    検索のグループまたはフィルターを入力します。

Sort by

結果を並べ替える場合は、クリックします。結果の並べ替えを選択すると、以下のフィールドが表示されます。

  • Property name

    結果の並べ替えに使用するプロパティを選択します

  • Direction

    結果を昇順または降順のどちらで並べ替えるかを選択します。

レコード（契約、連絡先、会社）

レコードを作成（レガシー）

このアクションモジュールは、連絡先、会社または契約を作成します。

Connection
HubSpot CRM アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Record Type
作成するレコードのタイプを選択します
Properties
レコードに設定するプロパティを入力します。使用できるフィールドは、作成するレコードのタイプによって異なります。

レコードを取得

このアクションモジュールは、連絡先、会社または契約の詳細を取得します。

Connection
HubSpot CRM アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Record Type

レコードタイプを選択します。

  • Contact
  • Company
  • Deal
Search Type
連絡先を取得する場合は、ID で識別するか、メールアドレスで識別するかを選択します。
ID
取得する連絡先、会社または契約の ID を入力します。
Email
詳細を取得する連絡先のメールアドレスを入力します。

レコードを更新

このアクションモジュールは、連絡先、会社または契約を更新します。

Connection
HubSpot CRM アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Record Type
更新するレコードの種類を選択します。
Search Type

連絡先を取得する場合は、レコードを識別する方法を選択します。

  • ID

  • Email

ID
更新する連絡先、会社または契約の ID を入力します。
Email
詳細を更新する連絡先のメールアドレスを入力します。
Properties
レコードに設定するプロパティを入力します。使用できるフィールドは、作成するレコードのタイプによって異なります。

レコードを削除

このアクションモジュールは、連絡先、会社または契約を削除します。

Connection
HubSpot CRM アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Record Type
削除するレコードのタイプを選択します。
ID
削除する連絡先、会社または契約の ID を入力します。

レコードプロパティを取得

このアクションモジュールは、（内部）名で特定のレコードプロパティのメタデータを取得します。

Connection
HubSpot CRM アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Record Type
メタデータを取得するプロパティを持つレコードのタイプを選択します。
Property Name
メタデータを取得するプロパティを選択します。
Option ID
一部のプロパティには、ユーザーがプロパティ値として選択できる一連の使用可能なオプションがあります。取得するプロパティ値を表すオプションの ID を入力します。

レコードを監視

このトリガーモジュールは、過去 30 日以内に連絡先、会社または契約が変更または作成された場合にシナリオを開始します。出力できるレコード数は 10,000 個に制限されます。

Connection
HubSpot CRM アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Record Type
監視するプロパティを持つレコードのタイプを選択します。
Search
最近変更したレコードと最近作成したレコードのどちらを監視するかを選択します。
Output Properties
モジュールの出力に含めるプロパティを選択します。
Limit
各シナリオの実行サイクル中に、モジュールが返すレコードの最大数を入力またはマッピングします。

連絡先

連絡先を作成／更新（レガシー）

ポータルに存在しない場合は連絡先を作成します。または存在する場合は最新のプロパティ値で更新します。

Connection
HubSpot CRM アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Properties
連絡先の設定または更新を行うプロパティを入力します。

連絡先グループを作成／更新

連絡先のグループを作成するか、既に存在する場合は更新します。バッチサイズが 100 件の連絡先以下に制限されている場合は、最適なパフォーマンスが実現します。このエンドポイントを通じて行われた変更は非同期で処理されるので、連絡先レコードに変更が適用されるまで数分かかる場合があります。

Connection
HubSpot CRM アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Batch of Contacts to Create/Update

連絡先のバッチを追加します。

Add item をクリックして、新しい連絡先を追加します。表示されるウィンドウで、次の情報を入力またはマッピングします。

  • Search Type

    連絡先を識別する方法を選択してください。

    • ID

      作成または更新する連絡先の ID を入力します。

    • Email

      作成または更新する連絡先のメールアドレスを入力します。

  • Properties

    連絡先の設定または更新を行うプロパティを入力します。

リストに連絡先を追加

このモジュールは、システムで既に作成されている連絡先レコードを、連絡先リストに追加します。

Connection
HubSpot CRM アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください
List ID
連絡先を追加するリストの ID を選択します。
IDs/Emails

リストに追加する連絡先を識別する方法を選択します。

  • IDs

    リストに追加する連絡先の ID を追加します。

  • Emails

    リストに追加する連絡先のメールアドレスを追加します。

リストから連絡先を削除

連絡先リストから連絡先を削除。

NOTE
動的リストから連絡先を手動で削除することはできません。
Connection
HubSpot CRM アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください
List ID
連絡先を削除するリストの ID を選択します。
Contact ID
リストから削除する連絡先の ID を入力します。

連絡先を結合

Connection
HubSpot CRM アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
ID 1
結合するいずれかの連絡先の ID を入力します。
ID 2
結合する他の連絡先の ID を入力します。

連絡先を検索

検索クエリを使用して連絡先のリストを取得します。

Connection
HubSpot CRM アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Query
検索クエリを入力します。
Limit
Workfront Fusion が 1 回のシナリオ実行サイクルで返す連絡先の最大数を入力またはマッピングします。

連絡先のリスト

ポータルで作成されたすべての連絡先を返します。出力できる連絡先は 5000 に制限されます。前の連絡先または次の連絡先を一覧表示するには、詳細パラメーターを使用して、リストをオフセットします。

Connection
HubSpot CRM アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Limit
Workfront Fusion が 1 回のシナリオ実行サイクルで返す連絡先の最大数。
Output properties
モジュールの出力に表示するプロパティを選択します。

会社の連絡先リスト

会社内の連絡先リストを取得します。出力できる連絡先は 5000 に制限されます。前の連絡先または次の連絡先を一覧表示するには、詳細パラメーターを使用して、リストをオフセットします。

Connection
HubSpot CRMアカウントをWorkfront Fusionに接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
ID
連絡先をリストしたい会社の ID を入力します。
Limit
Workfront Fusion が 1 回のシナリオ実行サイクルで返す連絡先の最大数。

リストに追加された連絡先を監視

このトリガーモジュールは、新しい連絡先がリストに追加されると、シナリオを開始します。これは、有料マーケティングアカウントを持つユーザーのみが利用できます。

Connection
HubSpot CRM アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください
List ID
監視する連絡先が含まれるリストの ID を入力またはマッピングします。
Output Properties
モジュールの出力に含めるプロパティを選択します。
Limit
各シナリオの実行サイクル中に、モジュールが返すレコードの最大数を入力またはマッピングします。

契約

契約パイプラインまたはチケットパイプラインのリスト

指定されたポータルのすべての契約とチケットのパイプラインを返します。

Connection
HubSpot CRM アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Object Type
契約またはチケットのどちらをリストするか選択します。

契約の CRM パイプラインの取得

特定の契約パイプラインを返します。

Connection
HubSpot CRM アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Pipeline ID
詳細を取得するパイプラインの ID を入力またはマッピングします。
Stage ID
詳細を取得するステージの ID を入力またはマッピングします。

会社

ドメインで会社を検索

ドメインプロパティとの完全一致に基づいて、会社のリストを取得します。

Connection
HubSpot CRM アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Domain
hubspot.com など、検索する会社のドメインを入力します。
Limit
1 回のシナリオ実行サイクルで Workfront Fusion が返す必要のある最大企業数。
Output properties
モジュールの出力に表示するプロパティを選択します。

ファイル

フォルダーを作成

このモジュールは、フォルダーを作成します。

Connection
HubSpot CRM アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Folder Name
新しいフォルダーの名前を入力またはマッピングします。
Parent Folder ID
作成するフォルダーの親フォルダーの ID を選択します。

フォルダーを削除

フォルダーを削除済みとしてマークします。

Connection
HubSpot CRMアカウントをWorkfront Fusionに接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
ID
削除するフォルダーの ID を入力します。

ファイルの移動

ファイルを別のフォルダーに移動します。

Connection
HubSpot CRM アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
File ID
移動するファイルの ID を入力またはマッピングします。
Folder ID
ファイルを移動するフォルダーの ID を選択します。
Name
移動するファイルの名前を入力します。

チケット

チケットの削除

ID を指定して既存のチケットを削除します。

Connection
HubSpot CRMアカウントをWorkfront Fusionに接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
ID
削除するチケットの ID を入力します。

API 呼び出しの実行

カスタム API 呼び出しを実行できます。

NOTE
次のエンドポイントは、2023 年 8 月 31 日に HubSpot API で廃止されたので、Fusion モジュールでは使用できなくなりました。
  • コンテンツイベントのリスト
  • ソーシャルイベントのリスト
  • カレンダータスクイベントのリスト
  • すべてのカレンダーイベントのリスト
  • カレンダータスクを作成
  • ID 別のカレンダータスクの取得
  • カレンダータスクを更新
  • カレンダータスクの削除
Connection
HubSpot CRM アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
URL

https://api.hubapi.com/ からの相対パスを入力します。例：/contacts/v1/lists/all/contacts/all

使用可能なエンドポイントの一覧については、HubSpot API ドキュメントを参照してください。

Method

使用する HTTP メソッドを選択します。

GET

エントリの情報を取得します。

POST

新しいエントリを作成します。

PUT

既存のエントリを更新または置き換えます。

PATCH

エントリを部分的に更新します。

DELETE

エントリを削除します。

Headers
希望するリクエストヘッダーを入力します。認証ヘッダーを追加する必要はありません。既に追加されています。
Query String
リクエストクエリ文字列を入力します。
Body
標準の JSON オブジェクトの形式で API 呼び出しの本文コンテンツを追加します。JSON で、if などの条件文を使用する場合は、条件文を引用符で囲みます。
INFO
例： ​次の API 呼び出しは、HubSpot アカウントのすべての連絡先を返します。
URL：/contacts/v1/lists/all/contacts/all
メソッド：GET
一致した検索結果は、バンドル／本文／連絡先下のモジュールの出力に表示されます。
この例では、3 件の連絡先が返されました。

新規アプリケーションの作成

  1. HubSpot 開発者アカウントにログインします。

  2. 「アプリを作成」オプションを選択します。

  3. アプリ名を入力し、ダイアログを保存します。

  4. Web フックに必要なスコープを選択します。

    例えば、新規連絡先が作成または削除された場合にモジュールをトリガーするための連絡先スコープを追加します。

    連絡先、契約および会社イベントの web フックを受け取るために必要な情報は、連絡先スコープだけです。

    note important
    IMPORTANT
    「リダイレクト URL」フィールドには入力しないでください。
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43