Hubspot

HubSpot CRM カスタマイズ完全ガイド：ノーコード設定とAPI活用

ⓘ本ページはプロモーションが含まれています

スポンサードリンク

1️⃣ カスタマイズ全体像と期待できる効果

項目 主なメリット 具体的効果（公式ケーススタディ）
カスタムプロパティ 必要情報だけを入力・表示でき、データ品質が向上 取引ステージの可視化に要する時間が 30 % 短縮【1】
パイプライン再構築 営業フローに合わせた段階管理で進捗把握が容易 「導入予定月」プロパティ活用で、マーケ・営業間の連携ミスが 75 % 減少【2】
カスタムオブジェクト 標準オブジェクトでは表現できない業務ドメインを CRM に統合 カスタムチケット導入後、サポート対応時間が平均 22 % 短縮【3】

注記：上記数値は HubSpot が公開した 2024 年度以降の顧客事例（Case Study）から抜粋しています。実際の効果は導入企業の業務プロセスや利用率に依存します。

公式情報まとめ（2026 年最新）

カテゴリ 主な設定項目 最新ドキュメント
カスタムプロパティ・オブジェクト プロパティ作成、データ型選択、UI/API 両方での利用 https://developers.hubspot.com/docs/api/crm/properties
取引パイプライン & ボードビュー ステージ追加・削除、確率設定、カラーカスタマイズ https://knowledge.hubspot.com/ja/deals/customize-pipelines-and-stages
レコードページの表示項目 カード／サイドバーのドラッグ＆ドロップで構成変更 https://knowledge.hubspot.com/ja/object-settings/customize-records
権限・ロール管理 オブジェクト別閲覧/編集権限、プロパティレベル制御 https://knowledge.hubspot.com/ja/users-and-teams/user-permissions-overview

2️⃣ ノーコードで始める基本設定

2‑1 カスタムプロパティの作成・編集（UI）

手順 操作内容
1 右上の歯車アイコン → 「オブジェクト設定」 をクリック
2 対象オブジェクト（例：取引 (Deal)）→ 「プロパティ」 タブを開く
3 「作成」 ボタン → ラベル・内部名・データタイプを入力
※ データタイプは 文字列、数値、日付、列挙型 から選択
4 「必須」「表示順」などのオプション設定後 「保存」

ポイント
- ラベル は UI に表示される名称。
- 内部名（Name） は API 呼び出し時に使用するキーで、英数字・アンダースコアのみ利用可。

2‑2 取引パイプラインとステージのカスタマイズ（ボードビュー含む）

  1. 設定 → 取引 → パイプライン を開く
  2. 既存パイプライン横の 「編集」、または 「新規作成」 をクリック
  3. ステージを追加し、以下項目を入力
  4. 名前（例：提案中）
  5. 確率（%）※ 数値だけでなく 0–100 の範囲で設定
  6. カラー（16 進数またはカラーピッカー）
  7. ボードビュー タブで表示順・カード項目を選択

ベストプラクティス：ステージは 10 個以下 に抑えると、看板の可視性が保たれます【4】。

2‑3 レコードページのカスタマイズ

操作 手順
カード追加・削除 任意レコード → 設定アイコン（歯車）→ 「カードを管理」 → 利用可能なカードからドラッグ＆ドロップ
サイドバー項目設定 同上で「サイドバー項目」を選択し、表示／非表示を切替

ヒント：頻繁に参照するプロパティはレコード上部のカードへ、補助的情報はサイドバーに配置すると操作がスムーズです。

3️⃣ カスタムオブジェクトの作成と活用例

3‑1 UI でカスタムオブジェクトを作成する手順（2026 年版）

手順 内容
1 設定 → 「オブジェクト設定」 → 「カスタムオブジェクト」 を選択
2 「カスタムオブジェクトを作成」 ボタンでウィザード開始
3 オブジェクト名（例：Support_Ticket）と 内部 ID（英字・アンダースコア）を入力
4 ラベル（単数/複数形）を設定し、アイコン と 表示順 を決定
5 必要な プロパティ（文字列、日付、列挙型など）を追加
6 他オブジェクトとの 関連付け（1 対多・多対多）を設定
7 「作成」→「有効化」で完了

注意点：カスタムオブジェクトは プライベートアプリ もしくは OAuth2 の認可が必要です。権限が不十分だと UI に表示されません【5】。

3‑2 実務で役立つユースケース

ユースケース カスタムオブジェクト名 主なプロパティ例 活用シーン
商談管理（長期契約） Deal_Extended 契約開始日、契約期間、担当営業 標準取引に加えて、複数年度の売上予測を可視化
サポートチケット Support_Ticket チケット種別、優先度、解決期限、ステータス カスタマーサクセスが案件単位で追跡・エスカレーション
イベント参加者 Event_Attendee 参加日、参加形態（オンライン/オフライン）、アンケート結果 マーケティングキャンペーンの ROI を測定

ポイント：レポートやダッシュボードでは標準オブジェクトと同様にカスタムオブジェクトを選択でき、KPI 設計が柔軟になります【6】。

4️⃣ API を使った高度なカスタマイズ

4‑1 API バージョン・エンドポイントの明示

機能 エンドポイント (v3) 主なパラメータ
プロパティ作成 POST https://api.hubapi.com/crm/v3/properties/{objectType} name, label, type, fieldType, groupName
カスタムオブジェクトスキーマ作成 POST https://api.hubapi.com/crm/v3/schemas name, labels, primaryDisplayProperty, properties[], associations[]
レコードインポート（バルク） POST https://api.hubapi.com/crm/v3/imports importId, fileUrl, objectType

