機能概要 - チャンネル、Webhook、テンプレート & 電話アラート

Echobellのコア機能ガイド。通知チャンネル、Webhook・メールトリガー、テンプレート、通知タイプ(標準、時間重要、電話)、条件、プライバシー重視の設計を解説。


Echobell は、重要なアラートを常に把握できるようにサポートする強力な通知管理プラットフォームです。このガイドでは、Echobell のすべての主要な機能と能力について説明します。

主要機能

通知チャンネル

Echobell の中心にあるのがチャンネルです - 異なる目的のためにカスタマイズ可能な通知パイプラインを作成できます。各チャンネルには以下の特徴があります:

  • 簡単な識別のための固有の名前と色
  • 各リクエストが送信したタイトルと本文を表示する通知(任意でカスタムテンプレートも利用可能)
  • 柔軟なトリガーオプション(webhook またはメール)
  • 共有可能なサブスクリプションリンク

トリガー方法

Webhook トリガー

webhook URL を使用してほぼすべてのシステムと統合できます。これらの URL が呼び出されると、チャンネルはすべての購読者に通知を送信します。以下のような用途に最適です:

  • サーバー監視アラート
  • CI/CD パイプライン通知
  • IoT デバイスステータスの更新
  • E コマースの注文通知

通知の title と body をクエリパラメータまたは JSON ボディで送信します。タイトルのデフォルトはチャンネル名です:

GET https://hook.echobell.one/t/<channel-token>?title=Server%20alert&body=CPU%20usage%20at%2095%25

# または

POST https://hook.echobell.one/t/<channel-token>
Content-Type: application/json

{
  "title": "Server alert",
  "body": "CPU usage at 95%"
}

特別な変数:

  • externalLink: 含めると、通知記録でクリック可能なリンクを作成します
  • notificationType: 購読者が選んだレベルより低い通知レベルを求めます(通知タイプを参照)

呼び出し元がタイトルと本文を送信できない場合(独自のペイロードを持つ監視ツールなど)は、カスタムテンプレートをオンにして、代わりにテンプレートで使う任意の変数を送信してください。詳しくは Webhook を参照してください。

メールトリガー

各チャンネルは専用のメールアドレスを持つことができます。このアドレスにメールが送信されると、チャンネルがトリガーされます。これにより以下が可能になります:

  • 重要なメールを通知として転送
  • プログラミングなしで通知フローを作成
  • メールはサポートしているが webhook をサポートしていないレガシーシステムとの統合

デフォルトでは、メールの件名が通知のタイトルに、プレーンテキストの内容が本文になります。カスタムテンプレートでは、以下のメール変数を利用できます:

  • from: 送信者のメールアドレス
  • subject: メールの件名
  • text: プレーンテキスト内容
  • html: HTML 内容

通知タイプ

購読者は 3 つの通知スタイルから選択できます:

  • 通常: 標準的なアプリ通知。通常のアラート用。
  • 時間重視: フォーカスモードを突破できる高優先度通知。重要なアラート用。
  • 通話: 最も緊急の事項のための電話のようなアラート。クリティカルな状況用。

購読者が選んだタイプは、チャンネルがその購読者に届けられる最も高いレベルです。webhook リクエストは notificationType を送信してより低いレベルを求めることができますが(たとえば、通話で購読しているチャンネルの定常的なイベントには active)、より高いレベルを求めることはできません。

カスタム通知音

購読者は、チャンネルの設定からチャンネルごとに通知音を選びます:

  • 内蔵ライブラリ: 短いアラート音 10 種類と、通話通知用のループ再生の着信音 4 種類。すべて Echobell オリジナル
  • サイレント: 通知はバッジや記録とともに届きますが、音は鳴りません
  • 自分のオーディオ: Echobellプレミアムでオーディオファイルを読み込み

内蔵ライブラリとサイレントは無料です。チャンネルのオーナーやトリガーリクエストが通知音を選ぶことはできません。詳しくはカスタム通知音をご覧ください。

テンプレートシステム

テンプレートは任意です。デフォルトでは、チャンネルは各リクエストが送信したタイトルと本文を表示します。代わりに変数を使ったテンプレートから通知を組み立てるには、チャンネル設定の詳細設定でカスタムテンプレートをオンにします:

  • タイトルテンプレート: 通知ヘッダーに表示される内容を決定
  • 本文テンプレート: 通知のメインコンテンツを制御

テンプレートの例:

タイトル:サーバー{{server_name}}がダウンしました!
本文:CPU使用率が{{cpu_usage}}%に達しました

変数は二重中括弧{{変数名}}で囲み、トリガーデータから入力されます。

プライバシー機能

データプライバシーを重視して設計:

  • アプリのローカルストレージで通知を保持
  • サーバーには必要最小限のデータのみを保存
  • すべての通知コンテンツはユーザーのデバイスにのみ保存
  • エンドツーエンドの暗号化された通知配信

条件

条件を使用して通知を送信するタイミングを細かく制御:

  • 変数の値に基づいてアラートをフィルタリング(例:cpu_usage > 90 の場合のみ通知)
  • AND/OR ロジックで複数の条件を組み合わせ
  • 文字列・数値・真偽値の比較をサポート

詳細は条件ガイドをご覧ください。

アプリ設定

通知の動作をカスタマイズするオプション:

  • 音声内容の繰り返し: 通話通知の内容を繰り返し
  • 失敗した通話の再試行: フォーカスモードなどで失敗した通話を自動的に再試行
  • 音声設定: 各購読者がチャンネルの設定で通知音を選びます(カスタム通知音を参照)
  • 静寂時間: 特定の時間帯の通知を制御

ユースケース

開発者向け

  • サーバーの健全性を監視し、即座にアラートを受信
  • ビルドの完了やテストの失敗の通知を取得
  • 本番環境のクリティカルエラーのアラートを受信

チーム向け

  • 異なるプロジェクトやシステム用のチャンネルを作成
  • チームメンバーが好みの通知緊急度で購読可能
  • クリティカルなアラートを見逃さないことを保証

トレーダー向け

  • TradingView や AICoin からリアルタイムの価格アラートを受信
  • 電話通知で重要な市場の動きを見逃さない
  • 価格しきい値でアラートをフィルタリングする条件を設定

個人使用向け

  • ウェブサイトがダウンした時にアラートを受信
  • 重要なメールの通知を受信
  • 重要なことすべてのカスタムアラートを作成

はじめ方

Echobell の利用開始は簡単です:

  1. App Store / Google Playから Echobell をダウンロード
  2. メールまたは Apple アカウントでサインイン
  3. 最初のチャンネルを作成
  4. webhook またはメールトリガーを設定
  5. チャンネルをチームと共有(オプション)

追加の設定オプションと詳細な情報については、ドキュメントを参照してください。