Créer une intégration

SDK de chat mobile

Ajoutez le chat de support Sonny à votre application iOS, Android ou React Native destinée à vos clients. Vos clients contactent votre équipe depuis votre application, via votre boîte de réception Sonny existante.

Vous cherchez l'application que votre équipe de support utilise pour répondre ? Installez l'application agent Sonny.

Choisissez votre SDK

Connecter votre application

  1. Dans un environnement Sonny compatible mobile, ouvrez Canaux → Chat en direct → Applications mobiles. Un propriétaire ou un admin crée une clé d'application pour chaque plateforme et chaque bundle ou identifiant d'application.
  2. Installez le SDK en suivant le README de son dépôt. Configurez-le avec l'identifiant de votre site et la clé d'application publique de cette cible de build. React Native nécessite des clés d'application iOS et Android distinctes.
  3. Affichez le chat sous forme de conversation plein écran ou intégrez-le à votre application. Gardez une seule vue de chat active à la fois.
  4. Pour les clients connectés, créez un JWT d'identité sur votre serveur et transmettez-le au SDK. Appelez reset() à la déconnexion pour démarrer une nouvelle session visiteur.

Les clés d'application sont des identifiants publics. Les secrets de signature d'identité et les clés des fournisseurs de notifications restent sur votre serveur ou dans les paramètres protégés de Sonny.

Notifications push

Votre application gère l'autorisation des notifications et l'obtention du jeton. Le SDK accepte un jeton APNs sur iOS ou un jeton FCM sur Android, et gère les touches sur les notifications Sonny. La livraison nécessite les identifiants de votre propre application : une clé de signature APNs et les identifiants d'équipe et de clé Apple, ou un compte de service FCM pour votre projet Firebase. Les identifiants de l'application agent Sonny appartiennent à une autre application. La livraison push reste en cours de validation pendant cet aperçu.

  1. Importez les identifiants du fournisseur de votre application dans Applications mobiles. Pour APNs, faites correspondre l'environnement sandbox ou production à votre build.
  2. Ouvrez l'application, autorisez les notifications et transmettez son jeton au SDK. Actualisez la liste des appareils dans les paramètres et sélectionnez votre appareil de test d'après son heure d'enregistrement.
  3. Passez l'application en arrière-plan et sélectionnez Envoyer un push de test. Vérifiez la réception sur l'appareil. Le statut dans les paramètres indique l'acceptation par le fournisseur ou un code d'erreur sûr ; l'acceptation seule ne confirme pas l'arrivée.
  4. Pour tester une conversation, envoyez une réponse d'agent ou de l'IA pendant que le visiteur est déconnecté. Une notification de réponse ouvre cette conversation lorsque votre application transmet la touche à handlePush. La notification de test générique n'ouvre pas de conversation.

Signaler un problème ou contribuer

Ouvrez un ticket dans le dépôt du SDK que vous utilisez. Indiquez sa version ou son commit, vos versions d'OS et de framework, et une reproduction minimale. Chaque dépôt accepte les pull requests et contient des consignes de contribution et de signalement de sécurité. Ne mettez jamais de données clients, de JWT d'identité, de jetons d'appareil ni de clés privées dans des tickets publics.

Documentation associée