HubSpot連携のよくある質問

HubSpot連携の設定・同期・トラブルシューティングでよく寄せられる質問をまとめています。連携の設定そのものはエージェントに任せられます。チャットで「HubSpotとの連携設定を手伝ってください」と伝えると、必要な手順を案内し、設定を進めます。手動で確認・変更したい場合は、各セクションの操作手順を参照してください。

HubSpotのどのデータがLumoと同期されますか

HubSpotのコンタクト情報をLumoに取り込み、LumoのLINE関連データをHubSpotのコンタクトプロパティに書き込みます。双方向で同期するため、HubSpotとLumoの両方で同じ顧客情報を扱えます。

連携した直後は、名・姓・メールアドレス・電話番号を取り込みます。会社名やそのほかのHubSpotコンタクトプロパティは、必要なものだけを接続後に同期設定から選んで追加します。Lumo側からは、LINE User ID・LINE表示名・LINEフォロー状態・LINEタグ・最終配信日などのLINE関連プロパティをHubSpotに書き込みます。

同期する項目の確認や追加・削除は、HubSpot連携の 「同期データ」 画面で行います。

同期する項目はあとから追加できますか

はい、接続後に 「同期データ」 画面からいつでも追加・削除できます。初期状態の対象は基本項目だけなので、必要なプロパティを選んで足していきます。

追加の手順

1. HubSpot連携の 「同期データ」 画面を開きます。
2. 「HubSpotプロパティを追加」 をクリックします。
3. 同期したいHubSpotプロパティを選び、「新規プロパティを追加」 をクリックします。

配信・ワークフロー・セグメントでHubSpotプロパティを使った場合は、この手順を踏まなくても自動で同期対象に加わります。手動追加だけに絞りたいときは、「同期データ」 画面の 「使用時に自動で追加する」 をオフにしてください。切り替えられるのはワークスペースの管理者だけです。

同期ルールは「更新日時が新しい方」です。HubSpotとLumoで値が違う場合は、新しく更新された方の値を採用します。

HubSpot連携とLINE公式アカウントの「接続」は何が違いますか

LINE公式アカウントをLumoで使えるようにする操作は 接続、HubSpotなどの外部サービスをLumoとつなぐ操作は 連携 と呼びます。HubSpotを使う前提として、対象のLINE公式アカウントがLumoに接続済みである必要があります。

HubSpot連携は、接続済みのLINE公式アカウントとHubSpotアカウントを紐づける操作です。LINE公式アカウントがまだLumoにない場合は、先にLumoでLINE公式アカウントを接続してから、HubSpot連携を始めてください。

HubSpot MarketplaceとLumoのどちらから連携を始められますか

どちらからでも始められます。入口が違うだけで、連携後に使う設定は同じです。

HubSpot Marketplaceから始める場合

HubSpotのアプリインストール画面から進みます。途中でLumoにサインインし、連携するLINE公式アカウントを選んでから、HubSpotで必要な権限を承認します。

Lumoから始める場合

Lumoの連携ウィザードから進みます。LINE公式アカウントを選び、そのままHubSpotの認証に進みます。設定はエージェントに任せられます。チャットで「HubSpotとの連携設定を手伝ってください」と伝えると案内します。

HubSpotの既存コンタクトとLumoの友だちは自動でマッチングされますか

はい、メールアドレスなどの共通の項目で自動的に照合します。連携後、HubSpotに登録済みのコンタクトとLumoの友だちが共通項目で一致すると、同じ顧客として紐づきます。

紐づいたあとは、HubSpotとLumoの両方でデータをまとめて管理できます。HubSpotのセグメント（リスト）に登録されたコンタクトからLINE User IDを取り込んで紐づける運用もできます。詳しくは「HubSpotのセグメント（リスト）からLINE User IDを取り込めますか」を参照してください。

HubSpotのセグメント（リスト）からLINE User IDを取り込めますか

はい、HubSpotのセグメント（リスト）内のコンタクトからLINE User IDを読み取り、Lumoの友だちと紐づけられます。HubSpot連携の 「設定」 画面の 「リストからID連携」 で設定します。

設定する項目

同期元リストを指定すると、HubSpotから既存のLINE User IDを定期的に取り込みます。指定を削除すると取り込みは停止します。

マーケティングEメールからID連携できますか

