HubSpotのレコードを作成する
この記事では、AUTORO で HubSpot のレコードを作成する方法を紹介します。
- HubSpotCreateRecord アクションでレコードを1件作成する
- 繰り返しで1件ずつレコードを作成する
※本記事の紹介内容を実装するためには、事前に HubSpot との連携設定を済ませておく必要があります。連携設定の方法はこちらをご参照ください。
・HubSpot と連携
1. HubSpotCreateRecordアクション
HubSpotCreateRecord アクション(HubSpotのレコードを作成する)を使用すると、Hubspot のオブジェクト(会社・コンタクト・取引など)に1件のレコードを作成できます。
この章では、1件のレコードを作成する方法を紹介します。
なお、このアクションで新規に作成可能なレコードは、1件のレコードのみとなります。
複数のレコードを作成する場合は、繰り返し処理で HubSpotCreateRecord アクションを使用する必要があります。
この方法は後述します。
今回は例として、「会社(companies)」オブジェクトに以下のレコードを作成してみます。
- 「会社のドメイン名(domain)」が『OOO.com』
- 「会社名(name) 」が『株式会社OOO』
- 「市区町村(city)」が『さいたま市』
- 「都道府県／地域(state)」が『埼玉県』
- HubSpotCreateRecord アクションを設置します。
- 「プロバイダーID」に、使用するコネクションを設定します。
- 「オブジェクトタイプ」に、作成したいオブジェクトの内部名を指定します。
- 今回は「会社」を作成するため、
companiesと入力します。 - 主なオブジェクトタイプの内部名
HubSpotオブジェクト 内部名 会社 companies コンタクト contacts 取引 deals 商品項目 line-items 製品 products チケット tickets 見積もり quotes
- 今回は「会社」を作成するため、
作成するレコードの各プロパティに値を設定します。
- 「レコードのプロパティ」に、プロパティの内部名とその値をオブジェクト形式で入力します。
{"内部名1":"値1","内部名2":"値2",,,} - プロパティ内部名の確認方法は、下記参考をご参照ください。
{"domain":"OOO.com","name":"株式会社OOO","city":"さいたま市","state":"埼玉県"}
# HubSpotのレコードを作成する
+hub_spot_create_record_1:
action>: HubSpotCreateRecord
display_name>: 'HubSpotのレコードを作成する'
providerId: ''
objectType: companies
properties:
domain: 'OOO.com'
name: '株式会社OOO'
city: 'さいたま市'
state: '埼玉県'
private: false
meta:
display:
action:
disabled: false
2.繰り返しでレコードを作成する
スプレッドシートなどに蓄積された情報を元に、複数の新しいレコードを作成することも可能です。
ここでは、シートにまとめられた会社情報を元に、HubSpot の「会社」オブジェクトへ複数のレコードを作成する例を紹介します。
今回は、以下の3つの会社レコードを繰り返しで作成してみます。
なお、この章では以下の列順を想定してワークフローを組み上げていきます。
- A列：会社名（name）
- B列：都道府県（state）
- C列：ドメイン（domain）
レコード作成に使用する値をスプレッドシートにまとめたら、AUTORO側でシートと値を取得します。
- GetSpreadsheetアクション(既存のスプレッドシートを取得)を設置します。
- 「プロバイダID」に、コネクションを設定します。
- 「スプレッドシートID」に、値が存在するスプレッドシートを指定します。
- GetCellsアクション(セルの値を取得)を設置します。
- 「範囲」に以下を入力します。
ご自身で設定されたシート名!A2:C※「A2:C」と記述すると、データの最下行を自動判定して全データを取得できます
- forEachアクション(各要素について繰り返す)を設置します。
- 「繰り返すリスト」に、「1」のアウトプットを指定します。
- 「要素を格納する変数名」に、以下を入力します。
recordRow
forEach の中に HubSpotCreateRecord を設置し、繰り返し処理で1件ずつレコードを作成します。
- forEach の中に、HubSpotCreateRecord を設置します。
- 「プロバイダーID」に、コネクションを設定します。
- 「オブジェクトタイプ」に、
companiesを指定します。 - 「レコードのプロパティ」に、プロパティ内部名と変数を使用した値をオブジェクト形式で入力します。
{"name":"${recordRow[0]}","state":"${recordRow[1]}","domain":"${recordRow[2]}"}※スプレッドシートの1列目の値 ${recordRow[0]}
※スプレッドシートの2列目の値 ${recordRow[1]}
※スプレッドシートの3列目の値 ${recordRow[2]}
# 既存のスプレッドシートを取得
+get_spreadsheet_1:
action>: GetSpreadsheet
display_name>: '既存のスプレッドシートを取得'
provider: ''
spreadsheet_id: ''
private: false
meta:
display:
action:
disabled: false
# セルの値を取得
+get_cells_1:
action>: GetCells
display_name>: 'セルの値を取得'
spreadsheet: +get_spreadsheet_1
range: 'シート1!A2:C'
findAll: false
private: false
meta:
action:
disabled: false
# 各要素について繰り返す
+for_each_1:
for_each>:
recordRow: +get_cells_1
private: false
display_name>: '各要素について繰り返す'
meta:
action:
disabled: false
_do:
# HubSpotのレコードを作成する
+hub_spot_create_record_1:
action>: HubSpotCreateRecord
display_name>: 'HubSpotのレコードを作成する'
providerId: ''
objectType: companies
properties:
name: ${recordRow[0]}
state: ${recordRow[1]}
domain: ${recordRow[2]}
private: false
meta:
display:
action:
disabled: false