HookTap in Minuten integrieren

Einfache Dot-Notation

Extrahiere einen Wert aus einem verschachtelten JSON-Pfad per Dot-Notation.

// Incoming JSON (sent by GitHub)
{
  "repository": { "full_name": "acme/backend" },
  "workflow_run": {
    "name":        "Deploy to production",
    "conclusion":  "success",
    "head_branch": "main"
  }
}

// fieldMapping – set on the webhook document in Firestore
{
  "title": "workflow_run.name",
  "nody":  "workflow_run.conclusion",
  "type": "push"
}

// → Notification
//   Title: "Deploy to production"
//   Body:  "success"

Template-Syntax

Schließe Pfade in {geschweifte Klammern} ein, um statischen Text, Emojis und mehrere Felder in einem String zu kombinieren.

// fieldMapping with template syntax
// Anything inside {…} is resolved as a dot-notation path.
// Everything outside is treated as a literal.
{
  "title": "🚀 {repository.full_name}",
  "body":  "{workflow_run.conclusion} on {workflow_run.head_branch}",
  "type": "push"
}

// Same GitHub payload as above
// → Notification
//   Title: "🚀 acme/backend"
//   Body:  "success on main"

Tiefe Pfade

Beliebige Verschachtelungstiefe wird unterstützt – nützlich für Stripe, Grafana oder eigene Webhook-Payloads.

// Incoming JSON (sent by Stripe)
{
  "type": "payment_intent.succeeded",
  "data": {
    "object": {
      "amount":   4900,
      "currency": "eur",
      "receipt_email": "user@example.com"
    }
  }
}

// fieldMapping
{
  "title": "{type}",
  "body":  "€{data.object.amount} · {data.object.receipt_email}",
  "type": "feed"
}

// → Notification
//   Title: "payment_intent.succeeded"
//   Body:  "€4900 · user@example.com"

Deep-Link (optional)

Das optionale Deep-Link-Feld nimmt einen Dot-Notation-Pfad zu einer URL in deinem Payload entgegen. Beim Tippen auf die Benachrichtigung oder das Event wird diese URL direkt geöffnet. Beispiel: pull_request.html_url.

// Incoming JSON (sent by GitHub)
{
  "action": "opened",
  "pull_request": {
    "title": "Fix memory leak",
    "html_url": "https://github.com/acme/repo/pull/42"
  }
}

// fieldMapping
{
  "title": "PR {action}: {pull_request.title}",
  "deepLink": "pull_request.html_url"
}

// → Action
//   Tapping the notification opens:
//   "https://github.com/acme/repo/pull/42"

Live Activity Design (Keywords)

Dringliche Zustellung (Time-Sensitive)

Events mit folgenden Keywords werden als 'Time-Sensitive' markiert. Sie durchbrechen den Fokus-Modus und werden priorisiert zugestellt: