Anleitungen & Tutorials

So bauen Sie einen nativen Support-Chat in Ihre iOS- und Android-Apps ein

Bauen Sie an einem Nachmittag einen nativen Helpium-Chat in Ihre iOS- und Android-Apps ein: Ihre KI antwortet sofort, Ihr Team übernimmt bei Bedarf, und Antworten kommen als Push-Benachrichtigungen an.

Maximiliano Monge

Maximiliano Monge

Founder & editor at Helpium. Writing about AI-powered custom...

· 7 min
So bauen Sie einen nativen Support-Chat in Ihre iOS- und Android-Apps ein

Ihre Kunden suchen Hilfe dort, wo sie sowieso sind: in Ihrer App. Wer sie auf eine Website oder zu einer E-Mail-Adresse schickt, macht es ihnen im ungünstigsten Moment unnötig schwer. Mit den mobilen Helpium-SDKs bauen Sie an einem Nachmittag einen nativen Support-Chat in Ihre iOS- und Android-Apps ein. Ihr KI-Agent antwortet sofort, Ihr Team übernimmt bei Bedarf, und jede Unterhaltung landet im selben Helpium-Posteingang wie Ihr Web-Chat, Ihre E-Mails und WhatsApp.

Helpium-Chat unter iOS, bereit für die erste Nachricht
Der Chat öffnet sich schreibbereit, mit Ihrer Begrüßung und sofortigen Antworten.

Das bekommen Sie

  • Ein nativer Chat, keine Web-Ansicht. SwiftUI unter iOS, native Views unter Android. Er fühlt sich wie ein Teil Ihrer App an.
  • Ihr KI-Agent inklusive. Dasselbe Wissen, dieselben Abläufe und KI-Aktionen, die Sie für das Web eingerichtet haben, antworten auch in der App.
  • Eine saubere Übergabe. Der Kunde tippt auf „Mit einem Menschen sprechen“, und Ihr Team antwortet in Echtzeit aus dem Posteingang.
  • Push-Benachrichtigungen. Antworten Ihrer Agenten erreichen den Kunden auch bei geschlossener App.
  • Ihre Marke. Jede Farbe, im hellen und im dunklen Modus, und jeder Text, in jeder Sprache.

Bevor Sie starten: Ihre Schlüssel in Helpium finden

Alles, was die Integration braucht, finden Sie auf einer Seite Ihres Helpium-Workspace: Einstellungen → Live Chat. Die mobilen SDKs gehören zum Kanal Live Chat, daher folgen Unterhaltungen aus Ihrer App denselben Regeln für KI, Übergabe und Geschäftszeiten wie Ihr Website-Chat.

Der Widget-Schlüssel steht unter Installation. Er identifiziert Ihren Workspace und ist zur Veröffentlichung gedacht: Er kommt in Ihre App, genau wie in das HTML Ihrer Website. Kopieren Sie ihn mit der Schaltfläche Kopieren.

Das Feld Widget-Schlüssel in Helpium, unter den Live-Chat-Einstellungen
Einstellungen → Live Chat → Installation: Der Widget-Schlüssel kommt in Ihre App.

Das Identity Secret finden Sie unter Kundenidentifikation. Klicken Sie auf Anzeigen oder Kopieren. Dieses hier ist privat: Speichern Sie es auf Ihrem Server als Umgebungsvariable, neben Ihren anderen Geheimnissen. Legen Sie es niemals in der App, in der Versionsverwaltung oder auf einer Webseite ab. Wer es besitzt, könnte sich als jeder Ihrer Kunden anmelden. Sollte es je durchsickern, klicken Sie auf Neu generieren und aktualisieren Sie Ihren Server.

Das Feld Identity Secret in Helpium, maskiert, mit den Schaltflächen Anzeigen, Kopieren und Neu generieren
Einstellungen → Live Chat → Kundenidentifikation: Das Identity Secret bleibt auf Ihrem Server.

Die Push-Zugangsdaten verbinden Sie weiter unten auf derselben Seite, unter Mobile Apps. Sie brauchen sie nur für Benachrichtigungen, deshalb können Sie in Schritt 4 darauf zurückkommen.

Der Bereich Mobile Apps in Helpium mit Verbinden-Schaltflächen für iOS und Android
Einstellungen → Live Chat → Mobile Apps: Verbinden Sie Apple und Firebase, um Push-Benachrichtigungen zu senden.

Schritt 1: Die Identität Ihrer Nutzer auf Ihrem Server signieren

