HubSpotのコンタクトデータを取得する

HubSpotの「コンタクトデータ」とは

HubSpot に登録された、自社とやり取りする個人に関する情報です。 （参考：CRM API | コンタクト）

HubSpot の CRM API を利用することで、HubSpot に登録されたコンタクトデータの一覧を取得できます。

HubSpotの「コンタクトデータ」の構造

{
  "id": "1",
  "properties": {
    "createdate": "2022-11-11T02:53:00.214Z",
    "email": "[email protected]",
    "firstname": "Maria",
    "hs_object_id": "1",
    "lastmodifieddate": "2023-01-31T04:40:28.639Z",
    "lastname": "Johnson (Sample Contact)"
  },
  "createdAt": "2022-11-11T02:53:00.214Z",
  "updatedAt": "2023-01-31T04:40:28.639Z",
  "archived": false
}

Anyflow Embedで取得する

Anyflow Embed で HubSpot のコンタクトデータを取得する手順を紹介します。

HubSpot のコンタクトデータをスプレッドシートに一括追加するというシンプルなソリューションを作成し、コンタクトに含まれるデータを把握します。

1.Clickトリガーを設定する

Clickトリガーを設定します。

2.HubSpot コネクタを設定する

HubSpot コネクタを追加します。

jison3.HubSpot のカスタムアクションを設定する

ソリューションエディタに戻り、HubSpotコネクタを以下の通りに設定します。

また、「レスポンスボディ定義」には以下の設定を行います。

{
  "results": [
    {
      "id": "string",
      "properties": {
        "email": "string",
        "firstname": "string",
        "lastname": "string"
      },
      "createdAt": "2024-04-15T00:14:10.990Z"
    }
  ]
}

「element」の名前は「contact」に変更しておきます。

以下が設定後のイメージです。

4.スプレッドシートの列名を設定する

スプレッドシートコネクタを追加し、以下の通りに設定を行います。

「ヘッダーの列名」は以下の通りに設定します。

id
email
firstname
lastname
createdAt

「行データ」にも同じ様に設定します。

5.スプレッドシートに一括追記する

スプレッドシートコネクタを追加し、以下の通りに設定を行います。

「ヘッダーの列名」は以下の通りに設定します。

id
email
firstname
lastname
createdAt

「リストソース」は以下の通りに設定します。

「要素フィールド」は以下の通りに設定します。（「i番目のcontacts」から項目を選択します。）

6.ウィザードを設定する

必要な認証をウィザードに追加します。

7.テストを行う

テストを行うと、スプレッドシートにデータが追加されていることがわかります。