> ## 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.

# SMS同意キーワード管理

> SMSのオプトアウトキーワード、再サブスクライブフロー、自動応答を管理します。STOP/HELP/STARTの動作、英数字送信者向けのWebベースの配信停止、共有送信者のオプトアウト戦略、サブスクライバーの同意ステータスの確認について解説します。

オプトアウトを正しく管理することで、プログラムのコンプライアンスを維持し、メッセージの受信を停止したいサブスクライバーを保護できます。オプトアウトの処理方法は、送信者のタイプ（受信返信を受け取れるかどうか）によって異なります。

***

## オプトアウトキーワード

`STOP`、`HELP`、`START`は、キャリアによって義務付けられた正規のコンプライアンスキーワードです。これらのデフォルトの返信は保護されており、OneSignalダッシュボードやAPIから変更できません：

* `STOP`は、特定の送信者からのSMSメッセージをユーザーがオプトアウトします。認識されるエイリアス（`UNSUBSCRIBE`、`CANCEL`）は、同じ保護された返信を共有します。
* `HELP`は、メッセージングプログラムに関する情報を返します。
* `START`は、オプトアウト後にユーザーが再びオプトインできるようにします。認識されるエイリアス（`UNSTOP`、`YES`）は、同じ保護された返信を共有します。

デフォルトの返信をカスタマイズするには、App IDと新しい応答メッセージを添えて`support@onesignal.com`までご連絡ください。

デフォルトでは、ユーザーがSTOPをテキストで送信すると、OneSignalは次のように返信します：*「You have successfully been unsubscribed. You will not receive any more messages from this number. Reply START to resubscribe.」*

<Note>
  デフォルトでは、オプトアウトはサブスクライバーがテキストを送信した特定の送信者からのメッセージのみを防止します。これにより、オプトアウトがユースケースの範囲に限定されます。プロモーション用の送信者にSTOPをテキストで送信したサブスクライバーは、他の送信者からのトランザクションメッセージやOTPを引き続き受信します。
</Note>

***

## 英数字送信者向けのオプトアウト管理

英数字の送信者ID（例：電話番号ではなく「ACME」）は受信返信を受け取れないため、サブスクライバーはSTOPをテキストで送信してオプトアウトできません。コンプライアンスを維持するには、オプトアウトを処理し、API経由でOneSignal内のサブスクライバーのステータスを更新するWebベースの配信停止ページを提供する必要があります。

<Steps>
  <Step title="すべてのメッセージに配信停止リンクを含める">
    送信する各SMSに、ホストされた配信停止ページのURLを追加します。OneSignalのLiquidタグを使用して、URL内でサブスクライバーを識別します：

    ```
    To opt out: https://yourbrand.com/sms-unsubscribe?uid={{ onesignal_id }}
    ```

    OneSignalは送信時に`{{ onesignal_id }}`（または`{{ subscription_id }}`）をサブスクライバーの実際のIDにレンダリングするため、各受信者はパーソナライズされた配信停止リンクを受け取ります。
  </Step>

  <Step title="配信停止ページを構築する">
    そのURLにシンプルなWebページをホストします。ページが読み込まれると、クエリパラメータからサブスクライバーIDを読み取ります。このページでは次のことを行う必要があります：

    * サブスクライバーに何をオプトアウトしようとしているかを確認する（例：「You will no longer receive promotional text messages from ACME.」）。
    * 確認ボタンを表示する。誤クリックやリンクプレビューが意図しないオプトアウトを引き起こす可能性があるため、ページ読み込み時に自動的に配信停止しないでください。
    * 同じ送信者から複数のタイプを送信している場合は、オプションでサブスクライバーがどのメッセージタイプをオプトアウトするかを選択できるようにする。
  </Step>

  <Step title="OneSignal APIを呼び出してオプトアウトを処理する">
    サブスクライバーが確認したら、OneSignal APIを呼び出してサブスクリプションステータスを更新します。範囲に応じて2つのオプションがあります：

    * **送信者からの完全な配信停止：** [Update Subscription API](/reference/update-subscription)を使用して、サブスクリプションのステータスをunsubscribedに設定します。
    * **特定のメッセージタイプのオプトアウト：** [Edit Tags API](/reference/edit-tags-with-external-user-id)を使用してタグ（例：`promo = false`）を設定し、そのメッセージタイプを送信する際にそのタグを持つサブスクライバーを除外します。
  </Step>

  <Step title="確認を表示する">
    API呼び出しが成功したら、確認メッセージを表示します（例：「You've been unsubscribed. You will no longer receive promotional texts from ACME.」）。
  </Step>
