Docs

Mobile SDK

Proposez le même chat de support « IA plus humain » que sur le web à l’intérieur de vos applications natives Android, iOS et Flutter. Un seul contrat backend, un seul comportement, trois plateformes.

Plateformes#

Trois SDK natifs partagent une surface d’API publique identique. Choisissez celui qui correspond à votre application :

SDKStackMinimum
AndroidKotlin, Jetpack ComposeminSdk 24, Kotlin 2.x
iOSSwift, SwiftUI (aucune dépendance)iOS 15+, Swift 5.9+
FlutterDart pur, aucun pont natifDart 3.4+, Flutter 3.16+

Chaque SDK affiche un vrai chat natif sous forme de feuille inférieure par-dessus votre application — pas une WebView. Votre application dessine le point d’entrée (un bouton, une icône, un badge) et ouvre le chat avec Respondo.open().

Ce qui est inclus#

Les SDK mobiles reprennent l’ensemble des fonctionnalités du widget web :

  • Cœur de chat : agent IA, transfert en direct vers des agents humains, indicateurs de frappe et de lecture, pièces jointes.
  • Fil d’actualités (« Nouveautés ») et listes de contrôle d’onboarding.
  • Enquêtes (NPS, CSAT et plus encore).
  • Bannières au niveau de la page et accroches proactives liées à l’écran courant. Signalez l’écran courant avec Respondo.setCurrentScreen("screen_name") à chaque navigation — les accroches proactives et le ciblage par page s’y réfèrent.
  • Notifications push pour les réponses des agents et les campagnes, avec des liens profonds vers la bonne conversation.
Les visites guidées produit et les info-bulles sont des surfaces réservées au web et ne sont pas reprises dans les SDK mobiles.

Comment ça marche#

Chaque SDK est un client léger pour le même contrat public de widget que le widget web — le backend est réutilisé tel quel. La messagerie fonctionne via REST plus un WebSocket, et la remise se replie en douceur (WebSocket, puis SSE, puis polling REST) et remonte dès que la connexion se rétablit.

L’autorisation est en couches :

  • visitor_id — un identifiant anonyme stable que le SDK génère et conserve de façon sécurisée sur l’appareil : préférences chiffrées par l’Android Keystore, trousseau iOS, et sur Flutter un fichier privé de l’application dans le storageDirectory transmis à init.
  • userHash — une signature HMAC issue de votre backend qui lie une conversation à une personne réelle (vérification d’identité).
  • session-token — émis par conversation et rejoué sur les appels REST et WebSocket.

Pour commencer#

Rendez-vous sur la page de plateforme qui correspond à votre application — SDK Android, SDK iOS ou SDK Flutter — pour l’installation et une initialisation fonctionnelle. Configurez ensuite la Vérification d’identité pour reconnaître les utilisateurs connectés sur tous leurs appareils, et les Notifications push pour la remise hors ligne.

Chaque SDK s’installe depuis le registre de sa plateforme : Android depuis Maven Central (ai.respondo:respondo-sdk), iOS via Swift Package Manager depuis github.com/respondo-app/sdk-ios, et Flutter depuis pub.dev (respondo_sdk). Les sources Android et iOS sont publiques sur GitHub.