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.
pk_…) est affichée dans l'onglet Installation. Expo SDK 53 ou plus récent.1Installez le SDK
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 :
{
"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.
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 :
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
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
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.
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 |
|---|---|
siteKey | Clé de l’application dans Parlo (obligatoire). |
apiUrl | Adresse de Parlo. |
showButton | Affiche le bouton flottant. |
buttonPosition | bottom-right (par défaut) ou bottom-left. |
user | Utilisateur connecté, comme identify(). |
context | Contexte joint aux retours. |
version | Version de l’application (version native par défaut). |
locale | Force la langue ; sinon le réglage Parlo, puis la langue du téléphone. |
testMode | Marque les retours comme tests (__DEV__ par défaut). |
captureScreen | Active les captures d’écran. |
appId | Identifiant 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.