Wenn ein Kunde in Ihrer App angemeldet ist, teilt Ihr Backend Helpium mit, wer er ist, indem es ein kurzes Token mit dem Identity Secret signiert. Seine Unterhaltung folgt ihm dann auf alle Geräte, der Chat fragt nicht mehr nach Name und E-Mail, und KI-Aktionen können sicher auf sein Konto zugreifen. Helpium ist es egal, in welcher Sprache Ihr Backend geschrieben ist: Das Token ist ein Standard-JWT, und für jede Sprache gibt es eine passende Bibliothek.

Das Token ist ein mit HS256 signiertes JWT, wobei das Identity Secret als Schlüssel dient. Sein Payload enthält:

  • user_id: Ihre eigene ID für den Nutzer, als String. Verwenden Sie diese oder email, am besten beide.
  • email: die E-Mail-Adresse des Nutzers.
  • exp: der Ablaufzeitpunkt des Tokens in Unix-Sekunden. Pflichtfeld. Eine Stunde reicht völlig aus.

JSON

{
  "user_id": "42",
  "email": "jane@example.com",
  "exp": 1767225600
}

Fügen Sie einen Endpunkt hinzu, den nur angemeldete Nutzer aufrufen können, zum Beispiel GET /api/helpium-token, der dieses Token für den aktuellen Nutzer erstellt und zurückgibt. Ihre App ruft ihn nach der Anmeldung auf und übergibt das Ergebnis an das SDK. Hier der Signierteil in einigen gängigen Stacks; jede JWT-Bibliothek, die HS256 unterstützt, funktioniert auf dieselbe Weise.

Node.js

// npm install jsonwebtoken
const jwt = require('jsonwebtoken');

const token = jwt.sign(
  { user_id: String(user.id), email: user.email },
  process.env.HELPIUM_IDENTITY_SECRET,
  { algorithm: 'HS256', expiresIn: '1h' }
);

Python

# pip install pyjwt
import os, time, jwt

token = jwt.encode(
    {"user_id": str(user.id), "email": user.email, "exp": int(time.time()) + 3600},
    os.environ["HELPIUM_IDENTITY_SECRET"],
    algorithm="HS256",
)

PHP

// composer require firebase/php-jwt
use Firebase\JWT\JWT;

$token = JWT::encode([
    'user_id' => (string) $user->id,
    'email' => $user->email,
    'exp' => time() + 3600,
], getenv('HELPIUM_IDENTITY_SECRET'), 'HS256');

Ruby

# gem install jwt
require 'jwt'

token = JWT.encode(
  { user_id: user.id.to_s, email: user.email, exp: Time.now.to_i + 3600 },
  ENV.fetch('HELPIUM_IDENTITY_SECRET'),
  'HS256'
)

Java

// io.jsonwebtoken:jjwt-api + jjwt-impl + jjwt-jackson
String token = Jwts.builder()
    .claim("user_id", String.valueOf(user.getId()))
    .claim("email", user.getEmail())
    .expiration(new Date(System.currentTimeMillis() + 3_600_000))
    .signWith(Keys.hmacShaKeyFor(System.getenv("HELPIUM_IDENTITY_SECRET").getBytes(StandardCharsets.UTF_8)), Jwts.SIG.HS256)
    .compact();

Keine Anmeldung in Ihrer App? Dann überspringen Sie diesen Schritt. Der Chat fragt vor der ersten Nachricht nach Name und E-Mail.

Schritt 2: Den Chat in Ihre iOS-App einbauen

Das iOS-SDK ist ein Swift Package (iOS 15+, keine weiteren Abhängigkeiten). Wählen Sie in Xcode File → Add Package Dependencies, fügen Sie https://github.com/helpium-io/helpium-sdk ein und fügen Sie das Produkt Helpium hinzu. Danach:

Swift

import Helpium

// At launch
Helpium.configure(widgetKey: "YOUR_WIDGET_KEY")

// After login, with the token from your server
Helpium.identify(userJwt: token)

// From your Help button
Helpium.present()

Eine Unterhaltung im Helpium-iOS-Chat, mit Antworten der KI und eines Agenten
KI-Antworten, ein Link aus Ihrem Hilfecenter und eine Antwort des Teams, gruppiert wie in einem nativen Chat.

Der Chat öffnet direkt die offene Unterhaltung des Kunden. Während jemand schreibt, sieht der Kunde das, ebenso den Status der KI, während sie etwas nachschlägt.

Schreibanzeige im Helpium-iOS-Chat
Schreibpunkte, während die KI oder ein Agent schreibt.

Schritt 3: Den Chat in Ihre Android-App einbauen

Das Android-SDK unterstützt Android 5.0 und höher und funktioniert mit Java und Kotlin gleichermaßen. Es verwendet einfache Android-Views und passt so zu alten und neuen Projekten, ohne androidx oder Compose hinzuzufügen. Fügen Sie JitPack und die Abhängigkeit hinzu:

