Integrations
HubSpot 連携
HubSpot と Pigeon Workflow を連携することで、CRM の連絡先・会社・取引の作成や削除をトリガーにワークフローを起動したり、 レコードを取得・保存・更新できます。商談データの自動整形や Slack 通知、リード情報の自動付与に活用できます。
組織共有の連携です。HubSpot 連携は組織の管理者（オーナー）が設定します。設定後は組織内の全メンバーがワークフローで利用できます。 1 つの組織に複数の HubSpot ポータルを接続できます（ポータルごとに 1 連携）。
連携でできること
- 連絡先・会社・取引が作成／削除されたら自動でワークフロー実行（トリガー）
- 取引のステージ（dealstage）変更をトリガーに通知や後続処理を実行
- 連絡先・会社・取引のレコードを ID やメール・ドメインで取得
- レコードを新規作成・更新・アップサート・削除（取引は連絡先／会社と関連付け可）
- 取得したデータを AI で整形し Slack やメールに自動通知
提供される 9 ノード
| ノード | 種別 | 概要 |
|---|---|---|
| HubSpot トリガー | 入力（トリガー） | 連絡先の作成・削除でワークフローを起動 |
| 連絡先取得 | 入力 | 連絡先を ID・メール・検索・最近更新順などで取得 |
| 連絡先保存 | 出力 | 連絡先を作成・更新・メールでアップサート・削除 |
| 会社トリガー | 入力（トリガー） | 会社の作成・削除でワークフローを起動 |
| 会社取得 | 入力 | 会社を ID・検索・最近更新順などで取得 |
| 会社保存 | 出力 | 会社を作成・更新・ドメインでアップサート・削除 |
| 取引トリガー | 入力（トリガー） | 取引の作成・削除・dealstage 変更でワークフローを起動 |
| 取引取得 | 入力 | 取引を ID・検索・最近更新順などで取得 |
| 取引保存 | 出力 | 取引を作成・更新・削除（連絡先／会社と関連付け可） |
必要な OAuth スコープ
| スコープ | 用途 |
|---|---|
| 連絡先 読み取り / 書き込み | 連絡先の取得・作成・更新・削除 |
| 会社 読み取り / 書き込み | 会社の取得・作成・更新・削除 |
| 取引 読み取り / 書き込み | 取引の取得・作成・更新・削除 |
| スキーマ 読み取り | カスタムプロパティ一覧の取得（プロパティ選択に使用） |
セットアップ手順
1
サービス連携画面を開く
Pigeon Workflow ダッシュボードの「設定」→「サービス連携」→「HubSpot」を選択します。
2
「接続」をクリック
「接続」ボタンをクリックすると HubSpot の OAuth 同意画面が開きます。
3
ポータルを選択して許可する
連携したい HubSpot アカウント（ポータル）を選択し、連絡先・会社・取引の読み書きと スキーマ読み取りの権限を許可します。
4
連携完了を確認
「HubSpot 連携完了」と表示されれば設定完了です。アクセストークンは自動更新されるため、 通常は再認証不要です。
Webhook の登録は不要です。HubSpot トリガーの受信はアプリ側で運用管理されます。ユーザーは OAuth 接続を行うだけで トリガーノードが利用可能になります（HubSpot Developer 側での Webhook 設定は不要）。
トリガーとアクションの種類
トリガー（起動条件）
- 連絡先：作成（creation）／削除（deletion）
- 会社：作成（creation）／削除（deletion）
- 取引：作成（creation）／削除（deletion）／ステージ変更（dealstage propertyChange）
入力アクション（取得）
- 連絡先：
get_by_id/get_by_email/search/list_recentなど - 会社：
get_by_id/search/list_recentなど - 取引：
get_by_id/search/list_recentなど
出力アクション（保存）
- 連絡先：
create/update_by_id/upsert_by_email/delete - 会社：
create/update_by_id/upsert_by_domain/delete - 取引：
create/update_by_id/delete（連絡先・会社と関連付け可）
ノードの主要な設定項目
| 設定項目 | 説明 | 必須 |
|---|---|---|
| 連携 | 登録済みの HubSpot 連携（ポータル）を選択 | 必須 |
| 対象オブジェクト | 連絡先 / 会社 / 取引 | 必須 |
| イベント（トリガー時） | 作成 / 削除 / ステージ変更 | トリガーで必須 |
| アクション（取得・保存時） | 取得 / 作成 / 更新 / アップサート / 削除 | 取得・保存で必須 |
| プロパティ | 取得・保存対象のプロパティ（カスタム含む） | 任意 |
よくある落とし穴
| 症状 | 原因 / 対処 |
|---|---|
| ワークフロー実行で 401 エラー | HubSpot 側でアプリの接続が解除された可能性。設定画面の再認証バナーから再接続 |
| カスタムプロパティが選択肢に出ない | スキーマ読み取りスコープが不足。連携を再接続して権限を付与 |
| トリガーが発火しない | イベント種別（作成 / 削除 / ステージ変更）の選択を確認。Webhook 登録はアプリ側で運用管理されるためユーザー操作は不要 |