SDK di chat per app mobili

Scegli il tuo SDK

• iOS

  SDK Swift con Swift Package Manager e un esempio Xcode.

  Sorgente e installazione per iOSIssue per iOS

• Android

  SDK Kotlin con un'app di esempio Gradle.

  Sorgente e installazione per AndroidIssue per Android

• React Native

  API TypeScript e app di esempio basate sugli SDK Sonny per iOS e Android.

  Sorgente e installazione per React NativeIssue per React Native

Collega la tua app

1. In un ambiente Sonny abilitato per il mobile, apri Canali → Chat dal vivo → App mobili. Un proprietario o amministratore crea una chiave app per ogni piattaforma e bundle o ID applicazione.
2. Installa l'SDK seguendo il README del suo repository. Configuralo con l'ID del tuo sito e la chiave app pubblica per quel target di build. React Native richiede chiavi app separate per iOS e Android.
3. Mostra la chat come conversazione a schermo intero o integrala nella tua app. Mantieni una sola vista di chat attiva alla volta.
4. Per i clienti che hanno effettuato l'accesso, crea un JWT di identità sul tuo server e passalo all'SDK. Chiama reset() al logout per avviare una nuova sessione visitatore.

Le chiavi app sono identificatori pubblici. I segreti di firma dell'identità e le chiavi dei provider di notifiche restano sul tuo server o nelle impostazioni protette di Sonny.

Notifiche push

Alla richiesta del permesso per le notifiche e all'ottenimento del token pensa la tua app. L'SDK accetta un token APNs su iOS o un token FCM su Android e gestisce i tocchi sulle notifiche di Sonny. La consegna richiede le credenziali della tua app: una chiave di firma APNs e gli ID team/chiave Apple, oppure un account di servizio FCM per il tuo progetto Firebase. Le credenziali dell'app Sonny per agenti appartengono a un'app separata. La consegna push è ancora in fase di validazione durante questa anteprima.

1. Carica le credenziali del provider della tua app in App mobili. Per APNs, fai corrispondere l'ambiente sandbox o di produzione alla tua build.
2. Apri l'app, consenti le notifiche e passa il suo token all'SDK. Aggiorna l'elenco dei dispositivi nelle impostazioni e seleziona il tuo dispositivo di prova in base all'ora di registrazione.
3. Metti l'app in background e seleziona Invia notifica push di prova. Verifica la ricezione sul dispositivo. Lo stato nelle impostazioni mostra l'accettazione da parte del provider o un codice di errore sicuro; l'accettazione da sola non conferma l'arrivo.
4. Per provare le conversazioni, invia una risposta di un agente o dell'AI mentre il visitatore è disconnesso. Una notifica di risposta apre quella conversazione quando la tua app inoltra il tocco a handlePush. La notifica di prova generica non apre una conversazione.

Segnala un problema o contribuisci

Apri una issue nel repository dell'SDK che usi. Indica la versione o il commit, le versioni del sistema operativo e del framework e una piccola riproduzione. Ogni repository accetta pull request e include indicazioni per contribuire e segnalare problemi di sicurezza. Non inserire nelle issue pubbliche dati dei clienti, JWT di identità, token dei dispositivi o chiavi private.