</Steps>

<Card title="SMSのオプトインと収集" icon="user-plus" href="./sms-opt-in-and-collection">
  SMSを送信する前に有効な同意を収集して、サブスクライバーがオプトインした後にのみこのオプトアウトフローに到達するようにします。
</Card>

***

## 共有送信者向けのオプトアウト管理

<Warning>
  テキストプログラム（プロモーション、トランザクション、OTP）間で送信者を共有することはお勧めしません。サブスクライバーがSTOPをテキストで送信すると、その送信者全体からオプトアウトされます。つまり、プロモーションメッセージのオプトアウトが、注文確認やアカウントアラートのようなトランザクションメッセージもブロックすることになります。可能な限り、ユースケースごとに別々の送信者を使用してください。
</Warning>

共有送信者がある場合は、カスタムキーワードを使用して、サブスクライバーがすべてから配信停止することなく特定のメッセージタイプをオプトアウトできるようにすることができます。これは、サブスクライバーがオプトアウトキーワードをテキストで送信したときにタグを付け、そのタイプのメッセージを送信する際にそれらのサブスクライバーを除外することで機能します。

**仕組み：**

1. サブスクライバーがカスタムオプトアウトキーワード（例：NOPROMO）を送信者にテキストで送信します。
2. OneSignalがそのサブスクライバーのプロファイルにデータタグ（例：`promo = false`）を適用します。
3. プロモーションキャンペーンを送信する際、`promo = false`のサブスクライバーを除外するようにオーディエンスをフィルタリングします。

**カスタムオプトアウトキーワードの設定：**

**Settings > Platforms > SMS Settings > Keywords**に移動し、サブスクライバーが個別にオプトアウトできるようにしたいユースケースごとにキーワードを作成します。

**例：プロモーションのオプトアウトキーワード（NOPROMO）：**

1. キーワードテキスト（例：NOPROMO）を入力します。
2. オーディエンスの範囲を**Anyone**に設定します。
3. 返信テンプレートを選択または作成します（例：*「You've been unsubscribed from promotional messages. You'll still receive order and account notifications. Text STOP to unsubscribe from all messages.」*）。
4. データタグを割り当てます：`promo = false`。

ユースケースごとに繰り返します。トランザクションメッセージの場合は、`transactional = false`を持つNOTRANSACTを作成します。

**送信時にオプトアウトしたサブスクライバーを除外する：**

特定のユースケース向けのキャンペーンやJourneyを構築する際は、Segmentsの**User Tag**フィルターを使用して、オプトアウトしたサブスクライバーを除外します。たとえば、プロモーションメッセージを送信する際は、`promo = false`のサブスクライバーを除外します。

**重要な制限事項：**

* デフォルトのコンプライアンスキーワード（STOP、HELP、START）は引き続き送信者全体に適用され、ユースケースの範囲に限定することはできません。
* そのタイプのすべてのメッセージにカスタムオプトアウトキーワードを含める必要があります（例：*「Reply NOPROMO to stop promotional texts」*）。
* 英数字の送信者IDは返信を受け取れず、キーワードをサポートしていません。
* 返信同期を有効にする必要があります。**Settings > Platforms > SMS Settings > Senders > Setup Replies**に移動してください。

