---
title: Echobell のはじめ方 - 完全セットアップガイド
sidebarTitle: はじめに
description: 即時webhook通知、メールアラート、カスタム通知チャンネルのEchobell設定方法を学びます。テンプレート、トリガー、リアルタイムアラートを使用したiOS通知管理の完全ステップバイステップガイド。
---

# Echobell をはじめよう

Echobell へようこそ。重要な通知を常に把握できるようにサポートするインスタントアラートアプリです。CI/CD パイプラインの webhook アラートが必要な開発者、サーバーを監視するシステム管理者、重要な通知を管理するチームのいずれであっても、この包括的なガイドで Echobell の効果的な設定と使用方法について説明します。

このガイドを終えると、通知チャンネルの作成方法、webhook とメールトリガーの設定方法、通知テンプレートのカスタマイズ方法、既存のツールやワークフローへの Echobell 統合方法を理解できます。

## Echobell とは？

Echobell は、開発者、DevOps チーム、そして信頼性の高い即時アラートを必要とするすべての人のために設計された強力な通知管理ツールです。システムとモバイルデバイスの間のギャップを埋め、重要な情報が即座に届くことを保証します。

**主要機能:**

- **Webhook 統合**: HTTP リクエストを送信できるあらゆるシステムと接続 - 監視ツール、CI/CD パイプライン、IoT デバイスなど
- **メールトリガー**: チャンネル専用のメールアドレスに転送することで、あらゆるメールを即時通知に変換
- **カスタムテンプレート**: 動的変数を使用して、情報豊富でコンテキストリッチな通知を作成
- **柔軟な通知タイプ**: 通常の通知、時間重視のアラート、重大な問題のための電話スタイル通知から選択
- **プライバシーファーストの設計**: 通知履歴はサーバーではなく、あなたのデバイスに保存
- **チームコラボレーション**: チームメンバーとチャンネルを共有し、購読者アクセスを管理

[Echobell をユニークにするもの](/ja/docs/what-is-echobell)と[完全な機能概要](/ja/docs/features)をご覧ください。

![Echobellの概要](/images/docs/screenshot-overview.en.webp)

## 主要概念

利用を開始する前に、いくつかの重要な概念を理解しましょう：

### チャンネル

**チャンネル**は、通知を整理・配信するための Echobell の基本単位です：

- 各チャンネルには、異なるアラートソースを容易に識別するための固有の**名前**と**色**があります
- チャンネルには、購読者に送信される情報を決定する**[通知テンプレート](/ja/docs/template)**が含まれます
- チャンネルは**[webhook](/ja/docs/webhook)**または**[メール](/ja/docs/email-trigger)**でトリガーされます
- 自分でチャンネルを作成したり、他のユーザーが共有したチャンネルを購読したりできます
- 各チャンネルは、どのトリガーが実際に通知を送信するかをフィルタリングする**[条件](/ja/docs/conditions)**をサポートしています
- チャンネルは安全な購読リンクを通じてチームメンバーや一般の人々と共有できます

チャンネルを通知パイプラインと考えてください：データはトリガーを通じて入力され、テンプレートでフォーマットされ、条件でフィルタリングされ、すべての購読者に通知として配信されます。

### トリガー

**トリガー**は、チャンネルをアクティブにして通知を送信するものです。Echobell は 2 つのトリガー方式をサポートしています：

- **[Webhook](/ja/docs/webhook)**: HTTP GET または POST で呼び出されるとチャンネルをアクティブにする URL エンドポイント。監視システム、CI/CD パイプライン、サーバーレス関数、HTTP リクエストを送信できるあらゆるツールとの統合に最適です。
- **[メールトリガー](/ja/docs/email-trigger)**: チャンネルにリンクされた固有のメールアドレス。このアドレスにメールが送信されると、チャンネルがアクティブになります。メールベースのアラート、重要なメッセージの転送、またはメール通知のみをサポートするシステムに最適です。

同じチャンネルで両方のトリガータイプを同時に使用できるため、アラートの送信方法に最大限の柔軟性が得られます。[webhook 統合](/ja/docs/webhook)と[メールトリガー](/ja/docs/email-trigger)の詳細をご覧ください。

### 通知タイプ

チャンネルを購読する際、デバイス上でアラートがどのように表示されるかを決定する異なる[通知スタイル](/ja/docs/notification)から選択できます：

- **通常（アクティブ）**: 通知センターに表示される標準的なアプリ通知。緊急ではない更新や情報提供のアラートに最適です。

