GeoHook · Anleitung

ntfy.sh als Aktionsziel einrichten

Deutsch · English

Was du einrichtest

GeoHook sendet beim Betreten oder Verlassen eines Ortes eine Nachricht an ntfy.sh. Die ntfy-App empfängt sie als Push-Mitteilung, auch auf einem anderen Gerät. Du brauchst GeoHook, die ntfy-App auf dem Empfangsgerät und Internetzugang. Für den gehosteten Dienst ist kein eigener Server nötig.

1. ntfy abonnieren

  1. Installiere die ntfy-App und erlaube Mitteilungen.
  2. Füge ein Abonnement hinzu: Server https://ntfy.sh, Topic ein eigener, langer, zufälliger Name. Ersetze DEIN_ZUFAELLIGES_TOPIC überall durch diesen Namen (Buchstaben, Ziffern, Bindestriche oder Unterstriche, keine Leerzeichen).
  3. Abonniere auf jedem Empfangsgerät exakt denselben Server und dasselbe Topic. Ein Topic muss nicht vorher separat angelegt werden.
Öffentliche Topics: Ohne Zugriffsschutz kann jeder, der den Namen kennt, mitlesen und Nachrichten senden. Verwende keinen Namen wie home und keine vertraulichen Inhalte. Ein zufälliger Name ersetzt keine Zugriffskontrolle. Ein Konto allein schützt ein Topic noch nicht; reserviere und schütze es bei Bedarf über die verfügbaren ntfy-Kontooptionen.

2. Aktion in GeoHook anlegen

  1. Öffne einen Ort oder lege über + einen Ort mit Geo-Bereich an.
  2. Füge unter den Eintrittsaktionen eine Aktion hinzu, z. B. Ankunft melden.
  3. Trage als Ziel-URL https://ntfy.sh/ ein.
  4. Öffne Erweiterte HTTP-Einstellungen, wähle POST und schalte Basisdaten mitsenden aus.
  5. Lasse Benutzername und Passwort für ein ungeschütztes Topic leer. Füge unter Zusätzliche JSON-Felder über Feld hinzufügen die folgenden Eigenschaften einzeln als Schlüssel/Wert hinzu, ohne Anführungszeichen.
  • topic → DEIN_ZUFAELLIGES_TOPIC
  • title → GeoHook: Ankunft
  • message → Ich bin zu Hause angekommen.

GeoHook erstellt daraus automatisch diesen JSON-Request. Du musst keinen eigenen Body und keine HTTP-Header eingeben:

{
  "topic": "DEIN_ZUFAELLIGES_TOPIC",
  "title": "GeoHook: Ankunft",
  "message": "Ich bin zu Hause angekommen."
}
Wichtig: Beim JSON-Versand gehört das Topic in die Eigenschaft topic. Die URL bleibt https://ntfy.sh/, ohne Topic-Pfad. Andernfalls kann der komplette JSON-Text als Nachricht erscheinen. Die ausgeschalteten Basisdaten verhindern außerdem das Mitsenden von Ortsname und Koordinaten.

3. Speichern und testen

  1. Lasse die Aktion aktiviert und wähle für den ersten Test keine zusätzlichen Ausführungsbedingungen.
  2. Speichere Aktion und Ort. Öffne die gespeicherte Aktion erneut und tippe unter Testen auf Webhook jetzt ausführen.
  3. Prüfe im Verlauf die HTTP-Antwort und auf dem Empfangsgerät die Nachricht. Ein erfolgreicher HTTP-Status bestätigt die Annahme durch ntfy, nicht die Anzeige einer Push-Mitteilung.
  4. Teste danach mit Eintritt simulieren im Debug-Bereich des Ortes und schließlich mit einem echten Ortswechsel. Für automatische Auslösung benötigt GeoHook die Standortberechtigung Immer.

Für eine Abfahrtsmeldung lege eine zweite Aktion unter Austrittsaktionen an. Behalte das Topic bei und ändere title und message, z. B. auf „GeoHook: Abfahrt“ und „Ich habe das Zuhause verlassen.“ Die Texte sind feste Werte; diese Anleitung verwendet keine dynamischen Platzhalter.

Geschützte Topics und eigener Server

Bei einem geschützten Topic trage in GeoHooks HTTP-Einstellungen den ntfy-Benutzernamen und das Passwort ein (HTTP Basic Auth). Das Konto braucht Schreibrechte; das Empfangsgerät muss ebenfalls mit Leseberechtigung angemeldet sein. Trage Zugangsdaten nicht in die URL ein und teile sie nicht im Support-Chat.

Bei einem eigenen ntfy-Server ersetze die Serveradresse auf beiden Seiten durch dessen erreichbare HTTPS-Adresse. Für zeitnahe iOS-Mitteilungen sind zusätzliche Servereinstellungen nötig; siehe ntfy: iOS-Mitteilungen bei Self-Hosting.

Wenn keine Nachricht ankommt

  • HTTP 400 / JSON statt Nachricht: URL, POST und Schreibweise von topic, title, message prüfen.
  • HTTP 401/403: Zugangsdaten und Schreibrechte für das Topic prüfen.
  • HTTP 429: Anfragelimit erreicht; später erneut testen.
  • HTTP erfolgreich, aber kein Push: Server und Topic vergleichen, ntfy-Abonnement und Mitteilungsberechtigung prüfen; auch Fokusmodus und Stummschaltung beachten.
  • Manueller Test funktioniert, Ortswechsel nicht: Aktivierung, Standortberechtigung, Bedingungen und Abklingzeit in GeoHook prüfen. Details in der Hilfe & FAQ.

Quellen: ntfy JSON API · ntfy Authentication · ntfy Documentation.

← Alle AnleitungenDeutsch · English