<Card title="SMSキーワード" icon="message" href="./keywords">
  双方向キャンペーンや設定センターを含む、カスタムキーワードの設定に関する完全なリファレンス。
</Card>

***

## 再サブスクライブ

ユーザーがデフォルトのオプトアウトキーワードを使用してオプトアウトすると、OneSignalダッシュボードやAPIを通じて再サブスクライブすることはできません。ユーザーは、同じ送信者番号に再サブスクライブキーワード（`START`、`UNSTOP`、または`YES`）をテキストで送信する必要があります。

***

## HELPキーワード

デフォルトでは、ユーザーがHELPをテキストで送信すると、OneSignalは次のように返信します：*「Reply STOP to unsubscribe. Msg\&Data Rates May Apply.」*

***

## 自動応答

キーワードに一致しない受信メッセージに対して自動返信を設定します。これを使用して、ユーザーをカスタマーサポートにリダイレクトしたり、ユーザーの意図を収集したり、フォローアップのためにチームに通知したりします。

<Steps>
  <Step title="自動応答設定に移動する">
    **Settings > Platforms > SMS Settings > Auto-Responder**に移動します。
  </Step>

  <Step title="自動応答を追加する">
    **Add Auto-Responder**をクリックし、返信テンプレートを選択します。
  </Step>

  <Step title="オプションでユーザーにタグを付ける">
    自動応答が発火したときにデータタグを割り当てて、将来のセグメント化やアラートを可能にします。
  </Step>
</Steps>

***

## サブスクライバーのオプトアウトステータスの確認

サブスクライバーがどの送信者からオプトアウトしているかを確認するには：

1. OneSignalダッシュボードで**Audience > Subscriptions**に移動します。
2. External ID、メール、または電話番号でサブスクライバーを検索します。
3. SMSサブスクリプションを開き、**Consent by Sender**の下を確認します。

このセクションには、そのサブスクリプションに関連付けられた各送信者のオプトインまたはオプトアウトのステータスが表示されます。

***

## よくある質問

### ユーザーが共有送信者にSTOPをテキストで送信するとどうなりますか？

トランザクションメッセージやOTPを含む、その送信者からのすべてのメッセージがオプトアウトされます。これが、プログラムタイプごとに別々の送信者を使用することを強くお勧めする理由です。STOPでオプトアウトすると、ユーザーは再びメッセージを受信するために、同じ送信者にSTART（または別の再サブスクライブキーワード）をテキストで送信する必要があります。

### STOPまたはHELPの応答メッセージを変更できますか？

はい、ただしダッシュボードやAPI経由ではできません。App IDと新しい応答テキストを添えて`support@onesignal.com`までご連絡ください。

### 英数字の送信者IDにはどのオプトアウト機構を使用しますか？

英数字の送信者IDは返信を受け取れないため、すべてのメッセージに配信停止リンクを含め、オプトアウトを処理するためにOneSignal APIを呼び出すWebベースの配信停止ページを構築する必要があります。上記の[英数字送信者向けのオプトアウト管理](#managing-opt-outs-for-alphanumeric-senders)セクションを参照してください。

### STOPをテキストで送信したユーザーを再サブスクライブできますか？

ダッシュボードやAPIを通じてユーザーを再サブスクライブすることはできません。ユーザーは、再びオプトインするために、同じ送信者番号にSTART、UNSTOP、またはYESをテキストで送信する必要があります。

### 1回のSTOPがすべてのメッセージタイプをブロックするのを防ぐにはどうすればよいですか？

プログラムタイプ（プロモーション、トランザクション、OTP）ごとに別々の送信者を使用します。共有送信者を使用する必要がある場合は、カスタムオプトアウトキーワード（例：NOPROMO）を設定し、送信時にタグでオプトアウトしたサブスクライバーを除外します。デフォルトのSTOPキーワードは引き続き送信者全体から配信停止することに注意してください。
