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

# 送信メール、SMTP、メールテンプレートの設定

> AgencyHandyで、カスタム送信者メールアドレスの設定、SMTPサーバーの接続、DKIM/SPFレコードによる到達性の向上、メールテンプレートのカスタマイズを行います。

AgencyHandyのメール設定では、デフォルトの`noreply@agencyhandy.com`送信者を独自のブランドメールアドレスに置き換え、安定した配信のための専用SMTPサーバーを設定し、クライアント通知・請求書・提案書などに使用するテンプレートをカスタマイズできます。正しく設定することで、メールがクライアントのスパムフォルダではなく受信トレイに届くようになり、すべてのメッセージにエージェンシーのアイデンティティが反映されます。

<Note>
  メール設定を変更できるのは、**スーパー管理者**と**管理者**のみです。**ワークスペース設定 → メール設定**からアクセスしてください。
</Note>

***

## メール設定コンポーネントの概要

<CardGroup cols={2}>
  <Card title="カスタムメールアドレス" icon="envelope">
    ワークスペースからメッセージを受け取る際にクライアントに表示される送信者名とメールアドレスを設定します。
  </Card>

  <Card title="DKIM と SPF レコード" icon="shield-check">
    メールの正当性を証明し、スパムとして判定されないようにするためのDNS認証レコードを追加します。
  </Card>

  <Card title="SMTPサーバー" icon="server">
    独自のメールサーバー（Gmail、Outlook、またはカスタムドメインサーバーなど）を接続し、AgencyHandyからのすべての送信メールをそこ経由で送信します。
  </Card>

  <Card title="メールテンプレート" icon="file-lines">
    AgencyHandyがクライアントに送信するすべての自動メールのコンテンツ、件名、ブランドをカスタマイズします。
  </Card>
</CardGroup>

***

## パート1：カスタムメールアドレスの設定

送信者メールを設定する前に、メールホスティング付きの登録済みドメインが必要です。代表的なプロバイダーには、Google Workspace、Microsoft 365、Zoho Mail、Cloudflare Email Routingなどがあります。

<Steps>
  <Step title="ドメインを登録してメールホスティングを設定する">
    まだ行っていない場合は、レジストラ（GoDaddy、Namecheap、Cloudflareなど）でドメインを登録し、メールホスティングプロバイダーに申し込んでください。そのドメインでメールアドレス（例：`hello@youragency.com`）を作成・管理できることを確認してください。
  </Step>

  <Step title="AgencyHandyでメール設定に移動する">
    AgencyHandyにログインし、左ナビゲーションの**ワークスペース設定**に進み、**メール設定**をクリックします。
  </Step>

  <Step title="送信者名とメールを入力する">
    **送信者名**フィールドに、クライアントに表示される送信者名（例：`AgencyHandy サポート`またはエージェンシー名）を入力します。**送信者メール**フィールドにカスタムメールアドレス（例：`hello@youragency.com`）を入力し、**保存**をクリックします。
  </Step>

  <Step title="メールアドレスを確認する">
    AgencyHandyが入力したメールアドレスに確認リンクを送信します。受信トレイを開き、確認メッセージを見つけてリンクをクリックし、所有権を確認します。
  </Step>

  <Step title="DKIM、SPF、DMARC DNSレコードを設定する">
    送信者メールを保存すると、AgencyHandyが追加すべきDNSレコードを提供します：

    * **SPFレコード**（TXTタイプ）— AgencyHandyがドメインを代行してメールを送信することを許可します。
    * **DKIMレコード**（CNAMEレコード×3）— 送信メールに暗号署名を付加し、受信サーバーが正当性を検証できるようにします。
    * **DMARCレコード**— 認証チェックに失敗したメールを受信サーバーがどのように処理するかを定義します。

    レジストラのDNS設定にこれらすべてのレコードを追加してください。DKIM CNAMEレコードについては、Cloudflareを使用している場合、**プロキシステータスを無効**にしてください。
  </Step>

  <Step title="アクティブステータスを確認する">
    AgencyHandyのメール設定ページに戻ります。すべてのDNSレコードが伝播されると（2分〜2時間かかる場合があります）、メールステータスが**保留中**から緑のチェックマーク ✅ に更新されます。カスタムメールがアクティブになりました。
  </Step>
