Mobile SDK

Piattaforme#

Tre SDK nativi condividono una superficie di API pubblica identica. Scegli quello adatto alla tua app:

Ogni SDK mostra una vera chat nativa come bottom sheet sopra la tua app — non una WebView. La tua app disegna il punto d’ingresso (un pulsante, un’icona, un badge) e apre la chat con Respondo.open().

Cosa è incluso#

Gli SDK mobile rispecchiano l’insieme di funzionalità del widget web:

• Nucleo della chat: agente IA, passaggio in tempo reale a operatori, stato di digitazione e lettura, allegati.
• Feed di novità («What’s new») e checklist di onboarding.
• Sondaggi (NPS, CSAT e altri).
• Banner a livello di pagina e teaser proattivi legati alla schermata corrente. Segnala la schermata corrente con Respondo.setCurrentScreen("screen_name") a ogni navigazione — i teaser proattivi e il targeting a livello di pagina vi fanno riferimento.
• Notifiche push per le risposte degli operatori e le campagne, con deep link diretti nella conversazione giusta.

Come funziona#

Ogni SDK è un client leggero per lo stesso contratto pubblico del widget che usa il widget web — il backend è riutilizzato senza modifiche. La messaggistica viaggia su REST più un WebSocket, e la consegna ripiega in modo graduale (WebSocket, poi SSE, poi polling REST) e risale non appena la connessione si ripristina.

L’autorizzazione è stratificata:

• visitor_id — un id anonimo stabile che l’SDK genera e conserva in modo sicuro sul dispositivo: preferenze cifrate con l’Android Keystore, il keychain di iOS e, su Flutter, un file privato dell’app nella storageDirectory che passi a init.
• userHash — una firma HMAC dal tuo backend che lega una conversazione a una persona reale (verifica dell’identità).
• session-token — emesso per ogni conversazione e ripetuto nelle chiamate REST e WebSocket.

Per iniziare#

Vai alla pagina della piattaforma adatta alla tua app — Android SDK, iOS SDK o Flutter SDK — per l’installazione e una init funzionante. Poi collega la Verifica dell’identità per riconoscere gli utenti autenticati su più dispositivi, e le Notifiche push per la consegna offline.