はい、HubSpotのマーケティングEメールに連携用URLを入れて送ると、受信者がメール内のボタンからLINEログインしたときにID連携が成立します。

連携用URLはQRコードのID連携設定から生成し、HubSpotのパーソナライゼーショントークンを付けて、コンタクトごとの値に差し替わるようにします。URLはボタンまたは画像のリンクとして挿入してください。パーソナライゼーショントークンが差し替わるのは、HubSpotのマーケティングEメールだけです。外部のメールツールやテスト送信では連携できません。

LINEで送ったHubSpotフォームからID連携できますか

はい、メッセージ配信や自動送信メッセージで送るHubSpotフォームのURLに、LINE User IDを渡すクエリパラメーターを追加すると、フォーム送信と同時にID連携が成立します。

メッセージの作成画面で本文にHubSpotフォームのURLを入力すると、追加するクエリパラメーターの例が自動で出ます。フォーム側には、LINE User IDプロパティの非表示フィールドを追加しておいてください。LINEで受け取った本人がフォームを送信すると、コンタクトにLINE User IDが記録され、Lumoが自動で紐付けます。

サイトに設置したHubSpotフォームの送信からID連携できますか

はい、サイトに設置したHubSpotフォームの送信後に、完了メッセージや完了ページへLINE連携のQRコードやボタンを出し、送信されたメールアドレスでコンタクトとID連携できます。HubSpot連携の 「設定」 にある 「フォーム送信からID連携」 の 「有効化」 をオンにし、「LP設置コード」 をフォームのページに追加します。

送信後に別のページへ移動するフォームでは、「完了ページ設置コード」 を完了ページにも追加します（フォームのページと同じドメインのみ）。連携完了時の応答メッセージや遷移先は、自動で作られたQRコード 「HubSpotフォーム連携」 の設定で変えられます。新しいHubSpotフォーム（iframe埋め込み）では、HubSpot側の 「Developer code」 の埋め込みコードを使います。連携した友だちの流入経路は 「HubSpotフォーム」 として記録されます。

配信先にHubSpotのセグメント（リスト）を選んだのに受信者が0人になります

選んだ直後のセグメント（リスト）は、まだメンバーを取り込んでいないためです。同期が終わるのを待つと人数が出ます。

配信先に選んだばかりのHubSpotのセグメント（リスト）には 「（未同期）」 と付き、受信者のプレビューに 「HubSpotリストのメンバーを同期しています…」 と出ます。このあいだは人数が0人のままです。同期が終わってから画面を開き直すと、受信者の人数を確認できます。

しばらく待っても0人のままなら、HubSpot側のセグメント（リスト）にコンタクトが入っているかを確認してください。それでも変わらない場合は、HubSpot連携のダッシュボードで同期履歴とエラー内容を確認します。

同期エラーが起きたときはどうすればよいですか

エラーの内容を連携画面で確認し、原因を解消してから手動で再同期します。エラーが続く場合はサポートにお問い合わせください。

確認と再同期の手順

1. HubSpot連携の画面で、同期ステータスと同期履歴を確認します。失敗した場合はステータスが 「失敗」 になり、同期履歴にエラー内容が残ります。
2. エラーの原因を解消します。
3. 「データを再同期」 をクリックし、確認ダイアログで 「再同期する」 を選びます。

再同期のリクエスト後、データの反映には数分かかる場合があります。

HubSpotではどの権限が必要ですか

HubSpotのアプリをインストールできる権限が必要です。連携の種類によって承認する権限の範囲が変わります。

通常の連携では、コンタクト・会社・リスト・ワークフローに関する権限を使います。受信トレイ同期も使う場合は、会話の同期に必要な権限を追加で承認します。アカウントを選ぶと、HubSpot側で必要な権限の承認に進みます。

HubSpot Marketplaceから始める場合でも、連携先として使うLINE公式アカウントはあらかじめLumoに接続されている必要があります。

連携できるLINE公式アカウントの数に上限はありますか

1つのHubSpotアカウントに連携できるLINE公式アカウントの数には上限があります。複数のLINE公式アカウントを連携する場合は、Lumoがそれぞれを区別して扱います。

CONNECTから移行する場合のHubSpot連携の切り替えは、状況に合わせて個別にご案内していますので、サポート窓口までご相談ください。新規の場合はそのまま連携を進められます。具体的な連携可能数についても、サポートにご確認ください。