Gradle

// settings.gradle
maven { url "https://jitpack.io" }

// app/build.gradle
implementation "com.github.helpium-io:helpium-sdk:0.1.0"

Dann in Ihrem Code:

Java

// Application.onCreate()
Helpium.configure(this, "YOUR_WIDGET_KEY");

// After login, with the token from your server
Helpium.identify(token);

// From your Help button
helpButton.setOnClickListener(v -> Helpium.present(this));

Eine Unterhaltung im Helpium-Android-Chat
Derselbe Chat unter Android, mit nativen Views gebaut.

React Native oder Expo im Einsatz?

Das Paket @helpium/react-native bündelt beide nativen SDKs, sodass Sie aus JavaScript denselben nativen Chat erhalten. Verwenden Sie mit Expo einen Development Build.

React Native

import { Helpium } from '@helpium/react-native';

Helpium.configure({ widgetKey: 'YOUR_WIDGET_KEY' });
Helpium.identify({ userJwt: token });
Helpium.present();

Schritt 4: Push-Benachrichtigungen aktivieren

Push-Benachrichtigungen werden über Ihre eigenen Apple- und Firebase-Konten gesendet. Sie kommen also von Ihrer App, und die Schlüssel bleiben bei Ihnen. Klicken Sie unter Einstellungen → Live Chat → Mobile Apps neben jeder Plattform auf Verbinden:

  • iOS: ein APNs-Schlüssel (.p8) aus Ihrem Apple-Developer-Konto, mit Key ID, Team ID und Ihrer Bundle ID.
  • Android: die Service-Account-JSON Ihres Firebase-Projekts.

Übergeben Sie dann das Geräte-Token und die Taps an das SDK. Es registriert nie einen eigenen Benachrichtigungsdienst und arbeitet daher neben den Benachrichtigungen, die Ihre App bereits sendet.

iOS

func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
    Helpium.setPushToken(deviceToken)
}

func userNotificationCenter(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse) async {
    Helpium.handlePush(response.notification.request.content.userInfo)
}

Android

@Override
public void onNewToken(@NonNull String token) {
    Helpium.setPushToken(token);
}

// Launcher activity: a notification tapped with the app closed
Helpium.handlePush(this, getIntent().getExtras());

Machen Sie ihn zu Ihrem

Standardmäßig verwendet der Chat die Markenfarbe aus Ihren Live-Chat-Einstellungen. Jede Farbe lässt sich auch aus der App heraus setzen, getrennt für den hellen und den dunklen Modus, mit der Möglichkeit, einen der beiden zu erzwingen:

Swift

Helpium.setAppearance(HelpiumAppearance(
    light: HelpiumColors(
        primary: "#0ea5e9",
        headerBackground: "#0ea5e9",
        headerText: "#ffffff"
    ),
    dark: HelpiumColors(
        primary: "#a78bfa",
        background: "#0f0d1a",
        surface: "#1c1830"
    )
))

Helpium-Chat mit hellblauem Design
Ein helles Design mit farbiger Kopfzeile.

Helpium-Chat mit dunkelviolettem Design
Ein dunkles Design, unabhängig von der Einstellung des Telefons erzwungen.

Helpium-Chat unter Android mit grünem Design
Jede Palette funktioniert auch unter Android.

Auch jeder Text gehört Ihnen: die Begrüßung, der Willkommenstext, der Platzhalter. Überschreiben Sie sie pro Sprache mit String-Ressourcen unter Android und Localizable.strings unter iOS, und fügen Sie Sprachen hinzu, die Helpium nicht mitliefert:

XML

<!-- res/values-es/strings.xml -->
<string name="helpium_greeting">¡Hola! ¿Te ayudamos con tu pedido?</string>

Testen Sie vor dem Release

  1. Öffnen Sie den Chat angemeldet: Er begrüßt den Kunden, ohne nach seinen Daten zu fragen.
  2. Stellen Sie eine Frage: Die KI antwortet in Sekunden.
  3. Tippen Sie auf „Mit einem Menschen sprechen“: Die Unterhaltung erscheint in Ihrem Helpium-Posteingang.
  4. Antworten Sie aus dem Posteingang: Die Antwort erscheint in Echtzeit in der App.
  5. Schließen Sie die App und antworten Sie erneut: Eine Push-Benachrichtigung kommt an und öffnet die Unterhaltung.

Nächste Schritte

KI-Support ohne KI-Preise

Unbegrenzte Nutzer. Ein fester Preis. Betreue Kunden mit KI und einem menschlichen Team, wenn es darauf ankommt.

Weiterlesen