- **時間重視**: フォーカスモードやおやすみモードの設定を突破できる高優先度通知。即座に注意が必要だが、重大な緊急事態ではない重要なアラートに推奨されます。

- **通話**: 着信電話と同様の着信音とフルスクリーンインターフェースを備えた通話スタイルのアラート。本番環境の障害やセキュリティアラートなど、即座の対応が必要な重大なインシデントに不可欠です。

選択する通知タイプは、チャンネルコンテンツの緊急性によって異なります。必要に応じて、異なる通知タイプで同じチャンネルを複数回購読できます。各タイプをいつ使用すべきかを理解するには、[通知に関する詳細ガイド](/ja/docs/notification)をお読みください。

## はじめ方

### 1. アカウントの設定

1. [App Store](https://apps.apple.com/app/apple-store/id6743597198?pt=128151925&ct=docs-index-ja&mt=8)から Echobell をダウンロード
2. アプリを開き、メールまたは Apple でサインイン

![アカウント設定](/images/docs/screenshot-sign-in.en.webp)

### 2. 最初のチャンネルを作成

1. メインビューから、右下のボタンをタップして**チャンネル**ビューに移動します
2. **+**ボタンをタップして新しいチャンネルを作成します
3. チャンネルの名前を入力します（例：「サーバーアラート」）
4. チャンネルを識別するための色を選択します
5. 通知テンプレートを設定します：
   - **タイトルテンプレート**: 通知の見出しとして表示されるもの
   - **本文テンプレート**: 通知の詳細な内容
6. オプションで、自分自身のチャンネル購読を有効にするかどうかを切り替えます
7. チャンネルの**通知タイプ**を選択します（通常、時間重視、または通話）
8. 新しいチャンネルを保存します

![チャンネル作成](/images/docs/screenshot-create-channel.en.webp)

### 3. トリガーの設定

チャンネルを作成したら、通知をトリガーする方法は 2 つあります：webhook またはメール経由です。作成したチャンネルをタップして設定にアクセスします。チャンネル設定で**トリガー**セクションを見つけることができます。

![チャンネル設定](/images/docs/screenshot-channel-settings.en.webp)

#### Webhook トリガー

1. **webhook**ボタンをタップして、生成された webhook URL をコピーします
2. この URL をシステムに統合します（例：サーバー監視、CI/CD パイプライン）
3. URL が呼び出されると、チャンネルがトリガーされます

通知テンプレートに変数を提供する方法は 2 つあります：

```bash
# クエリパラメータを使用したwebhook呼び出しの例
curl -X GET "https://hook.echobell.one/t/your-unique-id?server=production&status=critical&message=CPU%E4%BD%BF%E7%94%A8%E7%8E%8795%25"

# または JSON ボディを使用
curl -X POST https://hook.echobell.one/t/your-unique-id \
  -H "Content-Type: application/json" \
  -d '{"server": "production", "status": "critical", "message": "CPU使用率95%"}'
```

これらの変数は通知テンプレートを埋めるために使用されます。たとえば、タイトルテンプレートが`{{server}} - {{status}}`の場合、「production - critical」としてレンダリングされます。

**特殊変数:**

- `externalLink`: この変数を含めると、通知レコードにクリック可能なリンクとして表示されます

#### メールトリガー

1. **メール**ボタンをタップして、チャンネル用に生成されたメールアドレスをコピーします
2. このアドレスにメールが送信されると、チャンネルがトリガーされます

メールトリガーでは、Echobell はメールから自動的にこれらの変数を抽出します：

- `from`: 送信者のメールアドレス
- `to`: 受信者のメールアドレス（チャンネルのメール）
- `subject`: メールの件名
- `text`: メールのプレーンテキストコンテンツ
- `html`: メールの HTML コンテンツ

これらの変数をテンプレートで使用できます。例：`{{subject}}`や`{{text}}`。

### 4. 通知テンプレートのカスタマイズ

テンプレートはトリガーデータから入力される変数を使用します：

1. チャンネル設定で、**通知テンプレート**に移動します
2. タイトルテンプレートには：`{{server}} - {{status}}`のように設定できます
3. 本文テンプレートには：`{{message}} {{timestamp}}に検出`のように設定できます
4. 変数は二重中括弧で囲みます：`{{変数名}}`
5. テンプレートをサンプルデータでテストします

### 5. チャンネルの購読

1. チャンネルの購読リンクを他のユーザーと共有できます
2. または他のユーザーが共有した購読リンクを使用してチャンネルを購読できます
3. チャンネルビューで**購読**をタップします
4. 購読リンクを入力します
5. 希望する**通知タイプ**を選択します：
   - 標準的なアラートには通常
   - 重要なアラートには時間重視
   - 重要な状況には通話
6. 購読を確認します

## アプリの設定

以下の設定で Echobell の通知処理方法をカスタマイズできます：

- **音声内容の繰り返し**: 通話通知を使用する際、この設定は通知内容を繰り返します
- **失敗した通話の再試行**: フォーカスモードなどの理由で失敗した通話通知を自動的に再試行します

## プライバシーとデータストレージ

Echobell はプライバシーを優先します：

- サーバーには、ユーザーアカウント、チャンネル、購読データのみを保存します
- 通知のコンテンツと履歴はあなたのデバイスにローカルに保存されます
- アラートデータはあなたの管理下を離れることはありません

## 次のステップ

最初のチャンネルを設定したら、Echobell を最大限に活用するためにこれらのリソースを探索してください：

### 重要なガイド

- **[Echobell とは？](/ja/docs/what-is-echobell)** - Echobell の背後にある主要な概念と哲学を理解する
- **[機能概要](/ja/docs/features)** - 利用可能なすべての機能と能力を探索する
- **[テンプレートガイド](/ja/docs/template)** - テンプレート構文をマスターし、動的な通知を作成する
- **[条件](/ja/docs/conditions)** - トリガーデータに基づいて通知をフィルタリングする方法を学ぶ
- **[Webhook 統合](/ja/docs/webhook)** - webhook の設定とベストプラクティスを深く掘り下げる
- **[メールトリガー](/ja/docs/email-trigger)** - メールベースの通知トリガーを設定する

### 統合ガイド

Echobell を人気のツールやプラットフォームと接続：

- **[Grafana 統合](/ja/docs/developer/grafana)** - 即時アラートでインフラストラクチャを監視する
- **[GitHub Actions](/ja/docs/developer/github)** - CI/CD パイプラインイベントの通知を受け取る
- **[Prometheus](/ja/docs/developer/prometheus)** - Prometheus メトリクスのアラートを設定する
- **[Home Assistant](/ja/docs/developer/home-assistant)** - スマートホームオートメーション通知
- **[Uptime モニタリング](/ja/docs/developer/uptime-kuma)** - ウェブサイトとサービスの可用性アラート
- **[TradingView](/ja/docs/trader/tradingview)** - トレーディングアラートと市場通知

### ベストプラクティス

- **シンプルに始める**: まず簡単なテンプレートで基本的なチャンネルを作成し、徐々に複雑さを追加する
- **テンプレートをテストする**: デプロイ前にテスト webhook 呼び出しを使用してテンプレートが正しくレンダリングされることを確認する
- **条件を賢く使用する**: 重要なイベントのみでアラートするようにチャンネルに条件を設定してノイズをフィルタリングする
- **適切な通知タイプを選択する**: アラート疲れを避けるために、「通話」通知は本当に重大なアラートのために予約する
- **色で整理する**: アラートソースを一目で素早く識別するためにチャンネルカラーを戦略的に使用する
- **チャンネルを文書化する**: チャンネルノートを使用して、何がトリガーするか、どのように対応するかを文書化する

### 一般的なユースケース

他の人が Echobell をどのように使用しているかを発見：

- **サーバー監視**: CPU、メモリ、またはディスク使用率がしきい値を超えたときに即時アラートを受け取る
- **CI/CD 通知**: ビルドが失敗したりデプロイメントが完了したときにすぐに知る
- **E コマースアラート**: 新しい注文、支払いの問題、または在庫警告の通知を受け取る
- **セキュリティ監視**: 認証失敗、不審なアクティビティ、またはセキュリティイベントの重要なアラート
- **IoT とスマートホーム**: センサー、カメラ、ホームオートメーションシステムからの通知
- **チーム調整**: コラボレーティブなインシデント対応のためにチームメンバーとチャンネルを共有する

### ヘルプを取得

サポートが必要ですか、質問がありますか？

- **[サポートセンター](/ja/docs/support)** - よくある質問とトラブルシューティングガイドを参照する
- **メールサポート**: echobell@weelone.comまでお問い合わせください
- **コミュニティ**: ディスカッションに参加し、他の Echobell ユーザーとユースケースを共有する

Echobell をシステムに統合する準備はできましたか？[webhook 統合ガイド](/ja/docs/webhook)をチェックするか、[開発者向け統合](/ja/docs/developer/github)を探索して始めましょう！