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

# AgencyHandy ワークスペースにカスタムドメインを接続する

> DNS レジストラで CNAME レコードを追加することで、独自のサブドメイン（例：portal.yourcompany.com）を AgencyHandy に接続します — コーディング不要。

デフォルトでは、AgencyHandy ワークスペースは `agencyhandy.com` 配下のサブドメインでアクセスできます。カスタムドメインを接続することで、そのデフォルト URL を独自のブランドアドレス（例：`portal.youragency.com`）に置き換えることができます。これにより、クライアントが最初にアクセスするページからブランドを強化する、シームレスでプロフェッショナルな体験を提供できます。

<Note>
  カスタムドメインを設定できるのは**スーパー管理者**と**管理者**のみです。また、このセットアップを完了するには、ドメインを所有し、レジストラで DNS 設定にアクセスできる必要があります。
</Note>

***

## 仕組み

AgencyHandy にカスタムドメインを追加すると、プラットフォームが **CNAME レコード**を提供します。そのレコードをレジストラ（GoDaddy、Namecheap、Cloudflare など）のドメインの DNS 設定に追加し、DNS が伝播したら AgencyHandy が接続を確認します。

***

## ステップバイステップのセットアップ

<Steps>
  <Step title="カスタムドメイン設定を開く">
    AgencyHandy アカウントにログインします。左サイドバーの**ワークスペース設定**に移動し、**カスタムドメイン**をクリックします。
  </Step>

  <Step title="カスタムドメインを追加する">
    **+ カスタムドメインを追加**ボタンをクリックします。表示された入力フィールドに使用したいサブドメイン（例：`portal.youragency.com`）を入力します。

    <Warning>
      サブドメインとして `www` は使用**しないで**ください（つまり `www.youragency.com` は避けてください）。`www` プレフィックスは設定の競合を引き起こし、確認の成功を妨げます。`portal`、`client`、`app`、`hub` などの別のサブドメインを使用してください。
    </Warning>
  </Step>

  <Step title="CNAME レコードの詳細をコピーする">
    ドメインを送信すると、AgencyHandy が追加に必要な DNS レコードを表示します：

    | フィールド   | 値                      |
    | ------- | ---------------------- |
    | **タイプ** | CNAME                  |
    | **名前**  | サブドメイン（例：`portal`）     |
    | **値**   | AgencyHandy が提供するターゲット |

    これらの値は次の手順で必要になるため、正確にコピーしてください。
  </Step>

  <Step title="DNS レジストラで CNAME レコードを追加する">
    ドメインレジストラのダッシュボード（例：GoDaddy、Namecheap、Cloudflare）にログインします。ドメインの DNS 管理セクションに移動し、AgencyHandy からコピーしたタイプ、名前、値を使用して CNAME レコードを追加します。

    Cloudflare 固有のガイダンスについては以下をご覧ください。
  </Step>

  <Step title="AgencyHandy でドメインを保存する">
    AgencyHandy に戻り、**ドメインを保存**をクリックします。DNS の伝播中は最初に**未接続**と表示されます — これは正常です。
  </Step>

  <Step title="DNS の伝播を待ち、確認する">
    DNS の変更がグローバルに伝播するには、レジストラと TTL の設定によっては数分から**最大 48 時間**かかる場合があります。定期的に**更新**をクリックして接続ステータスを確認してください。

    伝播が完了すると、ステータスが**接続済み** ✅ に変わります。
  </Step>
</Steps>

<Warning>
  DNS の伝播には最大 **48 時間**かかる場合があります。48 時間経過後もドメインが**未接続**と表示される場合は、CNAME レコードが正しいことと、同じサブドメインに競合する DNS レコードが存在しないことを確認してください。
</Warning>

***

## Cloudflare 固有の手順

ドメインが Cloudflare で管理されている場合、正しく設定しなければならない重要な設定が 1 つあります：

<Steps>
  <Step title="Cloudflare にサインインしてドメインを選択する">
    [Cloudflare ダッシュボード](https://dash.cloudflare.com)を開き、AgencyHandy に接続するドメインをクリックします。
  </Step>

  <Step title="DNS 設定に移動する">
    ドメイン設定パネルの上部ナビゲーションで **DNS** タブをクリックします。
  </Step>

  <Step title="CNAME レコードを追加する">
    **+ レコードを追加**をクリックしてフィールドを入力します：

    * **タイプ：** CNAME
    * **名前：** サブドメイン（例：`portal`）
    * **ターゲット/コンテンツ：** AgencyHandy が提供する値
    * **TTL：** 初期セットアップ時は **2 分**（または利用可能な最小オプション）に設定
  </Step>

  <Step title="Cloudflare プロキシを無効にする（重要）">
    **プロキシステータス**列で、トグルが **DNS のみ**に設定されていることを確認します（クラウドアイコンはオレンジではなくグレーで表示されるべきです）。

    <Warning>
      Cloudflare プロキシが**有効**（オレンジのクラウドアイコン）になっている場合、CNAME レコードが正しく解決されず、AgencyHandy はドメインを確認できません。接続を機能させるには **DNS のみ**に設定する必要があります。
    </Warning>
  </Step>

  <Step title="レコードを保存する">
    すべての値を正確に確認して**保存**をクリックします。
  </Step>
</Steps>

<Tip>
  [dnschecker.org](https://dnschecker.org) を使用して、世界のさまざまな地域での CNAME レコードの伝播を監視してください。AgencyHandy が接続を確認することを期待する前に、すべての地域で緑色のチェックマークが表示されるのを待ってください。
</Tip>

***

## 接続ステータスの監視

保存後、AgencyHandy の**ワークスペース設定 → カスタムドメイン**に戻ってステータスを追跡してください：

| ステータス    | 意味                                                   |
| -------- | ---------------------------------------------------- |
| **未接続**  | DNS レコードがまだ伝播していないか、エラーが含まれている                       |
| **接続済み** | ドメインが確認され、アクティブ — クライアントはカスタム URL からワークスペースにアクセスできます |

***

## カスタムドメインの更新または削除

* **ドメインを更新するには：** 既存のエントリを削除し、上記と同じセットアップ手順を使用して新しいドメインを追加します。
* **ドメインを削除するには：** カスタムドメインパネルのドメイン横の**削除**ボタンをクリックして削除を確認します。ワークスペースはデフォルトの AgencyHandy URL に戻ります。いつでも任意のドメインを再度追加できます。

***

## 重要な注意事項

* **サブドメインを使用し、ルートドメインは使用しない：** AgencyHandy のカスタムドメインにはサブドメイン（例：`portal.youragency.com`）が必要で、ルート/アペックスドメイン（例：`youragency.com`）は使用できません。
* **`www` を避ける：** `www` サブドメインは確認中に問題を引き起こす可能性があります。代わりにカスタムサブドメイン名を使用してください。
* **正確なレコードが必要：** AgencyHandy に表示されているとおりに CNAME タイプ、名前、値を正確に入力してください。タイプミスや文字の不足があると接続できません。
* **Cloudflare プロキシはオフにする：** AgencyHandy のカスタムドメイン確認のために、Cloudflare のレコードは常に **DNS のみ**に設定してください。
* **管理者専用アクセス：** カスタムドメインの設定を追加、変更、削除できるのはスーパー管理者と管理者のみです。