この記事では、LumoとHubSpotを連携する手順と、連携後に利用できる主な機能を説明します。HubSpot連携を有効にすると、CRMデータとLINE公式アカウントのデータをLumo経由でつなげて運用できます。連携は、Lumoから始める方法と、HubSpot Marketplaceから始める方法の両方に対応しています。
HubSpot連携でできること
HubSpot連携を有効にすると、次の機能を利用できます。
- HubSpotのコンタクト、企業、リスト情報をLumoに同期する
- LINE関連の識別情報や会話運用データをHubSpotのカスタムプロパティに書き戻す
- HubSpotのコンタクト画面から LINE Chat カードを開く
- HubSpotワークフローで Send LINE Message を使ってLINEメッセージを送信する
- 必要に応じて HubSpot inbox を接続し、LINE会話と添付ファイルを同期する
連携前に確認すること
HubSpot連携を始める前に、次の条件を確認してください。
- Lumoの対象ワークスペースに管理者としてログインしている
- HubSpotでアプリをインストールできる権限を持っている
- 連携に使用するLINE公式アカウントがLumoに接続済みである
- HubSpot inbox も使う場合は、接続先 inbox を管理できる権限を持っている
どこから連携を始めるか
HubSpot連携は、次のどちらの入口からでも開始できます。
- HubSpot Marketplaceから始める: HubSpotでアプリを検索してインストールし、その途中でLumoにサインインして接続先のLINE公式アカウントを選びます
- Lumoから始める: Lumoの連携ウィザードからHubSpot認証に進みます
どちらの方法でも、最終的には同じHubSpot連携設定に接続されます。
HubSpot Marketplaceから連携する
このセクションでは、HubSpot MarketplaceからLumo連携を開始する手順を説明します。
- HubSpot App Marketplaceで Lumo を開きます。
- インストール先のHubを選択します。
- Sign in to Lumo をクリックします。
- Lumoのサインイン画面が表示されたら、対象ワークスペースにログインします。
- 接続に使う LINE Official Account を選択します。
- Continue in HubSpot をクリックします。
- HubSpotの認証画面で必要な権限を確認し、インストールを完了します。
- HubSpotの接続完了ダイアログを確認します。
HubSpot Marketplaceから始める場合も、新しくLINE公式アカウントを作成するのではなく、Lumoに登録済みの既存アカウントを選んで接続します。利用したいLINE公式アカウントがまだLumoにない場合は、先にLumo側で作成してください。
Lumoから連携する
このセクションでは、Lumoの連携ウィザードからHubSpot認証を完了する手順を説明します。
- Lumoのナビゲーションメニューから 「外部サービス連携」 を開きます。
- 「HubSpot」 を選択します。
- 「HubSpot連携を開始する」 をクリックします。
- ステップ1で、HubSpotからLumoへ同期する項目を確認します。
- ステップ2で、LumoからHubSpotへ追加するカスタムプロパティの内容を確認します。
- ステップ3で、HubSpotにログインし、対象のHubを選んで認証を完了します。
- ステップ4で、接続先のHub IDと同期対象を確認して完了します。
OAuth認証が完了すると、HubSpot側にはLumoが利用するカスタムプロパティが自動作成されます。初回同期とプロパティ作成が反映されるまで数分かかる場合があります。
OAuth認証画面で確認すること
認証画面では、次の点を確認してください。
- 意図したHubSpotアカウントとHubを選択している
- コンタクト、企業、リスト、ワークフローに関する権限を確認している
- HubSpot inbox を利用する場合は、会話同期に必要な追加権限も承認している
HubSpot inbox を使わない場合でも、コンタクト同期、LINE Chat カード、ワークフローアクションは利用できます。
連携直後に確認すること
連携が完了したら、LumoのHubSpot連携画面で次の内容を確認してください。
- 連携先のHub ID
- 同期ステータス
- 初回同期の進行状況
- 必要なカスタムプロパティがHubSpotに作成されていること
必要に応じて、HubSpotのコンタクト画面やワークフロー画面を開いて LINE Chat カードや Send LINE Message が表示されることも確認してください。
連携後に設定を見直す
HubSpot連携が完了したら、Lumo側で次の設定を確認すると運用しやすくなります。
- ダッシュボード: 同期ステータス、同期履歴、手動再同期を確認します
- データ: HubSpotからLumoに取り込む追加プロパティを設定します
- 設定: Hub ID、Lumo管理のプロパティ連番、HubSpot inbox 同期、接続解除を管理します
特に、メールアドレスや独自のHubSpotプロパティをLumoで使いたい場合は、接続後にデータ設定画面で追加してください。
HubSpotからLINEチャットを開く
このセクションでは、HubSpotのコンタクト画面からLINEチャットを開く手順を説明します。
- HubSpotで対象のコンタクトレコードを開きます。
- 右サイドバーに LINE Chat カードが表示されていることを確認します。
- Open LINE Chat をクリックします。
- Lumoの埋め込みチャット画面がモーダルで開き、対象の会話履歴を確認できます。
Lumoへのログインセッションが切れている場合は、再ログイン後に同じ操作をやり直してください。
HubSpotワークフローからLINEメッセージを送信する
このセクションでは、HubSpotワークフローでLINEメッセージ送信アクションを設定する手順を説明します。
- HubSpotでコンタクトベースのワークフローを作成します。
- アクション一覧から Send LINE Message を追加します。
- LINE Official Account を選択します。
- Message Source を選択します。
- 次のどちらかを設定します。
| Message Source | 設定内容 |
|---|---|
| Auto message template | Lumoに保存済みの自動送信メッセージを選択します |
| Custom message text | HubSpot上で送信するメッセージ本文を直接入力します |
ワークフローを有効化すると、条件に一致したコンタクトに対してLINE送信がキューされます。実行結果では queued が返ります。
HubSpot inbox を接続する
HubSpot inbox 同期は任意機能です。必要な場合のみ次の手順を実行してください。
- HubSpotの設定画面で Inbox & Help Desk > Inboxes を開き、接続先 inbox を選択します。
- Connect a channel から、Lumo の custom channel を接続します。
- HubSpotからLumoの受信トレイ接続ページにリダイレクトされたら、接続するLINE公式アカウントを選択します。
- HubSpotに戻って接続完了を確認します。
- LumoのHubSpot連携画面で 「設定」 > 「受信トレイ同期」 を開き、接続済み inbox 名と channel account を確認します。
- LINEでテストメッセージと画像添付を送信し、HubSpot inbox に表示されることを確認します。
Lumo側では受信トレイ同期の状態確認と解除を行えます。接続開始はHubSpot側の custom channel install flow から行います。
自動作成されるHubSpotプロパティ
HubSpot連携では、HubSpot側にLumo管理のカスタムプロパティを自動作成します。代表的な項目は次のとおりです。
| プロパティ | 説明 |
|---|---|
| LINE User ID | LINEのユーザー識別子 |
| LINE User Name | LINEの表示名 |
| LINE User Picture | LINEのプロフィール画像URL |
| LINE Follow | 友だち登録状態 |
| LINE ID Sync Date | LINEアカウントの連携日時 |
| LINE user tags | LINEで設定したタグ情報 |
| LINE Last Send Message | 最後に送信したLINEメッセージの情報 |
接続するLINE公式アカウントや有効化している機能によって、作成される項目は増える場合があります。
連携を解除する
Lumo側の接続解除と、HubSpot側のアプリ削除は別操作です。不要になった場合は両方を確認してください。
Lumo側で解除する手順:
- HubSpot連携画面で 「設定」 を開きます。
- HubSpot inbox を使っている場合は、「受信トレイ同期」 で 「受信トレイ同期を解除」 を実行します。
- HubSpot連携自体も停止する場合は、続けて 「連携解除」 をクリックします。
- 確認ダイアログで解除を確定します。
HubSpot側で削除する手順:
- HubSpotの設定画面で Inbox & Help Desk > Inboxes を開きます。
- 接続済みの Lumo custom channel を削除または無効化します。
- アプリ自体も不要な場合は、Connected Apps からLumoアプリを削除します。
Lumo側で受信トレイ同期を解除すると、新しい会話同期は停止します。ただしHubSpot側の channel 設定は自動削除されません。HubSpotに作成済みのカスタムプロパティや過去の会話履歴も自動削除されないため、不要な場合はHubSpot側で手動削除してください。
HubSpot ID連携インポート
HubSpotのコンタクトプロパティに保存されているLINE User IDを使って、HubSpotコンタクトとLINE友だちを一括で紐付けることもできます。
- LINE公式アカウントの設定画面で、HubSpotセクションの 「ID連携インポート」 を開きます。
- LINE User IDが保存されているHubSpotのコンタクトプロパティを選択します。
- 「インポートを開始」 をクリックします。
- マッチ数、アンマッチ数、重複数を確認します。
うまくいかないときは
このセクションでは、接続後によくある問題の確認ポイントと対処方法を説明します。
- 認証に失敗する: HubSpotでアプリをインストールできる権限を持っているか確認してください。
- 初回同期が始まらない: 連携完了後、数分待ってから同期ステータスと同期履歴を確認してください。
- カスタムプロパティが作成されない: HubSpotのプロパティ作成制限や権限設定を確認してください。
- ワークフローで候補が表示されない: 先に
LINE Official Accountを選択してからMessage Sourceを設定してください。 LINE Chatカードが開かない: Lumoへのログイン状態と、対象コンタクトにLINE友だちが紐付いているか確認してください。HubSpot inboxに会話が出ない: 接続先 inbox とLINE公式アカウントの組み合わせが正しいか、Lumoの 「受信トレイ同期」 が再接続が必要になっていないか確認してください。
サポートが必要な場合は、Lumoヘルプセンターまたはお問い合わせ窓口をご利用ください。
ヘルプセンター: https://knowledge.littlehelp.co.jp/ja
お問い合わせ: https://www.littlehelp.co.jp/contact