> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HubSpot

> HubSpotワークフローからネイティブOneSignalインテグレーションを使用して、プッシュ通知、メール、SMS、アプリ内メッセージを自動化します。

## 概要

OneSignal HubSpotインテグレーションは、ネイティブワークフローアクションを通じてHubSpot CRMをOneSignalに接続します — サードパーティのミドルウェアは不要です。以下のことが可能です:

* **メッセージの送信** — HubSpotワークフローからプッシュ通知、メール、SMSをトリガー
* **ユーザーの作成** — HubSpotコンタクトをメールおよびSMSサブスクリプションと共にOneSignalに同期
* **タグの管理** — HubSpotコンタクトプロパティに基づいてOneSignal [タグ](./add-user-data-tags)を設定または削除
* **アプリ内メッセージのターゲティング** — HubSpotによって設定されたタグを使用して、アプリ内メッセージの配信を制御するセグメントを構築

A/Bテスト、インテリジェント配信、スロットリング、リターゲティングなどの機能については、OneSignalダッシュボードまたはAPIをHubSpotと並行して直接使用してください。

<Tip>
  実際の使用例については、[HubSpotとのOneSignalインテグレーションを使用してチャネル全体のエンゲージメントを高める4つの方法](https://onesignal.com/blog/four-ways-to-use-the-onesignal-integration-with-hubspot-to-boost-engagement-across-channels/)をお読みください。
</Tip>

<Frame>
  <iframe width="560" height="315" src="https://www.youtube.com/embed/SiGsvdAD6w8?si=8_WPdcNV2COIpaGM" title="OneSignal HubSpot integration overview" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />
</Frame>

***

## 前提条件

* HubSpot スーパー管理者ロールまたは[アプリマーケットプレイス権限](https://knowledge.hubspot.com/settings/hubspot-user-permissions-guide#admin)
* [有料OneSignalプラン](https://onesignal.com/pricing)（無料プランでは利用不可）

<Info>
  HubSpotは2024年12月に元のサードパーティOneSignalアプリを廃止しました。OneSignalは現在、拡張された機能を持つ独自のHubSpotアプリを提供しています。以前のインテグレーションを使用していた場合は、以下の移行手順をご確認ください。
</Info>

<Accordion title="旧HubSpotインテグレーションからの移行">
  **新しいインテグレーションのインストール**

  以下の[HubSpotをOneSignalに接続する](#connect-hubspot-to-onesignal)セクションで説明されているように、OneSignalダッシュボードの**データ > インテグレーション**からHubSpotインテグレーションを有効化します。

  **ワークフローの移行**

  既存のワークフローのアクションを置き換える前に、新しいインテグレーションをテストするための新しいワークフローを作成することをお勧めします。

  1. **ワークフローのクローン作成** — HubSpotの**ワークフロー**ページで、既存のワークフローの横にある**クローン**をクリックします。
  2. **トリガーの削除** — クローンされたワークフローから、公開時に自動的に起動しないよう、すべての登録トリガーを削除します。
  3. **旧アクションの置き換え** — 各旧OneSignalアクションを削除し、新しいバージョンに置き換えます。両方のアプリがインストールされている場合、旧アプリには「Built by HubSpot」と表示されます — 表示されない方を使用してください。

  <Frame caption="両方のアプリがインストールされている場合、「Built by HubSpot」と表示されないOneSignalアクションを使用してください。">
    <img src="https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a4e1a11d8c343bee5850147e5809d4c94c9966248433ab0ba59e5dce79a5a8b2-image.png?fit=max&auto=format&n=RWtLFPeffHrC81wI&q=85&s=9563ae1d3706dfdbe7f89b4f432a4ae7" width="920" height="1166" data-path="images/docs/a4e1a11d8c343bee5850147e5809d4c94c9966248433ab0ba59e5dce79a5a8b2-image.png" />
  </Frame>

  4. **単一コンタクトでのテスト** — ワークフローを保存して公開し、1つのテストコンタクトを手動で登録します。登録履歴を確認して、アクションが正常に完了したことを確認します。

  <Frame caption="移行されたHubSpotワークフローの例。">
    <img src="https://mintcdn.com/onesignal/MUgio66t0sYhGEvj/images/docs/687f1408480774304c930f72d62a82381c1ea11a9c66a8ce6595f568a3dd3b17-image.png?fit=max&auto=format&n=MUgio66t0sYhGEvj&q=85&s=e963ea94239c19696851e6edc4f18c92" width="1482" height="487" data-path="images/docs/687f1408480774304c930f72d62a82381c1ea11a9c66a8ce6595f568a3dd3b17-image.png" />
  </Frame>

  5. **置き換えまたは更新** — ワークフローが正しく動作することを確認したら、元のワークフローをクローンに置き換えるか、同じ変更を元のワークフローに適用します。

  移行中にエラーが発生した場合は、`support@onesignal.com`にお問い合わせください。
</Accordion>

***

## HubSpotをOneSignalに接続する

### インテグレーションの有効化

OneSignalで、**データ > インテグレーション > カタログ**に移動して**HubSpot**を選択します。

<Frame caption="OneSignalインテグレーションページのHubSpotインテグレーションカード。">
  <img src="https://mintcdn.com/onesignal/yCAJt5-6hubcDKe8/images/integrations/catalog-hubspot.png?fit=max&auto=format&n=yCAJt5-6hubcDKe8&q=85&s=91266c81fdf4cea8962c73761cc0c374" width="2902" height="1806" data-path="images/integrations/catalog-hubspot.png" />
</Frame>

**設定 > 認証**をクリックし、HubSpotアカウントを選択してログインします。

<Warning>
  各OneSignalアプリに接続できるHubSpotアカウントは1つのみです。テスト環境がある場合は、テスト用に別のOneSignalアプリを設定できます。
</Warning>

<Frame caption="このOneSignalアプリに接続するHubSpotアカウントを選択します。">
  <img src="https://mintcdn.com/onesignal/yCAJt5-6hubcDKe8/images/integrations/hubspot-settings.png?fit=max&auto=format&n=yCAJt5-6hubcDKe8&q=85&s=7faf6812bc71b1fd629c963de34e9efb" width="2902" height="1806" data-path="images/integrations/hubspot-settings.png" />
</Frame>

利用規約に同意して**アプリを接続**を選択すると、OneSignalにリダイレクトされます。新しく接続されたHubSpotアカウントを開いて接続を確認します。

### 外部IDでユーザーを照合する

HubSpotコンタクトをOneSignalユーザーにリンクするには、OneSignalの[外部ID](./users)をHubSpotの一意のプロパティ（ユーザーIDやメールアドレスなど）と一致する値に設定します。

SDKの`login`メソッドを使用して、アプリまたはウェブサイトで外部IDを設定します。照合が確実になるよう、アプリとHubSpotの両方で利用可能なプロパティを選択してください。

<Info>
  IDとサブスクリプション管理の詳細については、[ユーザー](./users)と[サブスクリプション](./subscriptions)をご覧ください。
</Info>

### HubSpotワークフローの作成

HubSpotで、**自動化 > ワークフロー**に移動して**ワークフローを作成**をクリックします。**コンタクトベース**を選択して、登録トリガーを設定します。

OneSignalアクションを追加するには、ワークフローエディターで\*\*+\*\*をクリックして「OneSignal」を検索します。

<Frame caption="HubSpot内のOneSignalワークフローアクション。">
  <img src="https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7857e4e4ce869bb57dfbce033baf2239054ba81e207a81565a62fe5618fb373b-Screenshot_2025-01-23_at_1.16.10_PM.png?fit=max&auto=format&n=jBdBk5XvQR5eKOks&q=85&s=ea5f0eb7187127a9f4fef2e338ac5a2c" width="1866" height="1340" data-path="images/docs/7857e4e4ce869bb57dfbce033baf2239054ba81e207a81565a62fe5618fb373b-Screenshot_2025-01-23_at_1.16.10_PM.png" />
</Frame>

すべてのOneSignalアクションには2つのフィールドが必要です:

<Frame caption="ワークフローアクションでのOneSignalアプリと外部IDの設定。">
  <img src="https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a9f3c793693436c0f9ef5c421f600b21ae241310e672303cb2f95fb7f0f8d103-Screenshot_2025-01-31_at_1.40.32_PM.png?fit=max&auto=format&n=RWtLFPeffHrC81wI&q=85&s=162b4cc4654129a4c029d4f0fa5041b8" width="828" height="550" data-path="images/docs/a9f3c793693436c0f9ef5c421f600b21ae241310e672303cb2f95fb7f0f8d103-Screenshot_2025-01-31_at_1.40.32_PM.png" />
</Frame>

* **OneSignalアプリ** — セットアップ時に接続したアプリ
* **外部ID** — OneSignalの外部IDに対応するHubSpotコンタクトプロパティ

***

## OneSignalアクション

### HubSpotからOneSignalユーザーを作成する

**ユーザー作成**アクションは、コンタクトがワークフローを通過するとOneSignalに[ユーザー](./users)を作成します。新しいコンタクトが追加されるにつれて、OneSignalとHubSpotの同期を維持するために使用します。

以下のHubSpotプロパティが設定されている場合、OneSignalは対応する[サブスクリプション](./subscriptions)を自動的に作成します:

* **メール** → OneSignalにメールサブスクリプションを作成
* **電話番号** → OneSignalにSMSサブスクリプションを作成

ユーザー作成ノード内で外部IDとタグを設定することもできます。

<Frame caption="HubSpotワークフロー内のOneSignalユーザー作成ノード。">
  <img src="https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/544e379b13eab1fdddfdaf646a879152ea6251f1833870f5ed2671e0e2558506-Screenshot_2025-03-10_at_4.34.19_PM.png?fit=max&auto=format&n=jFWn5xzleD8du3j6&q=85&s=c12475968bf18c8353ef576882855d03" width="1030" height="817" data-path="images/docs/544e379b13eab1fdddfdaf646a879152ea6251f1833870f5ed2671e0e2558506-Screenshot_2025-03-10_at_4.34.19_PM.png" />
</Frame>

<Warning>
  OneSignalアプリで[ダブルオプトイン](./sms-opt-in-and-collection#promotional-double-opt-in-form)が有効になっている場合、新しいSMSサブスクリプションは自動的にオプトインメッセージを受信します。ユーザー作成ノードでこれを無効にできます — SMSサブスクリプションは作成されますが、ユーザーが別途オプトインするまでサブスクライブされません。
</Warning>

***

### HubSpotからOneSignalタグを編集する

**タグ編集**アクションは、一致したOneSignalユーザーの[タグ](./add-user-data-tags)を設定または削除します。タグは[メッセージのパーソナライゼーション](./message-personalization)と[セグメンテーション](./segmentation)を可能にし、[HubSpotからアプリ内メッセージをターゲットにする](#send-in-app-messages-with-hubspot)メカニズムです。

#### タグの設定

タグフィールドにJSONオブジェクトを入力します:

```json theme={null}
{ "welcome": "1", "name": "<First Name property>" }
```

ワークフローエディターのHubSpotプロパティトークンインサーターを使用して、任意のHubSpotコンタクトプロパティをタグ値として挿入できます。例えば、OneSignalでメッセージをパーソナライズするためにユーザーの名前をタグとして追加する場合。

#### タグの削除

タグを削除するには、値を空の文字列に設定します:

```json theme={null}
{ "old_tag": "" }
```

タグがユーザーに存在しない場合は無視されます。

<Frame caption="タグ編集アクションで2つのタグ（'welcome'と'name'）を設定し、1つ（'key'）を削除する。">
  <img src="https://mintcdn.com/onesignal/56ctKxZSV4m5VEkn/images/docs/bb4ff8e3b5c8bf3742d721f94791f2e97137b89f58f3e862ff650b2c58d1e43a-Screenshot_2025-01-23_at_1.46.35_PM.png?fit=max&auto=format&n=56ctKxZSV4m5VEkn&q=85&s=6df8727cc9c5dd212c0c4ac62aeae71a" width="1866" height="1340" data-path="images/docs/bb4ff8e3b5c8bf3742d721f94791f2e97137b89f58f3e862ff650b2c58d1e43a-Screenshot_2025-01-23_at_1.46.35_PM.png" />
</Frame>

***

### HubSpotワークフローからメッセージを送信する

**通知の送信**アクションは、一致したOneSignalユーザーにプッシュ通知、メール、またはSMSを配信します。

<Tip>
  メールではなく**OneSignal外部ID**でユーザーを照合してください。メール照合は、`addEmail` SDKメソッドを使用してメールを設定した顧客向けのレガシーオプションです。
</Tip>

<Frame caption="OneSignal通知送信アクションの設定。">
  <img src="https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/c240529d9ab770443b90a8eb61db498edde6fdacc2c4a8efc8e1eb6c26582955-Screenshot_2025-01-23_at_2.19.19_PM.png?fit=max&auto=format&n=9_Q1FZLh6C0BFLq-&q=85&s=bf5975fd590611d5aedc7f297d4262d2" width="1866" height="1340" data-path="images/docs/c240529d9ab770443b90a8eb61db498edde6fdacc2c4a8efc8e1eb6c26582955-Screenshot_2025-01-23_at_2.19.19_PM.png" />
</Frame>

**テンプレートの使用**

OneSignalダッシュボードまたはAPIで作成した定義済みの[テンプレート](./templates)を選択します。テンプレートはプッシュ通知、メール、SMSをサポートします。

**フォームフィールドの使用**

テンプレートを選択しない場合は、タイトル、サブタイトル、メッセージ、画像URL、起動URLフィールドを使用してワークフローアクションで直接プッシュ通知を作成できます。メールとSMSはテンプレートでのみ利用可能です。

フォームフィールドオプションでは、HubSpotコンタクトプロパティ（例：`名前`）を挿入して通知コンテンツをパーソナライズできます。

***

#### HubSpotでアプリ内メッセージを送信する

アプリ内メッセージはHubSpotワークフローから直接送信することはできません。代わりに、HubSpotを使用してユーザーにタグを付け、OneSignalでセグメントベースのアプリ内メッセージでそれらのユーザーをターゲットにします。

<Steps>
  <Step title="HubSpotからユーザーにタグを付ける">
    HubSpotワークフローで、[タグ編集](#edit-onesignal-tags-from-hubspot)アクションを使用してコンタクトにタグを設定します。例: `{ "hubspot_campaign": "spring_promo" }`。
  </Step>

  <Step title="OneSignalでセグメントを作成する">
    OneSignalダッシュボードで、**オーディエンス > セグメント**に移動して**新しいセグメント**をクリックします。HubSpotによって設定されたタグのキーと値に一致する**ユーザータグ**フィルターを追加します（例: `hubspot_campaign`が`spring_promo`）。
  </Step>

  <Step title="アプリ内メッセージを作成する">
    **メッセージ > アプリ内**に移動して、新しいアプリ内メッセージを作成します。**オーディエンス**で**特定のセグメントに表示**を選択し、作成したセグメントを選択します。

    ユーザーがHubSpotワークフローを通過してタグを受け取ると、すぐにセグメントに追加されます。
  </Step>

  <Step title="トリガーを設定する">
    タグだけではアプリ内メッセージはトリガーされません。ユーザーがアプリを積極的に使用中にタグが設定された場合、次のセッションまでアプリ内メッセージは表示されません（アプリが30秒以上バックグラウンドになると新しいセッションが開始されます）。

    利用可能なトリガー:

    * **アプリ起動時** — ユーザーが次にアプリを開いたときに表示
    * **セッション時間** — セッション内の指定された秒数後に表示
    * **最後のアプリ内メッセージからの時間** — 連続したメッセージを防止
    * **プログラム的** — OneSignal SDKを使用してアプリコードからトリガー

    AND/OR演算子でトリガーを組み合わせる詳細については、[アプリ内メッセージトリガー](./iam-triggers)をご覧ください。
  </Step>
</Steps>

***

## 一般的なワークフローパターン

HubSpotワークフローは**登録トリガー**（ワークフローを開始するイベント）と**OneSignalアクション**（OneSignalでユーザーに何が起こるか）を組み合わせます。以下は一般的なユースケースに推奨されるパターンです。

<Info>
  以下のすべてのワークフローパターンは、すでに[HubSpotをOneSignalに接続している](#connect-hubspot-to-onesignal)こと、および[外部IDでユーザーを照合している](#match-users-with-external-id)ことを前提としています。
</Info>

### ウェルカムとオンボーディング

新しいユーザーがサインアップしたときにウェルカムメッセージを送信し、オンボーディングのアプリ内メッセージ用にタグを付けます。

| ステップ       | タイプ               | 設定                                                                                |
| ---------- | ----------------- | --------------------------------------------------------------------------------- |
| **登録トリガー** | HubSpot           | コンタクトプロパティ`顧客になった日`が既知                                                            |
| **アクション1** | OneSignal: ユーザー作成 | 外部IDをアプリと一致するHubSpotコンタクトプロパティ（ユーザーIDやメールアドレスなど）に設定                               |
| **アクション2** | OneSignal: タグ編集   | `{ "onboarding": "active", "name": "<First Name>" }` — 名前の値にHubSpot名前プロパティトークンを挿入 |
| **アクション3** | OneSignal: 通知送信   | ウェルカムプッシュテンプレートを使用、またはパーソナライズされたグリーティングでインラインで作成                                  |

<Tip>
  新しいユーザーを最初の起動時にアプリでガイドするために、`onboarding` = `active`セグメントをターゲットにした[アプリ内メッセージ](#send-in-app-messages-with-hubspot)と組み合わせてください。
</Tip>

### 再エンゲージメント

最近アプリを訪問していないユーザーにリーチします。

| ステップ            | タイプ             | 設定                                             |
| --------------- | --------------- | ---------------------------------------------- |
| **登録トリガー**      | HubSpot         | コンタクトプロパティ`最終アクティビティ日`が14日以上前                  |
| **アクション1**      | OneSignal: 通知送信 | 再エンゲージメントプッシュテンプレートを使用（例：「お久しぶりです — 最新情報はこちら」） |
| **遅延**          | HubSpot: 3日待機   | —                                              |
| **If/thenブランチ** | HubSpot         | コンタクトが登録後にサイトを訪問したか確認                          |
| **Yesブランチ**     | OneSignal: タグ編集 | `{ "reengaged": "true" }`                      |
| **Noブランチ**      | OneSignal: 通知送信 | より強いインセンティブを持つメールテンプレートを使用                     |

### ライフサイクルステージの変更

HubSpotのライフサイクルステージの変更をOneSignalタグと同期して、異なるユーザーセグメントをターゲットにできます。

| ステップ            | タイプ             | 設定                                                                              |
| --------------- | --------------- | ------------------------------------------------------------------------------- |
| **登録トリガー**      | HubSpot         | コンタクトプロパティ`ライフサイクルステージ`が任意の値に変更                                                 |
| **アクション1**      | OneSignal: タグ編集 | `{ "lifecycle_stage": "<Lifecycle Stage>" }` — 値にHubSpotライフサイクルステージプロパティトークンを挿入 |
| **If/thenブランチ** | HubSpot         | ライフサイクルステージ = `顧客`か確認                                                           |
| **Yesブランチ**     | OneSignal: 通知送信 | 「ようこそ」プッシュまたはメールテンプレートを使用                                                       |

### 成約 / 購入後

成約後にお礼のメッセージをトリガーし、アップセルキャンペーン用にユーザーにタグを付けます。

| ステップ       | タイプ             | 設定                                                                             |
| ---------- | --------------- | ------------------------------------------------------------------------------ |
| **登録トリガー** | HubSpot         | 案件プロパティ`案件ステージ` = `成約済み`                                                       |
| **アクション1** | OneSignal: タグ編集 | `{ "customer": "true", "deal_value": "<Amount>" }` — 値にHubSpot案件金額プロパティトークンを挿入 |
| **アクション2** | OneSignal: 通知送信 | お礼メールテンプレートを使用                                                                 |
| **遅延**     | HubSpot: 7日待機   | —                                                                              |
| **アクション3** | OneSignal: 通知送信 | アップセル/クロスセルプッシュテンプレートを使用                                                       |

<Note>
  案件ベースのワークフローには、HubSpotで**案件ベース**のワークフロータイプが必要です。関連するコンタクトの外部IDを使用してOneSignalユーザーを照合します。
</Note>

### アプリ内メッセージによるプロモーションキャンペーン

HubSpotリストまたはフォームによってトリガーされたアプリ内メッセージで特定のオーディエンスをターゲットにします。

| ステップ       | タイプ             | 設定                                        |
| ---------- | --------------- | ----------------------------------------- |
| **登録トリガー** | HubSpot         | コンタクトが静的または動的リスト（例：「スプリングセール対象者」）のメンバーになる |
| **アクション1** | OneSignal: タグ編集 | `{ "promo": "spring_2025" }`              |

その後、[HubSpotでアプリ内メッセージを送信する](#send-in-app-messages-with-hubspot)の手順に従って、`promo` = `spring_2025`に一致するOneSignalセグメントを作成し、そのセグメント用のアプリ内メッセージを設定します。

キャンペーン終了後にユーザーをキャンペーンから削除するには、タグを削除する2番目のワークフローを作成します:

| ステップ       | タイプ             | 設定                 |
| ---------- | --------------- | ------------------ |
| **登録トリガー** | HubSpot         | 日付ベース、キャンペーン終了日に設定 |
| **アクション1** | OneSignal: タグ編集 | `{ "promo": "" }`  |

***

## トラブルシューティング

### HubSpotでワークフローアクションが「失敗」と表示される

1. **エラーメッセージを確認する** — HubSpotワークフロー登録履歴で失敗したアクションを展開します。エラーメッセージには多くの場合、原因が示されています（例：「ユーザーが見つかりません」、「無効なアプリID」）。
2. **外部IDを確認する** — 外部IDとして使用されているHubSpotコンタクトプロパティがOneSignalのユーザーと一致することを確認します。**OneSignal > オーディエンス > ユーザー**でユーザーのプロフィールを確認し、外部IDで検索します。
3. **インテグレーションがアクティブであることを確認する** — **OneSignal > データ > インテグレーション > HubSpot**に移動して、接続ステータスがアクティブであることを確認します。

### メッセージが送信されたがユーザーが受信しなかった

1. **サブスクリプションを確認する** — ユーザーは送信するチャネル（プッシュ、メール、またはSMS）のアクティブなサブスクリプションを持っている必要があります。OneSignalのユーザープロフィールの**サブスクリプション**で確認します。
2. **セグメントメンバーシップを確認する** — セグメントターゲティングのテンプレートを使用している場合は、ユーザーがターゲットセグメントに属していることを確認します。
3. **メッセージレポートを確認する** — OneSignalダッシュボードで**メッセージ**に移動し、メッセージを見つけて配信レポートを確認して、メッセージが配信されたか、ドロップされたか、エラーになったかを確認します。

### OneSignalユーザーにタグが表示されない

1. **外部ID照合を確認する** — ワークフローの外部IDが既存のOneSignalユーザーと一致しない場合、タグ編集アクションは失敗します。ユーザーが存在することを確認するため、タグ編集の前に**ユーザー作成**アクションを使用してください。
2. **JSON形式を確認する** — タグは有効なJSONオブジェクトである必要があります。よくある間違いには、キーや値の引用符の欠如、末尾のカンマ、ダブルクォートの代わりにシングルクォートを使用することなどがあります。
3. **空の値を確認する** — タグ値を`""`に設定するとタグが削除されます。挿入されているHubSpotコンタクトプロパティが空白でないことを確認します。

### アプリ内メッセージが表示されない

以下のFAQの[タグが設定された後にアプリ内メッセージが表示されなかったのはなぜですか？](#why-didnt-my-in-app-message-display-after-the-tag-was-set)をご覧ください。

***

## FAQ

### HubSpotとOneSignal間でどのようなデータが共有されますか？

| HubSpot    | 方向 | OneSignal   | 説明                                                                                     |
| ---------- | -- | ----------- | -------------------------------------------------------------------------------------- |
| コンタクトプロパティ | →  | 外部ID、タグ     | HubSpotコンタクトデータは、[外部ID](./users)と[タグ](./add-user-data-tags)を通じてOneSignalユーザーを照合・強化します。 |
| ワークフロー     | ←  | メッセージテンプレート | OneSignal [テンプレート](./templates)はHubSpotワークフローアクションで選択可能です。                             |

インテグレーションはHubSpotリスト、案件、または会社レコードをOneSignalに自動的に同期しません。必要なデータを明示的に渡すには、ワークフローアクションを使用してください。

### 外部IDがOneSignalユーザーと一致しない場合はどうなりますか？

**通知の送信**と**タグ編集**アクションは静かに失敗します — メッセージは送信されず、タグも設定されません。ワークフローの他のOneSignalアクションの前には常に**ユーザー作成**アクションを配置して、ユーザーがOneSignalに存在することを確認してください。

### HubSpotリストを使ってOneSignalセグメントをターゲットにできますか？

直接はできません。HubSpotリストとOneSignalセグメントは独立したシステムです。ブリッジするには、HubSpotリストからコンタクトを登録するワークフローを作成し、**タグ編集**アクションを使用してタグを設定します。次に、そのタグに基づいてOneSignalセグメントを構築します。具体的な例については、[アプリ内メッセージによるプロモーションキャンペーン](#promotional-campaign-via-in-app-message)をご覧ください。

### HubSpotからどのOneSignalチャネルを送信できますか？

プッシュ通知はテンプレートまたはフォームフィールドを使用して送信できます。メールとSMSはOneSignalで作成した[テンプレート](./templates)を使用してのみ送信できます。アプリ内メッセージはHubSpotワークフローから送信できません — 代わりに[タグとセグメントパターン](#send-in-app-messages-with-hubspot)を使用してください。

### タグが設定された後にアプリ内メッセージが表示されなかったのはなぜですか？

タグだけではアプリ内メッセージはトリガーされません。タグはユーザーをセグメントに追加しますが、アプリ内メッセージを表示するにはまだ**トリガー**が必要です。ユーザーがアプリを積極的に使用中にタグが設定された場合、次のセッション（30秒以上バックグラウンド）まで表示されません。最も信頼性の高い動作のために、アプリ内メッセージトリガーを**アプリ起動時**に設定してください。すべてのトリガーオプションについては、[アプリ内メッセージトリガー](./iam-triggers)をご覧ください。

### HubSpotウェブフックを使ってOneSignal APIを直接呼び出せますか？

はい。HubSpotの**カスタムコード**ワークフローアクションを使用して、外部APIへのHTTPリクエストを行うことができます。[OneSignal REST API](/reference/create-notification)を呼び出して、ネイティブインテグレーションの外でメッセージの送信、ユーザーの作成、タグの更新を行うことができます。これは、ネイティブアクションがカバーしていないユースケース（個々のユーザーではなくセグメントへの送信など）に役立ちます。

### OneSignalメッセージイベントをHubSpotに送り返せますか？

はい。[イベントストリーム](./event-streams)を使用して、OneSignalメッセージイベント（送信済み、クリック済みなど）をウェブフックエンドポイントにエクスポートできます。これらのイベントをHubSpotの[カスタムイベントAPI](https://developers.hubspot.com/docs/api/analytics/events)にルーティングするか、ミドルウェアサービスを使用してOneSignalエンゲージメントデータに基づいてHubSpotコンタクトプロパティを更新することができます。

### HubSpotからOneSignalジャーニーをトリガーできますか？

HubSpotユーザーをOneSignal [ジャーニー](./journeys-overview)に入れるには2つのオプションがあります:

1. **タグ** — [タグ編集](#edit-onesignal-tags-from-hubspot)アクションを使用してユーザーにタグを設定します。そのタグに基づいてOneSignalでセグメントを作成し、そのセグメントをジャーニーの入口条件として使用します。
2. **カスタムイベント** — HubSpotの**カスタムコード**アクションを使用して[OneSignalカスタムイベントAPI](/reference/create-custom-events)を呼び出します。これはジャーニーの入口トリガーとして機能できます。

### HubSpotからOneSignalにカスタムイベントを送信できますか？

ネイティブワークフローアクションを通じては送信できません。ネイティブインテグレーションはユーザー作成、タグ編集、通知送信をサポートしています。カスタムイベントを送信するには、HubSpotの**カスタムコード**アクションを使用して[OneSignalカスタムイベントAPI](/reference/create-custom-events)を直接呼び出してください。

### どのHubSpot登録トリガーがOneSignalと連動しますか？

あらゆるHubSpot登録トリガーが機能します — OneSignalアクションはコンタクトがどのように登録されたかに関係なく実行される標準ワークフローアクションです。一般的なトリガーには以下があります:

* **コンタクトプロパティの変更**（ライフサイクルステージ、リードステータス、最終アクティビティ日）
* **フォーム送信**（サインアップフォーム、デモリクエスト、イベント登録）
* **リストメンバーシップ**（静的または動的リストへの追加）
* **案件ステージの変更**（パイプラインの進行、成約済み/失注）
* **日付ベース**（スケジュールされたキャンペーン、イベントからの経過時間）
* **手動登録**（一回限りの送信またはテスト用）

### 公開前にワークフローをテストするにはどうすればよいですか？

1. ワークフローを作成して、すべての自動登録トリガーを削除する
2. ワークフローを保存して公開する
3. 1つのテストコンタクトを手動で登録する
4. HubSpotの登録履歴でアクションの成功/失敗を確認する
5. OneSignalダッシュボードでユーザー、タグ、またはメッセージを確認する
6. 確認後、登録トリガーを追加して再公開する

***

<Columns cols={3}>
  <Card title="タグ" icon="tag" href="./add-user-data-tags">
    パーソナライゼーションとセグメンテーションのためにユーザーにカスタムプロパティを追加します。
  </Card>

  <Card title="テンプレート" icon="file-lines" href="./templates">
    プッシュ、メール、SMS用の再利用可能なメッセージテンプレートを作成します。
  </Card>

  <Card title="ジャーニー" icon="route" href="./journeys-overview">
    ユーザー行動によってトリガーされる自動マルチチャネルメッセージングフローを構築します。
  </Card>

  <Card title="イベントストリーム" icon="bolt" href="./event-streams">
    ウェブフックを介してリアルタイムメッセージイベントを外部プラットフォームにエクスポートします。
  </Card>

  <Card title="セグメンテーション" icon="users" href="./segmentation">
    タグ、行動、ユーザープロパティに基づいてオーディエンスセグメントを構築します。
  </Card>

  <Card title="アプリ内メッセージトリガー" icon="bell" href="./iam-triggers">
    アプリ内メッセージをユーザーに表示するタイミングと方法を制御します。
  </Card>
</Columns>