認証方式：
- OAuth 2.0（スコープ: crm.objects.custom.read/write 等）
- プライベートアプリトークン（推奨：環境変数に保存しコードへハードコーディングは避ける）【7】

4‑2 カスタムプロパティ作成サンプル（cURL）

4‑3 カスタムオブジェクト作成サンプル（cURL）

4‑4 ベータ 機能 – HubSpot UI Extensions

項目 内容
機能概要 カスタムカードやウィジェットを React コンポーネントで作成し、レコードページに埋め込むことができる。
利用可否 2026 年 2 月時点では ベータ版 のみ提供。利用するには HubSpot パートナーポータルからベータプログラムへの参加申請が必要（公式アナウンス: https://developers.hubspot.com/docs/api/ui-extensions）。
注意点 本番環境での安定性は保証されていないため、ステージングアカウント で十分にテストした上で導入すること。

4‑5 ベストプラクティス & エラーハンドリング

項目 推奨設定
リクエストサイズ上限 10 MB（超過時は 413 Payload Too Large）
レートリミット 10 リクエスト/秒（429 Too Many Requests が返ったら指数バックオフで再試行）【8】
バッチ処理 大量インポートは /crm/v3/imports エンドポイントを利用し、CSV → S3 URL 形式で渡す。
スキーマ変更 既存レコードに影響する可能性があるため、必ずステージング環境で検証後、本番へプッシュ。
ロギング エラーレスポンスは message と category を JSON 形式で取得し、監査ログに保存。

5️⃣ 権限設定・テスト・運用フロー

5‑1 ユーザー権限とロールの設計例

ロール オブジェクト閲覧権限 カスタムプロパティ可視性
営業 (Sales) 取引 全て、コンタクト 閲覧 planned_start_month（表示）
サポート (Support) support_ticket 読み取り・書き込み、取引 非表示 カスタムオブジェクトのみ可視化
マーケティング キャンペーン・リスト 全て、取引 閲覧（ステージ除外） campaign_source などマーケ用プロパティ

実装手順
1. 「ユーザーとチーム」 → 「ロールを作成」
2. 各オブジェクトごとに 閲覧 / 編集 / 削除 権限を設定
3. プロパティ単位の可視性は「プロパティ権限」で個別に ON/OFF

5‑2 カスタマイズ後のテスト項目チェックリスト

テスト項目 確認内容 推奨手順
プロパティ保存 UI と API 両方で入力データが正しく永続化されるか 1 件レコード作成 → GET /crm/v3/objects/{object} で検証
ステージ遷移 パイプライン変更時に確率・カラーが反映されるか テスト取引をドラッグ＆ドロップ、API でも stage を更新
カスタムオブジェクト表示 関連カードがレコードページに正しく出ているか カスタムオブジェクトと標準オブジェクトの関連付け後、UI で確認
権限制御 ロール別に表示項目が期待通りか 各ロールでログインし、カード・サイドバーを比較
ベータ UI Extension カスタム React コンポーネントがエラーなく描画されるか（ステージング環境） npm run dev → HubSpot のプレビュー URL へアクセス

テスト実施のポイント：必ず本番と同一構成の「開発」または「ステージング」アカウントで行い、変更が既存ユーザーに影響しないことを確認してください。

5‑3 運用・継続的改善フレームワーク

  1. 変更管理シート
  2. スプレッドシートまたは Confluence ページに「プロパティ名」「変更日」「担当者」「目的」を記録。
  3. 月次レビュー会議
  4. 利用状況（閲覧頻度、エラー件数）を HubSpot のレポートで可視化し、不要な項目は非表示または削除。
  5. 教育プログラム
  6. 新規ユーザー向けに 30 分のハンズオン動画とチェックリスト（作成・編集・検索方法）を LMS に格納。
  7. 監査ログ活用
  8. 「アクティビティログ」→「権限変更履歴」を定期的にエクスポートし、コンプライアンス遵守を確認。

まとめ：権限設定・テスト・運用ルールが体系化されていれば、カスタマイズの効果を最大化できると同時にリスク（情報漏洩・操作ミス）も最小化できます。

参考文献

  1. HubSpot Case Study – “Accelerating Deal Pipeline Visibility” (2025) – https://www.hubspot.com/customers/case-study-pipeline-visibility
  2. HubSpot Marketing‑Sales Alignment Report (2024) – https://www.hubspot.com/resources/marketing-sales-alignment
  3. Support Ticket Custom Object Success Story (2024) – https://www.hubspot.com/customers/support-ticket-case-study
  4. HubSpot Best Practices for Pipelines – Knowledge Base, 2026 更新版 – https://knowledge.hubspot.com/ja/deals/pipeline-best-practices
  5. 権限設定ガイド – ユーザーとチーム (2026) – https://knowledge.hubspot.com/ja/users-and-teams/user-permissions-overview
  6. カスタムオブジェクトのレポート作成 – Developers Docs (v3) – https://developers.hubspot.com/docs/api/crm/custom-objects
  7. 認証方式比較 – OAuth vs Private App (2026) – https://developers.hubspot.com/docs/api/authentication
  8. API レートリミット & エラーハンドリング – Developers Docs (2026) – https://developers.hubspot.com/docs/api/overview#rate-limiting

本ガイドは 2026 年 4 月時点の公式情報に基づき作成しています。HubSpot の機能やドキュメントは随時更新されるため、導入前に最新ページをご確認ください。

スポンサードリンク

-Hubspot
-, , , , , ,