Echobell Direct：チャンネル設定不要の個人向けWebhookアラート

Echobell Directはチャンネル設定を完全にスキップできる個人向けアラートモードです。Directキーを作成してWebhook URLを取得し、titleとbodyをPOSTするだけでデバイスに即時通知が届きます。購読者の管理、テンプレート設定、ルーティング設定は一切不要です。

このガイドでは、Directとは何か、セットアップ方法、そしてチャンネルの代わりにいつ使うべきかを説明します。

Echobell Directとは？

各Directキーは固有のWebhook URL（/d/{token}）を生成します。そのURLにリクエストを送ると、すぐにデバイスに通知が届きます。

Directを使うべき場面:

スクリプト、cronジョブ、CIパイプラインからの個人通知
固定テンプレートではなくリクエストごとのカスタムタイトルと本文
フルチャンネル設定なしの高速セットアップ

共有通知、再利用可能なテンプレート、条件付き配信が必要な場合は、代わりにWebhookを使ったチャンネルを使用してください。

3ステップのセットアップ

ステップ1：Directキーの作成

Echobellを開き、チャンネルリストのDirectをタップしてキーを作成します。所属するサービスの名前を付けましょう（例：CI Server、Cron、AI Tasks）。

ステップ2：Webhook URLのコピー

各キーには以下の形式のURLがあります:

https://hook.echobell.one/d/YOUR_KEY_TOKEN

このURLは秘密として扱ってください — 持っている人なら誰でも通知を送れます。

ステップ3：最初の通知を送信する

curl -X POST https://hook.echobell.one/d/YOUR_KEY_TOKEN \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Deploy failed",
    "body": "api-service failed health check",
    "notificationType": "time-sensitive",
    "externalLink": "https://dashboard.example.com/deploys/123"
  }'

フィールドの全リファレンス: Direct API

緊急度レベル

Directはイベントに応じた緊急度を設定できるnotificationTypeをサポートしています:

active — 通常の更新
time-sensitive — 集中モードを突き破る重要なアラート
calling — 重大なインシデント（アクティブなプレミアム購読が必要。なければtime-sensitiveにフォールバック）

動作の詳細は通知タイプを参照してください。

アラートへのコンテキスト追加

リクエスト本文にexternalLinkを含めると、通知にURLを添付できます。デプロイログ、ダッシュボード、プルリクエストへの直接リンクに便利です。

AIエージェントや長時間の非同期タスクには、手動でポーリングする代わりにDirectを使うとジョブ完了時に通知を受け取れます。参照: WebhookMCP + Echobell

DirectとChannelsの比較

	Direct	チャンネル
対象者	個人のみ	チームメンバーと共有
テンプレート	リクエストごとのコンテンツ	再利用可能な固定テンプレート
セットアップ時間	1分以内	チャンネル設定が必要
条件	非対応	対応

アラートを複数のユーザーに届ける必要がある場合や、サービス全体で一貫したフォーマットが欲しい場合はチャンネルを使用してください。テンプレートドキュメント · Echobellとは

セキュリティのベストプラクティス

Directトークンはコードではなく環境変数またはシークレットマネージャーに保存する
URLを個別に失効できるよう、サービスごとに1つのキーを作成する
URLが漏洩した可能性がある場合はトークンを即座にローテートする
callingは本当のインシデントのみに使用する — 多用するとアラート疲れを引き起こす

FAQ

Directは開発者専用ですか？ いいえ。HTTPリクエストを送れるツールを持つ人なら誰でも使えます。

DirectはGETリクエストに対応していますか？ 対応しています。ただしJSONでのPOSTが推奨されます。

購読が切れていてcallingを使った場合はどうなりますか？ 自動的にtime-sensitiveにフォールバックします。

まずはDirectガイドから始めてください。ワークフローがコラボレーションやテンプレートを必要とするほど成長したら、チャンネルが次の自然なステップです。