Gib deinem KI-Agenten die Fähigkeit, dir zu schreiben

14. Juli 2026 · 4 Min. Lesezeit

Agenten arbeiten am besten, wenn man ihnen nicht zusieht – Recherchen, lange Builds, Übernacht-Pipelines. Aber ein Agent, der dich nicht erreichen kann, blockiert an Fragen oder wird still fertig. Ein Webhooky-Endpoint ist das einfachste „Melde dich beim Menschen“-Tool überhaupt.

Als Function-Calling-Tool

Tool definieren, Implementierung ist ein einziger POST:

{
  "name": "notify_user",
  "description": "Sendet eine Push-Benachrichtigung aufs Handy des Nutzers. Nutzen, wenn ein langer Task fertig ist, fehlschlägt oder eine Entscheidung des Nutzers braucht.",
  "input_schema": {
    "type": "object",
    "properties": {
      "title":   { "type": "string", "description": "Kurze Überschrift, max. 100 Zeichen" },
      "message": { "type": "string", "description": "Details, max. 500 Zeichen" }
    },
    "required": ["title", "message"]
  }
}

// die Tool-Implementierung – das ist alles
async function notify_user({ title, message }) {
  await fetch(process.env.WEBHOOKY_URL, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ title, message }),
  });
  return "notified";
}

Funktioniert identisch mit Anthropic Tool Use, OpenAI Function Calling, LangChain-Tools – das Schema ist überall dieselbe Idee.

In n8n-KI-Workflows

Gib dem AI-Agent-Node ein HTTP-Request-Tool, das auf deinen Endpoint zeigt, mit title/message als Tool-Parametern. Der Agent entscheidet, wann er dich ruft; das Node-Setup steht in der n8n-Anleitung.

Terminal-Agenten: null Integration

Coding-Agenten, die Shell-Befehle ausführen können, brauchen gar keine Tool-Definition – sag ihnen einmal:

„Wenn der Task fertig ist oder du meinen Input brauchst, führe aus:
curl -X POST https://api.webhooky.app/MEIN_KEY -d '{"title":"🤖 Agent","message":"<status>"}'“

Wobei Agenten dich anpingen sollten

Task fertig – mit der Ergebnis-Zusammenfassung in der Nachricht.
Freigabe nötig – „will gleich veröffentlichen / ausgeben / löschen, bitte am Desktop bestätigen“.
Fehlschlag – mit "sound": "error_1", damit Ärger anders klingt als Erfolg.
Tages-Digest – eine geplante Zusammenfassungs-Push statt hundert kleiner.

Eine Warnung: Gib dem Tool eine präzise Beschreibung wie oben – sonst erzählt dir ein übereifriger Agent jeden Zwischenschritt in die Hosentasche.

Hol dir Webhooky

Kostenlos für deine ersten 100 Benachrichtigungen – Endpoint in zwei Minuten eingerichtet.