Mobiele chat-SDK's

Kies je SDK

• iOS

  Swift-SDK met Swift Package Manager en een Xcode-voorbeeld.

  Broncode en installatie voor iOSIssues voor iOS

• Android

  Kotlin-SDK met een Gradle-voorbeeldapp.

  Broncode en installatie voor AndroidIssues voor Android

• React Native

  TypeScript-API en voorbeeldapp die de iOS- en Android-SDK's van Sonny gebruiken.

  Broncode en installatie voor React NativeIssues voor React Native

Koppel je app

1. Open in een Sonny-omgeving met mobiel ingeschakeld Kanalen → Livechat → Mobiele apps. Een eigenaar of beheerder maakt een app-sleutel aan voor elk platform en elke bundle- of applicatie-ID.
2. Installeer de SDK volgens de README van de repository. Configureer hem met je site-ID en de openbare app-sleutel voor dat buildtarget. React Native heeft aparte app-sleutels voor iOS en Android nodig.
3. Toon de chat als gesprek op volledig scherm of sluit hem in je app in. Houd steeds één actieve chatweergave tegelijk aan.
4. Maak voor ingelogde klanten een identiteits-JWT aan op je server en geef die door aan de SDK. Roep bij uitloggen reset() aan om een nieuwe bezoekerssessie te starten.

App-sleutels zijn openbare ID's. Geheimen voor het ondertekenen van identiteiten en sleutels van meldingsproviders blijven op je server of in de beveiligde instellingen van Sonny.

Pushmeldingen

Je app regelt zelf de toestemming voor meldingen en het ophalen van het token. De SDK accepteert een APNs-token op iOS of een FCM-token op Android, en verwerkt tikken op Sonny-meldingen. Voor aflevering heb je inloggegevens voor je eigen app nodig: een APNs-ondertekeningssleutel en Apple-team-/sleutel-ID's, of een FCM-serviceaccount voor je Firebase-project. De inloggegevens van de Sonny-app voor medewerkers horen bij een andere app. Pushaflevering wordt tijdens deze preview nog gevalideerd.

1. Upload de providergegevens van je app in Mobiele apps. Laat bij APNs de sandbox- of productieomgeving overeenkomen met je build.
2. Open de app, sta meldingen toe en geef het token door aan de SDK. Vernieuw de apparatenlijst in de instellingen en kies je testapparaat op basis van het registratietijdstip.
3. Zet de app op de achtergrond en kies Testpush verzenden. Controleer of het apparaat de melding ontvangt. De status in de instellingen toont of de provider de melding heeft geaccepteerd, of een veilige foutcode; acceptatie alleen bevestigt niet dat de melding is aangekomen.
4. Stuur voor het testen van gesprekken een antwoord van een medewerker of de AI terwijl de bezoeker niet verbonden is. Een antwoordmelding opent dat gesprek als je app de tik doorgeeft aan handlePush. De algemene testmelding opent geen gesprek.

Een probleem melden of bijdragen

Open een issue in de repository van de SDK die je gebruikt. Vermeld de versie of commit, de versies van je besturingssysteem en framework, en een kleine reproductie. Elke repository accepteert pull requests en bevat richtlijnen voor bijdragen en het melden van beveiligingsproblemen. Houd klantgegevens, identiteits-JWT's, apparaattokens en privésleutels uit openbare issues.