SocialHub.AI
Ressourcen · Entwicklerzentrum

App-Push

Verwandeln Sie Ihre native App in einen SocialHub-Sendekanal. Mitglieder registrieren ein Gerätetoken im In-App-Mitgliederbereich; die Push-Benachrichtigung wird dann in dieselbe Automatisierungs- und Kampagnen-Engine eingebunden, die auch Ihre E-Mails versendet – mit einem Fail-Open-Kanal und einer gemeinsamen Frequenzbegrenzung.

Token-Registrierung und Sende-Stack-Schnittstelle sind heute im Code aktiv. Die eigentliche Push-Benachrichtigung wird nach einer kontrollierten Aktivierung pro Team eingeführt – bitten Sie Ihr SocialHub-Team, diese zu aktivieren, sobald Ihre FCM/APNs-Zugangsdaten konfiguriert sind.

So funktioniert es

Gerätetoken registrierenLive

Die App eines angemeldeten Mitglieds sendet ihr FCM/APNs-Token per POST. Idempotentes UPSERT – sicher bei jedem Start und bei der Token-Rotation des Betriebssystems aufzurufen.

Push wird dem Sendestapel hinzugefügt.Live

Push ist ein Kanal in derselben Automatisierungs-/Kampagnen-Engine wie E-Mail – kein separater API. Eine Reise, ausgewählter Kanal pro Mitglied.

Kanalwasserfall + eine KappeLive

Fail-Open-Wasserfall (Push → E-Mail → …) mit einer einheitlichen Frequenzbegrenzung, sodass Mitglieder niemals doppelt über verschiedene Kanäle kontaktiert werden.

Unterstützung bei der LeistungserbringungEinführung

Die Anmeldung und der Sendetermin sind heute im Code; Die eigentliche Push-Lieferung erfolgt pro Team hinter einer kontrollierten Flagge. Bitten Sie Ihr SocialHub-Team, es zu aktivieren.

Gerätetoken registrieren Live

Rufen Sie diese Funktion innerhalb der angemeldeten Mitglieder-WebView auf (der Session-Cookie des Nutzers enthält die Identität). Informationen zum SSO-Ablauf der WebView, der diese Sitzung herstellt, finden Sie im Leitfaden Member Portal Embed.

// The member must be signed in (consumer session cookie, set by the WebView SSO
// flow). teamId + memberId are taken from the SESSION — never the request body —
// so there is no member-enumeration surface here.
POST https://flash.socialhub.ai/api/consumer/push/register
Content-Type: application/json

{
  "platform": "ios",             // "ios" | "android"
  "provider": "fcm",             // "fcm" (default) | "apns"  — optional
  "token": "<device push token>",
  "appBundleId": "com.yourbrand.app"   // optional
}
// → 200  { "ok": true }
//   Idempotent UPSERT keyed on (team, token): re-registering the same device
//   simply re-points it at the current member. Call it on every app launch and
//   whenever the OS rotates the token.

Senden: Push ist ein Kanal, kein API-Aufruf.

// You do NOT call a "send push" endpoint. Push is a CHANNEL inside the existing
// automation + campaign send stack — the same engine that sends email. When a
// journey or campaign targets a member:
//
//   1. SocialHub resolves the member's channels in a waterfall (fail-open):
//        push (if a token + consent exist)  →  email  →  …
//   2. One SHARED frequency cap applies across channels, so a member is never
//      double-messaged on push AND email for the same step.
//   3. No token / no consent / push disabled  →  silently falls back to email.
//
// Net: you author one journey; SocialHub picks the best channel per member.

Marketer erstellen Push-Benachrichtigungen ohne Programmierung: einen Push-Schritt im visuellen Kampagnen-Canvas (neben E-Mail) mit KI-generiertem Text, denselben Platzhaltern wie bei E-Mails und wiederverwendbaren Push-Vorlagen. Der erstellte Inhalt wird zum Push-Inhalt der Kampagne und über den oben beschriebenen Sendepfad zugestellt – Ihre App registriert lediglich Gerätetoken.

Vor dem Livegang

FCM (Android + iOS via Firebase)

Stellen Sie Ihrem SocialHub-Team die Zugangsdaten für Ihr Firebase-Dienstkonto zur Verfügung. Senden Sie diese über FCM HTTP v1 (OAuth über ein Dienstkonto) – den Standardanbieter.

APNs (optional, direkt)

Wenn Sie direkt über APNs an iOS senden, geben Sie Ihren APNs-Authentifizierungsschlüssel (.p8), Ihre Schlüssel-ID und Ihre Team-ID an. Registrieren Sie diese Geräte beim Anbieter: „apns“.

Zustimmung

Push-Benachrichtigungen werden durch die explizite Einwilligung des Mitglieds und das Signal der globalen Datenschutzkontrolle (Fehlerbehandlung) gesteuert. Mitglieder ohne aktive Push-Einwilligung werden übersprungen – der Versand erfolgt per E-Mail.

Checkliste für die Abnahme

Durch die zweimalige Registrierung desselben Geräts wird kein Duplikat erstellt – UPSERT verweist es erneut auf das aktuelle Mitglied.

Ein angemeldetes Mitglied mit einem gültigen Token erhält eine Push-Benachrichtigung; ein Mitglied ohne Token/Einwilligung erhält stattdessen die E-Mail-Alternative – niemals gar nichts, niemals beides.

Der Widerruf der Push-Einwilligung (oder eines Signals der globalen Datenschutzkontrolle) führt dazu, dass das Mitglied sofort zum E-Mail-Kanal weitergeleitet wird.

Push-Benachrichtigungen einrichten?

Sprechen Sie mit einem Techniker über FCM/APNs-Anmeldeinformationen, den Sendekanal-Wasserfall oder die Ermöglichung der Bereitstellung für Ihr Team.

Sprechen Sie mit der Technik