MoEngage × HubSpot
MoEngage と HubSpot の統合により、シームレスなデータ同期を通じてマーケティングと営業の取り組みを強化できます。この統合により、次のことができます。- HubSpot から MoEngage に連絡先、商談などを同期する。
- 通話、タスク、ミーティングなどの営業活動を行動イベントとしてインポートする。
- カスタムモジュールを取り込み、包括的な顧客プロファイリングを行う。
ユースケース
HubSpot を MoEngage と統合すると、次のユースケースに対応できます。- 有望なリードを育成する: HubSpot のリードスコアリングやライフサイクルステージの進行に基づいて、パーソナライズされた MoEngage キャンペーンを送信します。
- 失注した商談に再エンゲージする: 商談が Closed Lost とマークされたときに、ターゲットを絞ったウィンバックキャンペーンを送信して、見込み顧客に再度エンゲージします。
- ライフサイクルキャンペーンをトリガーする: 連絡先が Customer ライフサイクルステージに移行したときに、ウェルカムシリーズを自動的に送信します。
同期モジュール
次の表は、各モジュールのデフォルトの同期タイプの概要です。会社情報: Companies モジュールもサポートされています。データを常に最新の状態に保つため、関連する会社情報はそれぞれ Contacts レコードと Deals レコードとともに同期されます。
統合
前提条件HubSpot アカウント内のワークフロー機能と Webhook 機能にアクセスできることを確認してください。
ステップ 1: MoEngage エンドポイントを取得する
統合用の専用エンドポイントを取得するには、MoEngage サポートチームにお問い合わせください。リクエストでは、MoEngage とパートナープラットフォームの間でユーザープロファイルを紐付けるために使用する共通の識別子を指定する必要があります。ステップ 2: HubSpot でワークフローを作成する
ワークフローを設定するには、次の手順を実行します。- HubSpot ダッシュボードのサイドバーメニューで、Automation アイコン
にカーソルを合わせます。Automation メニューが表示されます。 - Workflows をクリックします。
- Workflows ページで、右上隅にある Create workflow をクリックします。
- Create workflow リストで From scratch を選択します。
- 次に、ワークフローのイベントタイプとプライマリオブジェクト（Contact、Deal など）を選択します。
- 次に、トリガーを設定し、フィルターを使用して具体的な登録条件を定義します。たとえば、Contact Property（Lifecycle Stage）または Deal Stage が更新されたときにワークフローをトリガーできます。
ステップ 3: Webhook アクションを設定する
Webhook アクションを設定するには、次の手順を実行します。- トリガーアクションを設定したら、Next をクリックして先に進みます。
- Choose an action セクションで、Data Ops > Send a webhook を選択します。
- 次の詳細を入力します。
| HubSpot のセクション | 説明 |
|---|---|
| Method | POST |
| URL | MoEngage から提供された専用の Webhook URL を次の形式で入力します。https://api-0X.moengage.com/v1/partner/hubspot/{events/user}/?configName={config_name} |
| Custom Headers | Headers
Authorization オンラインの Basic Auth Header Generator ツールを使用して、Basic 認証トークンを生成します。ユーザー名として Workspace ID を、パスワードとして Data API Key を入力する必要があります。認証情報を確認するには、次の手順を実行します。
Basic Qk5CR1NNNUR4eHh4eHhWQ1hSRFJEWTdSOlFsWHVoTHVaeHh4eHh4QWQrQnBYUEotNw==注: トークンは余分なスペースを含めず、完全にコピーしてください。 |
ステップ 4: リクエスト本文を設定する
Webhook のペイロードを設定するには、次の手順を実行します。- Request Body セクションで、Customize request body チェックボックスをオンにします。
- 同期タイプ（Users または Events）に基づいて、次の詳細を追加します。
必要に応じて、Add property オプションと Add static value オプションを使用して、特定のユースケース向けに追加のプロパティを追加できます。
- customer_id: すべての同期にわたって一意かつ永続的な ID である必要があります。
- modified_time と type: ユーザーデータとイベントデータの両方の同期に必須です。
- event_name: MoEngage で適切な分類とセグメンテーションを行うため、イベントデータに必須です。
- ユーザー属性（u_*）: ユーザーデータには必須ですが、イベントデータでは任意です。
データマッピングのガイドライン
- 一意の識別子（Customer ID）: HubSpot CRM データから、一貫性があり変更されない一意の識別子（external_id、メールアドレス、電話番号など）を使用します。この値を MoEngage ペイロードの
customer_idフィールドにマッピングします。これは、データのマージと重複するユーザープロファイルの防止に不可欠です。 - 必須フィールド: すべてのペイロードには、
customer_id、modified_time、typeフィールドを含める必要があります。これらは、適切なデータ処理、検索、セグメンテーションに不可欠です。 - Type: MoEngage で正確なセグメンテーションとターゲティングを行うため、レコードタイプを “Contacts”、“Leads”、または “Deals” として指定します。
- Event Name: MoEngage でアクションを識別および分類するため、すべてのイベントに
event_nameを含めます。これにより、分析とセグメンテーションのためにすべてのイベントが正確にトラッキングされます。
レート制限
プラットフォームの安定性を維持するため、MoEngage は HubSpot データの取り込みを、ワークスペースごとに最大 500 リクエスト/秒（RPS）に制限しています。ワークスペースがこの制限を超えると、MoEngage は HTTP429 (Too Many Requests) ステータスコードを返します。
レート制限がデータフローにどのように影響するかについては、HubSpot のデフォルトの再試行ポリシーを参照してください。
ペイロードサイズやその他の取り込み制限の詳細については、パートナーデータ取り込みのレート制限を参照してください。