Echobell Direct: Persönliche Webhook-Alarme ohne Channel-Einrichtung

Echobell Direct ist ein persönlicher Alarm-Modus, der die Channel-Einrichtung komplett überspringt. Sie erstellen einen Direct-Key, erhalten eine Webhook-URL und senden title + body per POST, um sofort eine Benachrichtigung auf Ihrem Gerät zu erhalten. Keine Abonnenten, keine Templates, keine Routing-Konfiguration.

Diese Anleitung erklärt, was Direct ist, wie Sie es einrichten und wann Sie es statt Channels verwenden sollten.

Was ist Echobell Direct?

Jeder Direct-Key generiert eine eindeutige Webhook-URL (/d/{token}). Senden Sie eine Anfrage an diese URL, und die Benachrichtigung erscheint sofort auf Ihrem Gerät.

Direct eignet sich, wenn Sie benötigen:

Persönliche Benachrichtigungen aus Skripten, Cron-Jobs oder CI-Pipelines
Individuellen Titel und Body pro Anfrage statt fixer Templates
Schnelle Einrichtung ohne vollständige Channel-Konfiguration

Für geteilte Benachrichtigungen, wiederverwendbare Templates oder bedingte Zustellung verwenden Sie stattdessen Channels via Webhooks.

Einrichtung in 3 Schritten

Schritt 1: Direct-Key erstellen

Echobell öffnen, auf Direct in der Channel-Liste tippen und einen Key erstellen. Den Key nach dem zugehörigen Dienst benennen (z. B. CI Server, Cron, AI Tasks).

Schritt 2: Webhook-URL kopieren

Jeder Key hat eine URL im Format:

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

Diese URL wie ein Secret behandeln – jeder mit dieser URL kann Ihnen Benachrichtigungen senden.

Schritt 3: Erste Benachrichtigung senden

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"
  }'

Vollständige Feldreferenz: Direct API

Dringlichkeitsstufen

Direct unterstützt notificationType, damit Sie die Dringlichkeit dem Ereignis anpassen können:

active — reguläre Aktualisierungen
time-sensitive — wichtige Alarme, die den Focus-Modus durchdringen
calling — kritische Vorfälle (erfordert aktives Premium-Abonnement; fällt andernfalls auf time-sensitive zurück)

Details zum Verhalten: Benachrichtigungstypen.

Kontext zu Alarmen hinzufügen

externalLink im Request-Body übergeben, um einen URL-Link an die Benachrichtigung anzuhängen – nützlich für direkten Zugriff auf Deploy-Logs, Dashboards oder Pull Requests.

Für KI-Agenten und lang laufende asynchrone Aufgaben ist Direct ein unkomplizierter Weg, benachrichtigt zu werden, wenn der Job abgeschlossen ist – ohne manuelles Polling. Siehe auch: WebhookMCP + Echobell.

Direct vs. Channels

	Direct	Channels
Empfänger	Nur persönlich	Mit Teammitgliedern geteilt
Templates	Inhalt pro Anfrage	Wiederverwendbare, feste Templates
Einrichtungszeit	Unter einer Minute	Erfordert Channel-Konfiguration
Bedingungen	Nicht unterstützt	Unterstützt

Channels verwenden, wenn Alarme mehrere Personen erreichen sollen oder konsistente Formatierung über einen Dienst gewünscht ist. Template-Dokumentation · Was ist Echobell

Sicherheits-Best Practices

Direct-Tokens in Umgebungsvariablen oder einem Secret-Manager speichern, nicht im Code
Einen Key pro Dienst erstellen, um individuell widerrufen zu können
Tokens sofort rotieren, wenn eine URL möglicherweise kompromittiert wurde
calling für echte Vorfälle reservieren – Übergebrauch führt zu Alarm-Fatigue

FAQ

Ist Direct nur für Entwickler? Nein. Jedes Tool, das HTTP-Anfragen senden kann, kann Direct nutzen.

Unterstützt Direct GET-Anfragen? Ja, POST mit JSON wird jedoch empfohlen.

Was passiert, wenn mein Abonnement ausläuft und ich calling verwende? Es fällt automatisch auf time-sensitive zurück.

Starten Sie mit dem Direct-Leitfaden. Wenn Ihr Workflow Kollaboration oder Templates erfordert, sind Channels der nächste logische Schritt.