HubSpotと連携すると、HubSpotのコンタクトやセグメント（リスト）とLINEの友だちをつなげて運用できます。設定は数ステップで終わります。設定が済んだら、マーケティングエージェントに「HubSpotのデータを使って配信を考えて」と相談しながら進められます。この記事では、連携の準備から設定手順、連携後の確認、解除までを説明します。
HubSpot連携でできること
HubSpotのCRMデータとLINEの友だちデータをつなげ、HubSpotを起点にしたLINE運用ができるようになります。
連携を有効にすると、次のことができます。
- HubSpotのコンタクト、セグメント（リスト）、ワークフローなどの参照データをLumoで利用する
- HubSpotのセグメント（リスト）やコンタクトプロパティを条件に、LINE配信のセグメントを作成する
- LINEの友だち情報やフォロー状態を、HubSpotのカスタムプロパティに書き戻す
- HubSpotのワークフローにLINEのアクション（メッセージ送信・通知メッセージ送信・リッチメニュー更新・ID連携）を追加する
- HubSpotのコンタクト・会社・チケットの画面からLINEのチャットを開く
- HubSpotの受信トレイとヘルプデスクでLINEの会話を受け取り、返信する（任意）
連携後の配信づくりは、マーケティングエージェントに目標を伝えて任せられます。たとえば「HubSpotで『VIP』のセグメント（リスト）に入っている友だちに、今週末のキャンペーンを案内したい」と相談すると、エージェントがセグメントの提案や配信案の作成まで進めます。最終的な実行は、承認画面の 「実行する」 で進め、見送る場合は 「やめておく」 を選びます。
連携を始める前に確認すること
連携をスムーズに完了させるため、権限とアカウントの状態を事前に確認してください。
| 確認項目 | 内容 |
|---|---|
| Lumoの権限 | 対象のワークスペースに管理者としてログインしている |
| HubSpotの権限 | アプリの連携や設定変更ができる「スーパー管理者」相当の権限を持っている |
| LINE公式アカウント | 連携に使うLINE公式アカウントがLumoに接続済みである |
| HubSpotのプラン | 無料プラン以上で利用できる（実運用にはStarterプラン以上を推奨） |
| Lumoのプラン | 日本のワークスペースはBusinessプラン以上、日本以外はStarterプラン以上で利用できる。CONNECTから移行したLINEアカウントはプラン不問。条件を満たさなくなると同期とワークフローアクションは止まり、再び満たすと再開する |
CONNECTから移行したLINEアカウントは、Freeプランのままでも連携を使えます。このとき、HubSpotのワークフローから送るLINEメッセージは、Freeプランの無料枠（200通/月）に数えます。Lumoのメッセージ配信と同じ枠なので、無料枠を超えるとワークフローからの送信も止まります。
受信トレイ同期も使う場合は、HubSpotで受信トレイを管理できる権限もあわせて確認してください。
連携の所要時間は15分程度です。
連携を始める入口
HubSpot連携は、Lumoから始める方法と、HubSpot App Marketplaceから始める方法のどちらでも開始できます。どちらを選んでも、最終的に同じHubSpot連携設定につながります。
| 入口 | 概要 |
|---|---|
| Lumoから始める | Lumoの連携ウィザードに沿って、確認とHubSpotへのログインを順に進めます |
| HubSpot App Marketplaceから始める | HubSpotでLumoアプリを開き、その途中でLumoにサインインして接続先のLINE公式アカウントを選びます |
どちらの入口でも、新しいLINE公式アカウントを作るのではなく、Lumoに接続済みの既存アカウントを選んで連携します。使いたいLINE公式アカウントがまだLumoにない場合は、先にLINE公式アカウントの接続方法の手順でLumoに接続してください。
Lumoから連携する
Lumoの連携ウィザードでは、利用するデータを確認しながら4つのステップで連携を完了します。
連携ウィザードを開く
- Lumoのサイドメニューから 「顧客データ管理」 を開きます。
- 「HubSpot」 を選びます。
- 連携前の確認事項を読み、「HubSpot連携を開始する」 をクリックします。
ウィザードの4ステップ
| ステップ | 画面 | 確認する内容 |
|---|---|---|
| 1 | Lumoが利用するHubSpotデータの確認 | コンタクトのレコードID、リスト／セグメント、ワークフローなどの参照データをLumoで使うことを確認します |
| 2 | HubSpotに追加するLumoデータの確認 | LumoがHubSpotに自動作成するカスタムプロパティの内容を確認します |
| 3 | HubSpotにログイン | HubSpotのログイン画面に移動し、連携を許可します |
| 4 | 連携完了 | 連携が完了したことを確認し、ダッシュボードに進みます |
ステップ1で確認するとおり、氏名・メールアドレス・電話番号などのコンタクトプロパティは、初期状態ではLumoに同期されません。必要な項目は連携後に同期データの設定から追加します。
連携を許可すると、HubSpot側にLumoが利用するカスタムプロパティが自動作成されます。初回同期とプロパティの作成が反映されるまで数分かかる場合があります。
HubSpot App Marketplaceから連携する
HubSpot App Marketplaceから始める場合は、Lumoアプリのインストールの途中でLumoにサインインし、接続先のLINE公式アカウントを選びます。
- HubSpot App Marketplaceで Lumo のアプリページを開きます。
- アプリのインストールを進めると、Lumoのサインイン画面が開きます。対象のワークスペースにサインインします。
- 連携するLINE公式アカウントを選びます。
- 「HubSpotで続行」 をクリックし、HubSpotに戻ります。
- HubSpotの画面で必要な権限を確認し、インストールを完了します。
まだLumoに接続済みのLINE公式アカウントがない場合は、Lumoでアカウントを接続してから、HubSpot App Marketplaceでアプリを開き直してください。
連携で許可するHubSpotの権限
連携では、HubSpotの許可画面で、必須の権限21個と任意の権限9個の許可を求めます。Lumoは、それぞれの権限を次の用途に使います。
| 対象 | 権限（スコープ） | 区分 | 使いみち |
|---|---|---|---|
| コンタクト |
crm.objects.contacts.read、crm.objects.contacts.write、crm.schemas.contacts.read、crm.schemas.contacts.write
|
必須 | コンタクトとプロパティを読み取り、LINEの友だちと紐づけます。LINE User IDやフォロー状態などを保存するカスタムプロパティを作り、値を書き戻します。設定でオンにしたときは、コンタクトを自動で作成します |
| リスト |
crm.lists.read、crm.lists.write
|
必須 | HubSpotのセグメント（リスト）を、配信先やセグメントの条件、ID連携の取り込み元に使います。配信の受信者から、HubSpotに静的リストを作ることもできます |
| タイムライン | timeline |
必須 | 友だち追加・開封・クリック・リッチメニューのタップなどのLINEのアクティビティを、コンタクトのタイムラインに記録します |
| ワークフロー | automation |
必須 | HubSpotのワークフローに、LINEのアクション（メッセージ送信・通知メッセージ送信・リッチメニュー更新・ID連携）を追加します |
| 会社 |
crm.objects.companies.read、crm.objects.companies.write、crm.schemas.companies.read、crm.schemas.companies.write
|
必須 | 会社の情報とプロパティを読み取ります。グループチャットを会社として同期するときは、LINEグループ用のプロパティを作り、会社を作成・更新します |
| 取引・チケット |
crm.objects.deals.read、crm.objects.deals.write、crm.schemas.deals.read、crm.schemas.deals.write、tickets
|
必須 | 取引やチケットを登録元にしたワークフローから、関連するコンタクトにLINEを送ります。Lumoの受信トレイから、取引やチケットを作成・更新します |
| 担当者・ユーザー |
crm.objects.owners.read、settings.users.read、settings.users.teams.read
|
必須 | コンタクトや会社の担当者を読み取り、受信トレイの担当者の割り当てと表示に使います。settings.users.readとsettings.users.teams.readは、同じHubSpotアプリを使う旧製品LITTLE HELP CONNECTが、サービス終了（2026年12月31日）まで使う権限です。Lumoは使いません |
| 認証 | oauth |
必須 | 連携の認証と、接続状態の確認に使います |
| 受信トレイ |
conversations.read、conversations.write、conversations.custom_channels.read、conversations.custom_channels.write
|
任意 | 受信トレイ同期で、LINEの会話をHubSpotの受信トレイとヘルプデスクに届け、HubSpotからの返信をLINEに送ります |
| ファイル | files |
任意 | 受信トレイ同期で、画像やファイルをやり取りします |
| 製品 | crm.objects.products.read |
任意 | HubSpotの製品を、配信のカード（コンテンツフィード）に使います。カートの商品カードで、商品名・画像・価格を補うときにも使います |
| カート・明細・注文 |
crm.objects.carts.read、crm.objects.line_items.read、crm.objects.orders.read
|
任意 | HubSpotのShopify連携で同期したカートや注文を登録元にしたワークフローから、商品カードや注文情報を差し込んだLINEを送ります |
任意の権限は、受信トレイ同期やEC向けの機能を使うときに必要です。あとから権限を追加するときは、連携を解除せずに、HubSpot連携の 「設定」 にある 「HubSpotを再認証する」 から許可し直せます。
連携直後に確認すること
連携が完了したら、HubSpot連携のダッシュボードで同期の状態を確認します。
連携のダッシュボードでは、次の内容を確認できます。
- 連携状態（正常／同期中／反映中／失敗）
- 初回同期の進行状況（コンタクトの処理件数など）
- 同期履歴
- 接続中のHubSpotアカウント（Hub ID）
データの反映が止まっているように見える場合は、ダッシュボードの 「プロパティを再同期」 から再同期をリクエストできます。再同期はデータ量によって完了まで数分かかる場合があります。
連携後に見直したい設定
連携後は、HubSpot連携画面の4つのメニューで運用に合わせた設定ができます。
| メニュー | 主にできること |
|---|---|
| ダッシュボード | 同期状態の確認、同期履歴の確認、プロパティの再同期 |
| 同期データ | HubSpotから取り込むコンタクトプロパティの追加・削除、使用箇所の確認、「使用時に自動で追加する」 の切り替え |
| ID連携 | 連携の状況の確認、フォーム送信からID連携、セグメントからID連携、ほかの方式（QRコード・マーケティングEメール）の案内 |
| 設定 | Hub IDの確認と接続チェック、同期と自動化（受信トレイ同期、コンタクトを自動作成、タスクを自動作成、グループチャットを会社として同期、帰属注文をHubSpotに書き戻す）、Lumo受信トレイに表示するプロパティ、HubSpot連携の解除、HubSpotからのアプリのアンインストール |
独自のHubSpotプロパティをLumoで使いたい場合は、「同期データ」 から 「HubSpotプロパティを追加」 で同期対象に加えてください。配信・ワークフロー・セグメントで使ったプロパティは、「使用時に自動で追加する」 がオンなら自動で同期対象に加わります。
HubSpotに自動作成されるプロパティ
連携すると、HubSpotのコンタクトにLINE関連の情報を保存するカスタムプロパティが自動で作成されます。
代表的なプロパティは次のとおりです。
| プロパティ | 内容 |
|---|---|
| LINE User ID | LINEのユーザー識別子 |
| LINE表示名 | LINEの表示名 |
| LINEプロフィール画像 | LINEのプロフィール画像 |
| LINEフォロー状態 | 友だち登録・ブロックの状態 |
| LINE友だち追加日 | 友だちになった日時 |
| LINEタグ | 友だちに付けたタグの情報 |
| LINE Traffic Source | 友だち追加のきっかけ。カスタムQRコード経由ならQRコードの名前 |
| 最終配信名／最終配信日 | 直近のLINE配信の情報 |
ここで書き戻される LINEタグ は、友だちに付ける タグ の情報です。配信対象を絞り込む セグメント とは別の概念です。HubSpotのセグメント（リスト）やプロパティを条件に配信対象を絞り込みたい場合は、Lumoの セグメント で条件を設定します。
接続するLINE公式アカウントや有効にした機能によって、作成されるプロパティは増えることがあります。これらのカスタムプロパティは、HubSpot側で削除・変更しないように注意してください。
HubSpotのワークフローにLINEのアクションを追加する
HubSpotのワークフローにLINEのアクションを追加すると、条件に合ったコンタクトへLINEを自動で届けられます。使えるアクションは、LINEメッセージを送信・LINE通知メッセージを送信・LINEリッチメニューを更新・フォーム送信によるID連携の4つです。
LINEメッセージを送る場合の手順は次のとおりです。
- HubSpotでコンタクトを対象にしたワークフローを作成します。
- アクションとして 「LINEメッセージを送信」 を追加します。
- 送信に使うLINE公式アカウントを選びます。
- 送信するメッセージの内容を設定します。
メッセージの内容は、次のどちらかを選べます。
| 設定方法 | 内容 |
|---|---|
| 自動送信メッセージから選ぶ | Lumoに保存済みの自動送信メッセージを選びます |
| メッセージ本文を直接入力する | HubSpot上で送るメッセージ本文を入力します |
ここで選べる 自動送信メッセージ は、Lumoであらかじめ作成しておく必要があります。
取引やチケットのワークフローからも、関連付けられたコンタクトに送れます。ほかの3つのアクションの設定項目と条件は、HubSpotワークフローで使えるLINEアクションで説明しています。
HubSpotのShopify連携（データ同期）で同期したカート・注文のワークフローからは、カートの商品を載せたカゴ落ちフォローや、注文情報を差し込んだ発送案内も送れます。
HubSpotからLINEのチャットを開く
HubSpotのコンタクト画面から、対象の友だちとのLINEチャットをそのまま開けます。
- HubSpotで対象のコンタクトを開きます。
- サイドバーに出てくるLumoのカードから、LINEチャットを開きます。
- Lumoのチャット画面が開き、その友だちとの会話履歴を確認できます。
会社のレコードや、チケットのレコード・ヘルプデスクのチケット画面からも、同じようにLINEチャットを開けます。
チャットが開かないときは、Lumoにログインした状態か、対象のコンタクトにLINEの友だちが紐づいているかを確認してください。Lumoのログインが切れている場合は、再ログイン後にもう一度開いてください。
HubSpotの受信トレイと同期する（任意）
受信トレイ同期は任意の機能です。HubSpotの受信トレイやヘルプデスクでLINEの会話を受け取り、そのまま返信したい場合に設定します。
受信トレイ同期を接続する
受信トレイ同期の接続は、HubSpotの受信トレイ設定から始めます。
- HubSpotの受信トレイ設定で、Lumoのチャネルを接続します。
- 接続の途中でLumoの画面が開いたら、同期するLINE公式アカウントを選びます。
- HubSpotに戻り、接続が完了したことを確認します。
- Lumoの 「設定」 > 「同期と自動化」 の 「受信トレイ同期」 で、接続先の受信トレイとチャネルアカウントを確認します。
接続すると、LINEで届いた会話がHubSpotの受信トレイとヘルプデスクに入り、HubSpotの画面から返信できます。画像やファイルの送受信にも対応しています。LINEからテストのメッセージや画像を送ってHubSpot側に出ること、HubSpotから返信してLINEに届くことを確認してください。
受信トレイ同期の状態を確認する
Lumoの 「同期と自動化」 にある 「受信トレイ同期」 では、接続状態を次の表示で確認できます。
| 表示 | 状態 |
|---|---|
| 接続済み | 受信トレイ同期が有効です |
| 未接続 | 受信トレイ同期はまだ接続されていません |
| 再接続が必要 | HubSpot側のチャネルが無効です。HubSpotの受信トレイ設定でLumoのチャネルを再接続してください |
セグメントからID連携する
HubSpotのコンタクトにLINE User IDがすでに保存されている場合は、その値を読み取ってLumoの友だちとID連携できます。
設定は、Lumoの 「ID連携」 > 「セグメントからID連携」 で行います。
- LINE User IDが入っているHubSpotのセグメント（リスト）を 「同期元セグメント」 で選びます。
- LINE User IDが保存されているHubSpotのプロパティを選びます。
- 設定を保存します。
同期元セグメントを指定すると、定期的にHubSpotから既存のLINE User IDを取り込み、Lumoの友だちと紐づけます。指定を削除すると、取り込みは止まります。
連携のあとに行うこと
連携が済んだら、コンタクトと友だちをID連携し、HubSpotのセグメントを使った配信やワークフローに進みます。
- HubSpotコンタクトとLINE友だちをID連携する：フォームやメール、QRコードなどで、コンタクトと友だちを紐づけます
- メッセージ配信の作成・送信方法：HubSpotのセグメントを配信先にして、メッセージ配信を作ります
- HubSpotワークフローで使えるLINEアクション：HubSpotのワークフローから、LINEを自動で送ります
配信づくりは、マーケティングエージェントに目標を伝えて任せることもできます。
連携を解除する
連携の解除は、Lumo側の解除とHubSpot側の削除が別の操作です。完全に切り離したい場合は両方を確認してください。
Lumo側で解除する
- HubSpot連携の 「設定」 を開きます。
- 受信トレイ同期を使っている場合は、「同期と自動化」 の 「受信トレイ同期」 で 「解除」 を実行します。
- 連携自体を解除する場合は、「HubSpot連携を解除」 を開き、確認のためにLumo IDを入力してから 「HubSpot連携を解除」 をクリックします。
- 確認ダイアログで解除を確定します。
連携を解除すると、HubSpotから同期したコンタクトデータと、Lumoの友だちとHubSpotコンタクトのID連携情報が消えます。HubSpotの属性を使ったセグメントで配信している場合は、解除する前に確認してください。配信対象が変わることがあります。
HubSpotからアプリをアンインストールする
HubSpotのアカウントからLumoアプリそのものを外す場合は、HubSpot連携の 「設定」 にある 「HubSpotからアプリをアンインストール」 を開きます。対象のHubSpotアカウントIDと影響を確認し、Lumo IDを入力してから 「アプリをアンインストール」 をクリックし、確認ダイアログで確定します。HubSpotの接続済みアプリからLumoアプリが削除され、続けてLumo側の連携も解除されます。実行できるのはワークスペースの管理者です。
同じHubSpotアカウントとアプリを、LumoのほかのLINE公式アカウントやワークスペースが使っている間は実行できません。先にそちらの連携を解除してください。同じアプリをCONNECTでも使っている場合は、確認ダイアログで停止してよいことを確認したうえで実行します。アンインストールすると、CONNECT側の接続も同時に止まります。HubSpotに作成済みのカスタムプロパティや過去の会話履歴は削除されず、HubSpotのコンタクトや取引をLumoが削除することもありません。
受信トレイのチャネルだけを外す場合は、HubSpotの受信トレイ設定で、接続済みのLumoのチャネルを削除または無効にします。Lumo側で解除しただけでは、HubSpot側のチャネル設定やカスタムプロパティ、過去の会話履歴は自動では削除されません。不要な場合はHubSpot側で手動で削除してください。
HubSpotの設定からアプリをアンインストールする
HubSpotの 「接続されたアプリ」 から、Lumoアプリをアンインストールすることもできます。アンインストールすると、Lumoは接続が無効になったことをしばらくして検知し、自動同期を止めます。
- HubSpotで、上部のナビゲーションバーにある設定アイコンをクリックします。
- 左側のサイドバーメニューで、「連携」 > 「接続されたアプリ」 を開きます。
- Lumoアプリの 「アクション」 をクリックし、「アンインストール」 を選びます。アプリ名は「Lumo (formerly LITTLE HELP CONNECT)」または「LITTLE HELP CONNECT」と表示されます。
- ダイアログのテキストフィールドに「アンインストール」と入力し、「アンインストール」 をクリックします。
アンインストールしたあとは、次のようになります。
- HubSpotでは、LumoアプリのLINEアクションとLINEチャットのカード、受信トレイのLumoのチャネルが使えなくなります
- Lumoでは、コンタクト同期やID連携などの自動同期が止まり、HubSpot連携の 「設定」 に 「HubSpotとの再接続が必要です」 と表示されます
- 同じアプリをCONNECTでも使っている場合は、CONNECT側の接続も同時に止まります
- HubSpotに作成されたカスタムプロパティは、HubSpotに残ります
引き続き使う場合は、「HubSpotを再接続する」 から接続し直します。使わない場合は、Lumoで 「HubSpot連携を解除」 を実行して、連携の情報を整理します。
もう一度連携する
もう一度連携するときの手順は、接続が無効になっただけか、連携を解除したかで変わります。
| 状況 | 手順 | 連携のあとの状態 |
|---|---|---|
| 「HubSpotとの再接続が必要です」 と表示されている（HubSpotでアプリをアンインストールした場合など） | HubSpot連携の 「設定」 で 「HubSpotを再接続する」 をクリックし、HubSpotで権限を許可します | 連携の設定はそのままで、止まっていた同期が自動で再開します |
| Lumoで 「HubSpot連携を解除」 を実行した、またはLumoからアプリをアンインストールした | 最初と同じ手順で、Lumoから、またはHubSpot App Marketplaceから連携します | HubSpotのコンタクトデータは、初回同期であらためて取り込みます。LINEの友だちとのID連携は、あらためて行います |
画面の上部に認証が無効になったお知らせが出ている場合は、お知らせの 「再接続画面を開く」 からも再接続の画面を開けます。
ID連携をあらためて行うとき、HubSpotのコンタクトにLINE User IDが残っていれば、「ID連携」 > 「セグメントからID連携」 で読み取って紐づけ直せます。フォームやメール、QRコードで紐づけ直すこともできます。
うまくいかないときは
連携や同期で困ったときは、まず権限と同期状態を確認すると原因を切り分けやすくなります。
| 症状 | 確認すること |
|---|---|
| 連携の認証に失敗する | HubSpotでアプリを連携できる「スーパー管理者」相当の権限を持っているか |
| 初回同期が始まらない | 連携完了から数分待ってから、ダッシュボードの同期状態と同期履歴を確認する |
| カスタムプロパティが作成されない | HubSpotのプロパティ作成の上限や権限設定を確認する |
| LINEのチャットが開かない | Lumoにログインした状態か、対象のコンタクトにLINEの友だちが紐づいているか |
| HubSpotの受信トレイに会話が出ない | 接続先の受信トレイとLINE公式アカウントの組み合わせが正しいか、受信トレイ同期が「再接続が必要」になっていないか |
解決しない場合は、Lumoのヘルプセンターまたはお問い合わせ窓口をご利用ください。
ヘルプセンター: https://guide.lumo.cx/hc/ja
お問い合わせ: https://www.littlehelp.co.jp/contact