SocialHub.AI
Ressourcen · Entwicklerzentrum

WhatsApp · LINE · RCS

Verbinden Sie WhatsApp (Meta Cloud API), LINE (Messaging API) und RCS (Google RBM) mit Ihren eigenen Anbieterkonten. Bei jedem handelt es sich um einen Kanal im selben Sendeablauf wie E-Mail, SMS und Push – bis Sie ihn verbinden, wobei die Zustimmung zum Zeitpunkt des Versands erzwungen wird.

So funktioniert es

Eigenes Konto verwenden

Jeder Kanal nutzt das eigene Anbieterkonto Ihrer Marke – ein Meta-Geschäftskonto (WhatsApp), ein offizielles Konto (LINE) oder einen verifizierten RBM-Agenten (Google). Der Kanal bleibt deaktiviert, bis Sie ihn verbinden; vorher werden keine Nachrichten gesendet.

Wasserfall-E-Mail-Kampagne

Es gibt keine separaten „Senden WhatsApp“ und „Senden API“. Jeder Kanal ist Teil derselben Kampagnen-/Automatisierungs-Engine wie E-Mail, SMS und Push-Benachrichtigungen – mit einer gemeinsamen Frequenzbegrenzung und automatischem Fallback auf den nächsten Kanal (E-Mail funktioniert immer).

Einwilligung beim Versand erzwungen

Die Marketing-Einwilligung wird pro Kanal zum Zeitpunkt des Versands geprüft (marketing_whatsapp / marketing_line / marketing_rcsEin Mitglied ohne die erforderliche Einwilligung wird übersprungen und nicht gesendet.

Geheimnisse verschlüsselt

Zugriffstoken, Kanalgeheimnisse und Servicekontoschlüssel werden im Ruhezustand verschlüsselt und niemals von API zurückgegeben. Sie fügen sie einmalig unter Einstellungen → Kanäle ein.

WhatsApp

Verbinden Sie Ihr Meta WhatsApp Geschäftskonto. Von Unternehmen initiierte Nachrichten verwenden von Meta genehmigte Vorlagen.

// WhatsApp — Meta WhatsApp Cloud API (Settings → Channels → WhatsApp)
//   • Phone number id      — from your WhatsApp Business Account (WABA)
//   • Access token         — WABA access token (write-only, encrypted at rest)
//   • Templates            — business-initiated messages use Meta-APPROVED templates
//
// Addressed by the member's phone number. Off until enabled; once on, WhatsApp joins
// the send waterfall. Meta business verification happens on Meta's side before delivery.

LINE

Verbinden Sie ein LINE Offizieller Account. Mitglieder sind erreichbar über LINE userId — erfasst über den Follow-Webhook (signaturverifiziert) oder das One-Tap-Portal Connect LINESiehe die Mitgliederportal einbetten Leitfaden für die Sitzung des angemeldeten Nutzers, auf dem der Portalablauf basiert.

// LINE — Messaging API (Settings → Channels → LINE)
//   • Channel access token — long-lived token (write-only, encrypted)
//   • Channel secret       — OPTIONAL, only to receive follow/unfollow events (below)
//   • LINE Login channel   — OPTIONAL, powers one-tap portal "Connect LINE"
//
// LINE is addressed by the member's LINE userId — captured two ways:
//
// 1) Follow webhook. Point your LINE Official Account's webhook at:
//      POST  https://flash.socialhub.ai/api/webhooks/line/{teamId}
//    Flash verifies the x-line-signature header before acting:
//      signature == base64( HMAC-SHA256( rawRequestBody, <channel secret> ) )
//    follow  -> the member's LINE userId is (re)linked
//    unfollow-> Flash stops targeting them on LINE
//    (Always returns 200 so LINE keeps the endpoint enabled.)
//
// 2) One-tap portal Connect LINE (needs the LINE Login channel). The member taps
//    "Connect LINE" on their portal privacy page and authorizes via LINE Login;
//    Flash links their LINE account to their membership automatically.

RCS

Verbinden Sie einen Google-verifizierten RBM-Agenten mit einem Servicekonto. Flash tauscht serverseitig beim Senden den Service-Account-Schlüssel gegen ein OAuth2-Token aus.

// RCS — Google RCS Business Messaging / RBM (Settings → Channels → RCS)
//   • RBM agent id             — your Google-VERIFIED RBM agent (the sender)
//   • Service-account email    — the SA that calls the RBM API
//   • Service-account key (PEM)— write-only, encrypted; exchanged for an OAuth2 token
//                                server-side at send time
//
// Addressed by E.164 phone (like SMS/WhatsApp). Reaches RCS-capable Android handsets;
// falls back automatically when a recipient can't receive RCS. Google verifies the
// RBM agent on Google's side before delivery is live.

Gut zu wissen

  • Jeder Kanal ist pro Arbeitsbereich und standardmäßig deaktiviert. Ein Arbeitsbereich ohne verknüpftes Konto behält den E-Mail-First-Ansatz ohne Verhaltensänderung bei.
  • Sie rufen nie einen kanalspezifischen „Senden“-Endpunkt auf: Erstellen Sie eine Kampagne oder Automatisierung einmalig, und der Kanalplan wählt automatisch den passenden Kanal für jedes Mitglied aus und greift bei Bedarf auf E-Mail zurück.
  • WhatsApp und RCS werden telefonisch kontaktiert; LINE von dem Mitglied LINE userId (Folgen Sie dem Webhook oder Portal Connect) LINE).
  • Anbieter-Onboarding/Verifizierung (Meta-Business-Verifizierung, LINE OA-Setup, Google RBM-Agentenverifizierung) erfolgt anbieterseitig – Flash verwaltet die Zugangsdaten und setzt die Einwilligung durch, kann die Genehmigung des Anbieters jedoch nicht beschleunigen.

Verbindung eines Messaging-Kanals?

Fügen Sie Ihre Anbieter-Anmeldeinformationen in den Kanaleinstellungen ein, aktivieren Sie die Funktion, und der Kanal wird automatisch Ihren bestehenden Kampagnen und Journeys hinzugefügt.