HubSpotのワークフローからLINEメッセージを送れますか

はい、HubSpotのワークフローにLINEのアクションを追加できます。使えるのは 「LINEメッセージを送信」 「LINE通知メッセージを送信」 「LINEリッチメニューを更新」 「フォーム送信によるID連携」 の4つです。LINEメッセージで送る内容は、Lumoに保存済みの自動送信メッセージか、HubSpot上で入力した本文のどちらかを選べます。

自動送信メッセージを使う場合は、先に送信元のLINE公式アカウントを選んでください。選んだアカウントに応じて、利用できる自動送信メッセージの候補が出ます。LINEメッセージの送信は、取引やチケットのワークフローからも、関連付けられたコンタクトに送れます。各アクションの設定項目はHubSpotワークフローで使えるLINEアクションで説明しています。

HubSpotの受信トレイ同期は必須ですか

いいえ、必須ではありません。受信トレイ同期を使わなくても、コンタクト同期・セグメント（リスト）同期・ワークフローのLINEアクションは利用できます。

HubSpotの受信トレイやヘルプデスクでLINEの会話を受け取り、そのまま返信したい場合のみ、受信トレイ同期を設定します。画像やファイルの送受信にも対応しています。接続はHubSpotの受信トレイ設定から始め、完了後にLumoの 「設定」 画面で接続状態を確認します。Lumo側で解除すると新しい会話の同期は停止しますが、HubSpot側のチャネル設定は自動では削除されません。

HubSpot内の画面を開くときにLumoへのログインが求められるのはなぜですか

HubSpot内でLumoの画面を開くときは、Lumo側でも認証状態を確認するためです。セッションが切れているとログインを求められます。

このときは、Lumoにサインインし直してから画面を開き直してください。受信トレイ接続の画面でも同様に、サインイン後に接続するLINE公式アカウントを選びます。

HubSpotの取引やチケットにも書き込みますか

いいえ、自動同期では取引やチケットに書き込みません。自動で書き込むのはコンタクトプロパティ（と、会社オブジェクト同期を有効にした場合の会社オブジェクト）です。

受信トレイからは、チケットや取引をその場で作成・編集できます。これはメンバーの操作によるもので、同期が自動で内容を書き換えることはありません。

タスクは別扱いです。「タスク自動作成」 を有効にすると、友だちからのメッセージ受信をきっかけに、コンタクトの担当者宛のHubSpotタスクを自動で作ります。既定はオフです。担当者が設定されていないコンタクトには作成されません。AIエージェントやLumoのワークフローが自動応答したメッセージには作りません。友だち追加など任意のタイミングで作りたい場合は、Lumoのワークフローのアクション 「HubSpotタスクを作成」 も使えます。

連携解除やアンインストールをすると、HubSpotのデータは自動で削除されますか

Lumo側の連携解除と、HubSpot側に残るデータの削除は別の操作です。連携を解除しても、HubSpotに作成済みのデータは自動では消えません。

連携を解除すると、HubSpotから同期したコンタクトデータと、顧客とのID連携情報が消えます。新しい同期やワークフローの実行も止まります。一方で、HubSpotに作成済みのカスタムプロパティ、書き込み済みの値、過去の会話履歴はHubSpot側に残ります。不要な場合はHubSpot側で手動で削除してください。再連携したあとに顧客が改めてID連携すると、紐づけを作り直します。

LINE User IDの取り込みが途中で止まったときはどうすればよいですか

取り込みの状況を確認し、エラーが表示されている場合は内容を確認してから再実行します。

HubSpot連携の画面で同期履歴とエラー内容を確認し、原因を解消したうえで取り込みを実行し直してください。問題が解消しない場合はサポートにお問い合わせください。

連携が切れた・再接続を求められたときはどうすればよいですか

HubSpotの認証が無効になると、画面に再接続のお知らせが出ます。ボタンから再接続すると、同期は自動的に再開します。

HubSpotの認証が無効になると、コンタクト同期やID連携などの自動同期が止まり、「HubSpotとの再接続が必要です」 というお知らせが出ます。「HubSpotを再接続する」 から再接続すると、同期は自動的に再開します。再接続しても解消しない場合は、サポートにお問い合わせください。

サポートに連絡するにはどうすればよいですか

Lumoヘルプセンター、または問い合わせ窓口をご利用ください。