</Steps>

<Tip>
  [MXToolbox](https://mxtoolbox.com/DKIM.aspx)または[dmarcianのDKIMバリデーター](https://dmarcian.com/dkim-validator/)を使用して、DKIMレコードが正しく設定されているか確認できます。伝播を待つ間、メール設定ページを定期的に更新してください。
</Tip>

***

## パート2：DKIM と SPF の設定（単独セットアップ）

DKIMおよびSPFレコードを独立して生成または再生成する必要がある場合は、以下の手順に従ってください：

**ワークスペース設定 → メール → DKIM & SPF 設定 → DKIM と SPF レコードを生成**

次に、DNSにレコードを追加します：

| レコードタイプ  | DNS タイプ | 設定内容                                                 |
| -------- | ------- | ---------------------------------------------------- |
| SPF      | TXT     | AgencyHandyから**名前**と**値**をコピーし、DNSに新しいTXTレコードを追加する   |
| DKIM（×3） | CNAME   | 各**名前**と**値**のペアをコピーし、プロキシを無効にして3つの別々のCNAMEレコードを追加する |

<Note>
  DKIMとSPFレコードの伝播には**2分〜2時間**かかる場合があります。2時間経ってもステータスが保留中のままの場合は、レコードが誤字なく入力されており、競合するレコードが存在しないことを確認してください。
</Note>

***

## パート3：SMTPの設定

SMTP（Simple Mail Transfer Protocol）を使用すると、AgencyHandyからのすべての送信メールを独自の確認済みメールサーバー経由でルーティングでき、到達性とブランディングをより細かく制御できます。

<Note>
  **カスタムドメインメール**または**SMTPメールプロバイダー**のいずれか一方のみ使用できます。同時に両方を使用することはできません。いつでも切り替えることは可能ですが、カスタムメールに戻す際はメール設定を再入力する必要があります。
</Note>

<Steps>
  <Step title="SMTPサーバー設定を開く">
    **ワークスペース設定 → メール設定**に移動し、**SMTPサーバー**をクリックします。
  </Step>

  <Step title="SMTPプロバイダーに切り替える（必要な場合）">
    すでにカスタムメールが設定されている場合、SMTPに切り替えるかどうかを確認するポップアップが表示されます。**SMTPに切り替え**をクリックして続行します。これにより既存のカスタムメール設定は無効になります。
  </Step>

  <Step title="SMTP認証情報を入力する">
    必要なフィールドを入力します：

    | フィールド | 入力例                  | 備考                         |
    | ----- | -------------------- | -------------------------- |
    | ホスト名  | `smtp.gmail.com`     | メールプロバイダーのSMTPサーバーアドレス     |
    | ユーザー名 | `you@yourdomain.com` | メールアドレス全体                  |
    | パスワード | アプリパスワード             | アプリ専用パスワードを使用（以下参照）        |
    | ポート   | `465` または `587`      | 465はSSL用、587はTLS用          |
    | 自動TLS | オン/オフ切替              | オプション — 自動TLSアップグレードを有効にする |

    完了したら**保存**をクリックします。
  </Step>

  <Step title="アプリパスワードを生成する（Gmailの例）">
    2段階認証が有効なGmailを使用している場合（アプリパスワードに必要）：

    1. [myaccount.google.com/security](https://myaccount.google.com/security)に移動し、2段階認証がアクティブであることを確認します。
    2. [myaccount.google.com/apppasswords](https://myaccount.google.com/apppasswords)にアクセスします。
    3. **アプリを選択**をクリックし、**メール**を選択（またはカスタム名を入力）してから、**デバイスを選択**をクリックしてセットアップを選択します。
    4. **作成**をクリックすると、Googleが16文字のアプリパスワードを生成します。
    5. パスワードをコピーし、AgencyHandyのSMTP設定の**パスワード**フィールドに貼り付けます。

    <Warning>
      通常のGoogleアカウントパスワードではなく、**アプリパスワード**を使用してください。2FAが有効な場合、通常のパスワードは使用できず、セキュリティアラートが発生する可能性があります。
    </Warning>
  </Step>

  <Step title="設定を確認する">
    保存後、AgencyHandyに\_「SMTPが正常に作成されました。」\_という成功メッセージが表示されます。保存したホスト、ユーザー名、ポートの詳細がSMTP設定ページに表示されます。
  </Step>

  <Step title="SMTP接続をテストする">
    **テスト**ボタンをクリックし、受信者のメールアドレスを入力します。AgencyHandyがそのアドレスにテストメールを送信します。\_「Agency Handyのメール設定が正常に機能していることを確認するメールです。」\_という確認メッセージが受信トレイに届くか確認してください。
  </Step>
</Steps>

<Tip>
  ワークスペースごとにアクティブにできるSMTP設定は1つだけです。SMTPが設定されると、AgencyHandyからのすべての送信メール（請求書、提案書、タスク通知）がSMTPサーバー経由で送信されます。
</Tip>

***

## パート4：メールテンプレートのカスタマイズ

AgencyHandyには、送信するすべての自動メール用のテンプレートが事前に用意されています。ブランドのトーンに合わせて各テンプレートをカスタマイズし、関連する動的コンテンツを含めることができます。

**利用可能なテンプレート：**

* クライアント登録
* 提案書送信
* タスクレビュー
* 請求書送信
* 請求書とサブスクリプションのリマインダー
* サポートチケット作成通知

<Steps>
  <Step title="メールテンプレートを開く">
    **ワークスペース設定 → メール**に移動し、サブメニューから**メールテンプレート**を選択します。
  </Step>

  <Step title="編集するテンプレートを選択する">
    利用可能なテンプレートの全一覧が表示されます。いずれかのテンプレートをクリックして設定ページを開きます。
  </Step>

  <Step title="テンプレートフィールドをカスタマイズする">
    必要に応じて以下を更新します：

    * **送信者メール：** このテンプレートを送信する設定済みメールアドレスを選択します。
    * **件名：** 明確で簡潔な件名を記述します。
    * **本文：** エージェンシーのトーンとメッセージに合わせてメッセージ内容を編集します。
    * **動的変数：** `{{client_name}}`、`{{company_name}}`、`{{invoice_id}}`などのプレースホルダーを挿入して、クライアント固有のデータを自動入力します。
    * **ソーシャルメディアリンク：** エンゲージメントを促進するために、エージェンシーのソーシャルプロフィールへのリンクを追加します。
  </Step>

  <Step title="テストメールを送信する">
    **テスト送信**をクリックして、テンプレートのプレビューを受信トレイに送信します。フォーマット、内容、すべての動的変数が正しく解決されているかを確認します。
  </Step>

  <Step title="変更を保存する">
    **変更を保存**をクリックして更新されたテンプレートを適用します。新しいバージョンは、そのテンプレートタイプに一致する今後のすべての自動メールに使用されます。
  </Step>
</Steps>

***

## 重要事項

* **SMTPとカスタムメールは同時に使用できません。** ワークスペースごとに一度にアクティブにできる方法は1つだけです。
* **切り替え時にメールを再入力します。** SMTPからカスタムメール設定に戻す場合は、カスタムメールの認証情報を再入力する必要があります。
* **SMTP認証情報が誤っていると、すべての送信メールがブロックされます。** SMTPの変更後にメールの送信が停止した場合は、ホスト名、ポート、ユーザー名、パスワードを再確認してください。
* **DKIM/SPFの伝播には時間がかかります。** エラーがあると断定する前に、最大2時間待ってメール設定ページを更新してください。
* **動的変数は大文字・小文字を区別します。** テンプレートエディターに表示されているとおりに正確に使用し、正しく入力されるようにしてください。
