Vue d’ensemble de l’onboarding

La configuration de ChurnGuard se fait en 4 étapes. Selon votre plan, certaines étapes sont optionnelles ou non disponibles.

1. Connecter votre outil de facturation

L’outil de facturation est la seule intégration obligatoire. Elle permet à ChurnGuard de détecter les paiements échoués, annulations, remboursements et impayés.

Comment connecter votre outil de facturation

1- Depuis l’écran de configuration, cliquez sur Connect en face de Stripe.

2- Une fenêtre s’ouvre et vous demande votre Stripe API Key.

3- Dans votre Dashboard Stripe, révélez puis copiez votre API Key

Si vous le préférez, vous pouvez vous rendre dans Developers et créer une clé restreinte (Restricted API Key).

ATTENTION :

Ne pas cocher la case « Personnaliser les autorisations liées à cette clé« .
Si vous souhaitez tout de même personnaliser les autorisations, alors il faudra à minima sélectionner :

• « LECTURE SEULE » pour les évènements : charge.succeeded, charge.refunded, customer.created/updated/deleted, customer.subscription.created/deleted/updated, invoice.paid, invoice.payment_failed, invoice.payment_succeeded,customer.deleted
• Et « ECRITURE » pour l’évènement « webhook_endpoint ».

4- Copiez la clé (format sk_live_... ou rk_live_...) et collez-la dans le champ Stripe API Key de ChurnGuard.

5- Cliquez sur Connect. La connexion est confirmée instantanément.

Que se passe-t-il ensuite ?

Une fois Stripe connecté, ChurnGuard commence immédiatement à recevoir les événements de facturation. Les premiers signaux apparaissent dans votre dashboard dans les minutes qui suivent.

Si vous êtes sur le plan Essential, votre configuration est terminée. Cliquez sur Continue pour accéder à votre dashboard.

2. Connecter votre outil usage

Cette étape permet à ChurnGuard de tracker l’activité de vos utilisateurs dans votre produit : connexions, actions clés, complétion de l’onboarding. Deux intégrations sont disponibles.

Option A — PostHog

PostHog est un outil d’analytics produit. Choisissez cette option si vous utilisez PostHog pour tracker les événements utilisateurs.

1- Sélectionnez PostHog dans la liste des intégrations Usage.

2- Cliquez sur Connect. Une fenêtre s’ouvre.

3- Dans PostHog, rendez-vous dans Settings > Personal API Keys et créez une nouvelle clé personnelle.

4- Dans le champ Label, nommez votre clé ChurnGuard pour la retrouver facilement.
Dans Organization & project access, sélectionnez All access.
Dans la section Scopes, configurez les permissions suivantes en Read uniquement : Event definition, Person, Query, Property definition. Laissez toutes les autres scopes sur No access.

5- Cliquez sur Create key. La clé s’affiche une seule fois : copiez-la immédiatement.

6- Copiez la clé (format phx_...) et collez-la dans le champ Personal API Key.

7- Renseignez votre Project ID, disponible dans PostHog > Settings > Project.

8- Sélectionnez votre région : US, EU ou Cloud (EU généralement)

9- Cliquez sur Connect.

Option B — Supabase

Supabase est une base de données et un outil d’authentification. Choisissez cette option si vous utilisez Supabase pour gérer vos utilisateurs.

1- Sélectionnez Supabase dans la liste des intégrations Usage.

2- Cliquez sur Connect. Une fenêtre s’ouvre.

3- Dans votre Supabase Dashboard, rendez-vous dans Project Overview.Copiez votre Project URL et collez-la dans le champ correspondant.

4- Rendez-vous ensuite dans Settings > API. Copiez votre Anon Key (clé publique) et collez-la dans le champ Anon Key. Copiez votre Service Role Key (clé secrète) et collez-la dans le champ Service Role Key. Cette clé est nécessaire pour détecter l’inactivité des utilisateurs.

5- Cliquez sur Connect.

3. Connecter votre outil support

Cette étape permet à ChurnGuard d’analyser les tickets et emails de vos clients pour détecter des signaux de mécontentement ou de désengagement. Deux options sont disponibles.

Option A — Email Support (Gmail, Outlook, autres)

Fonctionne avec n’importe quel fournisseur email. ChurnGuard fournit une adresse de transfert unique à laquelle vous redirigez une copie de vos emails support.

1- Sélectionnez Email dans la liste des intégrations Support.

2- Cliquez sur Connect. ChurnGuard génère une adresse de transfert unique.

3- Copiez cette adresse (format support-xxxxx@inbound.churnguard.fr).

4- Une fois le transfert configuré, cliquez sur Continue dans ChurnGuard.

5- ChurnGuard vous demande de vérifier la connexion : envoyez un email test à votre adresse support depuis une autre adresse. Si le transfert est bien configuré, ChurnGuard le reçoit automatiquement.

§- Cliquez sur Verify connection. Si la vérification réussit, la connexion est confirmée.

Option B — Zendesk

Choisissez cette option si vous utilisez Zendesk comme outil de ticketing. ChurnGuard se connecte directement à votre compte via API.

1- Sélectionnez Zendesk dans la liste des intégrations Support.

2- Cliquez sur Connect. Une fenêtre s’ouvre.

3- Renseignez votre Subdomain Zendesk (la partie yourcompany de yourcompany.zendesk.com visible dans l’URL de la page).

4- Renseignez l’adresse email de votre compte administrateur Zendesk.

5- Générez un token API dans Zendesk Admin Center > Apps and integrations > APIs > Tokens API.

6- Copiez ce token et collez-le dans le champ API Token de ChurnGuard.

7- Cliquez sur Connect.

4. Configurer vos règles de signaux

C’est la dernière étape de la configuration. Vous choisissez ici quels signaux de churn ChurnGuard doit détecter et afficher dans votre dashboard. Ces règles peuvent être modifiées à tout moment depuis Settings > Rules.

Signaux disponibles par catégorie

Paiement (Stripe)

• Payment failed — tentative de paiement échouée
• Subscription canceled — le client a annulé son abonnement
• Refund issued — un remboursement a été émis
• Past due / Unpaid — facture en retard ou abonnement marqué impayé

Usage (PostHog ou Supabase)

• Inactivity — aucune connexion depuis X jours (seuil configurable)
• Key action not performed — l’utilisateur n’a pas réalisé une action clé depuis X jours

Support / Mail (Zendesk + email)

• Ticket surge — hausse soudaine du nombre de tickets (ex : 2 tickets sur 7 jours)
• Negative ticket — sentiment négatif détecté sur un ticket support
• Long ticket response time — délai de première réponse supérieur à 48h
• Email surge — hausse des emails support (ex : 2 emails sur 7 jours)
• Negative email — sentiment négatif détecté dans un email support

Comment configurer vos règles

1. Cochez les signaux que vous souhaitez activer. Les signaux Payment sont précochés par défaut.
2. Pour les signaux Usage et Support, ajustez les seuils selon votre contexte (nombre de jours d’inactivité, nombre de tickets, etc.). Ces seuils sont modifiables ultérieurement.
3. Cliquez sur Continue pour finaliser la configuration.

Votre configuration est terminée

ChurnGuard est maintenant opérationnel ! Votre dashboard affiche en temps réel la liste de vos clients à risque, classés par niveau d’urgence, avec pour chacun les signaux détectés et une action recommandée.

Si vous avez des questions sur la configuration ou rencontrez un problème, contactez nous ou réservez directement un appel pour une démo live adaptée à votre stack.

L’article Configurer ChurnGuard : Guide de démarrage est apparu en premier sur ChurnGuard - Documentation.