Aller au contenu
Documentation · React Native et Expo

Installer le widget

Installer Parlo dans une application Expo / React Native

Le SDK @sayparlo/react-native ajoute à votre application iOS et Android la même expérience que le widget web : parler ou écrire, joindre une capture, demander de l'aide.

Dans Parlo, ajoutez d'abord votre application : Sites → Ajouter → Application mobile. Sa clé (pk_…) est affichée dans l'onglet Installation. Expo SDK 53 ou plus récent.

1Installez le SDK

Terminal
npx expo install @sayparlo/react-native expo-audio expo-application expo-device

Déclarez l'usage du micro dans app.json, puis refaites un build de développement :

JSON
{
  "expo": {
    "plugins": [
      [
        "expo-audio",
        {
          "microphonePermission": "Autoriser $(PRODUCT_NAME) à utiliser le micro pour vos retours vocaux."
        }
      ]
    ]
  }
}

2Enveloppez votre application

Une seule fois, à la racine : App.tsx, ou app/_layout.tsx avec Expo Router.

TSX
import { ParloProvider } from '@sayparlo/react-native'

export default function App() {
  return (
    <ParloProvider siteKey="VOTRE_CLÉ_DE_SITE" apiUrl="https://sayparlo.com" showButton>
      <Navigation />
    </ParloProvider>
  )
}

showButton affiche le bouton flottant « Donner mon avis ». Pour ouvrir Parlo depuis vos propres boutons :

TSX
import { useParlo } from '@sayparlo/react-native'

function Reglages() {
  const parlo = useParlo()
  return (
    <>
      <Button title="Donner mon avis" onPress={() => parlo.open()} />
      <Button title="Besoin d'aide ?" onPress={() => parlo.open({ intent: 'support' })} />
    </>
  )
}

3Lancez l'application

Au démarrage, le SDK contacte Parlo : l'application passe à « Détecté » dans l'onglet Installation. Les retours envoyés depuis un build de développement (__DEV__) sont marqués « Test » et exclus des statistiques.

Identifier vos utilisateurs

TSX
const parlo = useParlo()

useEffect(() => {
  parlo.identify(user ? { id: user.id, email: user.email, name: user.name, hash: user.parloHash } : null)
}, [user])

Le hash se calcule sur votre serveur, jamais dans l'application : voir Identification des utilisateurs. Dans une application mobile, la vérification d'identité est particulièrement recommandée : la clé du site est lisible dans l'application.

Écran, contexte et version

TSX
parlo.setScreen('Paiement')                 // affiché comme « page » du retour
parlo.setContext({ plan: 'pro', compte: 'Acme' })
parlo.setVersion('2.4.1')                   // lue dans le build natif par défaut

// Avec Expo Router : suivre la route courante
const pathname = usePathname()
useEffect(() => parlo.setScreen(pathname), [pathname])

L'appareil (modèle, version d'iOS ou d'Android) est joint automatiquement à chaque retour.

Captures d'écran

Installez react-native-view-shot et passez une fonction de capture : l'utilisateur peut alors joindre une capture de l'application.

TSX
import { captureScreen } from 'react-native-view-shot'

<ParloProvider
  siteKey="VOTRE_CLÉ_DE_SITE"
  captureScreen={() => captureScreen({ format: 'jpg', quality: 0.7 })}
>

Propriétés de ParloProvider

PropriétéRôle
siteKeyClé de l’application dans Parlo (obligatoire).
apiUrlAdresse de Parlo.
showButtonAffiche le bouton flottant.
buttonPositionbottom-right (par défaut) ou bottom-left.
userUtilisateur connecté, comme identify().
contextContexte joint aux retours.
versionVersion de l’application (version native par défaut).
localeForce la langue ; sinon le réglage Parlo, puis la langue du téléphone.
testModeMarque les retours comme tests (__DEV__ par défaut).
captureScreenActive les captures d’écran.
appIdIdentifiant affiché dans la « page » des retours (bundle id par défaut).

Couleur, question et langue se règlent dans Parlo (Sites → votre application → Apparence) et s'appliquent sans nouvelle version de l'application. Les demandes d'aide se désactivent au même endroit.