Intégrations – Connectez CRM, courriel, point de vente, commerce électronique et analyses à Perkstar
Découvrez comment gérer les intégrations dans Perkstar. Guide complet pour connecter des plates-formes tierces, accéder à votre clé API, relier les outils de communication commerciale CRM/système de caisse/courriel, surveiller l'état de synchronisation, gérer les mappages de champs et dépanner les problèmes de connexion.
Aperçu
La section Intégrations est votre hub de connexion pour relier Perkstar aux autres outils et plates-formes commerciales que vous utilisez quotidiennement. En intégrant votre programme de fidélisation à votre pile technologique existante, vous créez un écosystème unifié où les données circulent automatiquement entre les systèmes, éliminant ainsi le travail manuel et garantissant la cohérence entre les plateformes.
Ce que vous pouvez faire dans la section Intégrations :
Afficher toutes les intégrations actives avec des applications tierces
Connectez de nouvelles plates-formes à Perkstar avec une autorisation en un clic
Accédez à votre clé API unique pour des intégrations personnalisées
Surveiller l’état et la santé de l’intégration
Examiner les détails de l'intégration et les dates de connexion
Déconnectez les intégrations dont vous n’avez plus besoin
Vérifiez la capacité d'intégration et l'utilisation de votre forfait
Conseil: Les intégrations éliminent les silos de données et la saisie manuelle des données, économisant ainsi des heures de travail administratif. Lorsque votre plateforme de fidélisation se connecte à votre CRM, système de point de vente, outil de communication commerciale par courriel ou plateforme de commerce électronique, les données client se synchronisent automatiquement, les transactions déclenchent instantanément des récompenses de fidélisation et votre équipe bénéficie d'une vue complète de l'engagement client sur tous les points de contact.
Qui doit gérer les intégrations :
Titulaires du compte : Accès complet à toutes les fonctionnalités d'intégration
Administrateurs techniques : Configurer et dépanner les intégrations
Personnel informatique : Implémenter des intégrations API personnalisées
Responsables communication commerciale : Connectez les plateformes de messagerie et de communication commerciale
Avant de commencer
Exigences:
Compte Perkstar actif
Autorisations du propriétaire du compte ou de l'administrateur
Comptes actifs sur les plateformes tierces que vous souhaitez intégrer
Informations d'identification API ou accès d'autorisation pour les services tiers
Ce dont vous aurez besoin :
Selon le type d'intégration :
Pour les intégrations prédéfinies : Identifiants de connexion pour le service tiers
Pour les intégrations API : Votre clé Perkstar API (disponible dans cette rubrique)
Pour les intégrations personnalisées : Connaissances techniques ou assistance aux développeurs
Pour toutes les intégrations : Compréhension des données que vous souhaitez synchroniser
Comprendre les types d'intégration
Intégrations prédéfinies :
Connexion en un clic aux plateformes prises en charge
Installation guidée avec un minimum de connaissances techniques requises
Mappage automatique des champs de données
Exemples : CRM populaire, communication commerciale par courriel, systèmes de point de vente
Intégrations API :
Connexions personnalisées utilisant le API de Perkstar
Nécessite une mise en œuvre technique
Flexibilité totale dans le flux de données et l'automatisation
Exemples : systèmes propriétaires, applications personnalisées, flux de travail avancés
Accéder à la section Intégrations
Comment accéder aux intégrations
Depuis votre tableau de bord :
Connectez-vous à votre compte Perkstar
Cliquez sur Paramètres (icône ⚙️) dans le menu de gauche
Cliquez sur l'onglet Intégrations en haut de l'écran Paramètres
Note: L'écran Intégrations affiche tous les outils et options de gestion de l'intégration.
Disposition de l'écran des intégrations
La section Intégrations est organisée en quatre zones principales :
Tuile Plan et Capacité : Affiche votre forfait actuel et les limites d'intégration
Section clé API : Votre clé API unique pour des intégrations personnalisées
Intégrations actives : Liste des plateformes actuellement connectées
Ajouter une intégration : Plateformes disponibles auxquelles vous pouvez vous connecter
Comprendre votre capacité d'intégration
Limites du plan et de l'intégration
En haut de l'écran Intégrations, vous verrez une vignette affichant :
Plan d'abonnement actuel :
Votre niveau de forfait (Starter, Professionnel, Entreprise, etc.)
Allocation d'intégration pour votre régime
Utilisation de l'intégration :
Nombre d'intégrations actives actuellement connectées
Nombre total d'intégrations autorisées sur votre forfait
Emplacements d'intégration restants disponibles
Note: Exemple d'affichage : « Plan professionnel : 5 intégrations sur 10 utilisées » ou « Plan Starter : 2 intégrations sur 3 utilisées »
Ce qui compte comme une intégration
Chaque plateforme connectée compte pour une intégration dans votre limite :
Connexions de plateforme prédéfinies (CRM, communication commerciale par courriel, point de vente)
Webhooks actifs (si comptés séparément dans votre forfait)
Implémentations API personnalisées (peuvent compter différemment selon le plan)
Mise à niveau pour plus d'intégrations
Si vous avez atteint votre limite :
Examinez les intégrations actives et déconnectez celles inutilisées
Passez à un plan de niveau supérieur avec plus de capacité d'intégration
Contacter l'assistance à propos des packs d'intégration complémentaires (si disponibles)
Pour mettre à niveau :
Accédez à Paramètres → onglet Plan
Sélectionnez « Mettre à niveau votre forfait actuel »
Choisissez un forfait avec des limites d'intégration plus élevées
Travailler avec votre clé API
Qu'est-ce qu'une clé API ?
Infos : Votre clé API est un identifiant unique qui permet aux applications tierces et au code personnalisé d'accéder en toute sécurité aux données de votre compte Perkstar. Considérez-le comme un mot de passe spécifiquement destiné aux systèmes (et non aux humains) pour interagir avec votre compte par programmation.
Ce que les touches API permettent :
Intégrations personnalisées avec des systèmes propriétaires
Transferts de données automatisés entre plateformes
Synchronisation en temps réel des données clients et transactions
Création d'applications personnalisées sur Perkstar
Automatisation avancée au-delà des intégrations prédéfinies
Accéder à votre clé API
Pour afficher et copier votre clé API :
Accédez à l'onglet Paramètres → Intégrations
Localisez la vignette Clé API (sous les informations du plan)
Votre clé API s'affiche sous la forme d'une longue chaîne alphanumérique
Cliquez sur le bouton Copier pour copier la clé dans votre presse-papiers
À l'aide de votre clé API :
Collez la clé dans des applications tierces prenant en charge Perkstar API
Fournir aux développeurs créant des intégrations personnalisées
Inclure dans les requêtes API comme en-tête d'authentification
Ne partagez jamais publiquement et ne vous engagez jamais dans les systèmes de contrôle de version
Documentation API
Conseil: À côté de votre clé API, vous trouverez un lien vers la documentation API avec les points de terminaison disponibles, les exigences d'authentification, les formats de demande/réponse, les exemples de code, les limites de débit, les codes d'erreur et les meilleures pratiques de mise en œuvre.
Quand utiliser la documentation API :
Créer des intégrations personnalisées à partir de zéro
Dépannage des problèmes de connexion API
Comprendre les champs de données et les points de terminaison disponibles
Implémentation de workflows d'automatisation avancés
Former les développeurs sur les fonctionnalités du Perkstar API
Meilleures pratiques de sécurité des clés API
Protéger votre clé API :
Ne partagez jamais votre clé API :
Ne publiez pas sur des forums publics ou dans la documentation
Ne vous engagez pas dans les référentiels GitHub publics
Ne pas inclure dans le JavaScript côté client (visible par tous)
Ne partagez pas via des courriels ou des messages non sécurisés
Stockage sécurisé :
Stocker dans des variables d'environnement, non codées en dur dans le code
Utiliser des systèmes de gestion des secrets (AWS Secrets Manager, Azure Key Vault)
Limiter l'accès aux seuls membres de l'équipe qui en ont besoin
Document dans lequel la clé API est stockée pour référence de l'équipe
Contrôle d'accès :
Fournissez uniquement la clé API aux développeurs et systèmes de confiance
Utilisez des clés API distinctes pour différentes intégrations si possible
Révoquer et régénérer les clés si elles sont compromises
Vérifier régulièrement qui a accès aux clés API
Surveillance de l'utilisation :
Suivez les appels API pour détecter les activités inhabituelles
Configurer des alertes pour les modèles d'utilisation inattendus
Examinez périodiquement les journaux API
Enquêtez immédiatement sur tout accès non autorisé
Régénération de votre clé API
Quand régénérer :
La clé API a été compromise ou exposée publiquement
Le développeur ayant accès a quitté votre organisation
Activité API suspecte détectée
Rotation de sécurité régulière (tous les 6 à 12 mois recommandés)
Les intégrations doivent être reconstruites à partir de zéro
Comment régénérer :
Contactez l'assistance Perkstar (la régénération peut ne pas être disponible dans l'interface utilisateur)
Demander une nouvelle clé API
Mettre à jour toutes les intégrations actives avec une nouvelle clé
Testez toutes les intégrations pour vous assurer qu’elles fonctionnent toujours
Révoquer l'ancienne clé après avoir confirmé que la nouvelle clé fonctionne
Avertissement: La régénération de votre clé API rompra toutes les intégrations API existantes jusqu'à ce que vous les mettiez à jour avec la nouvelle clé. Planifiez cela soigneusement et mettez à jour les intégrations immédiatement.
Gestion des intégrations actives
Comprendre le tableau des intégrations actives
La section Intégrations actives affiche toutes les plateformes actuellement connectées sous forme de tableau avec les colonnes suivantes :
Nom:
Le nom de la plateforme ou du service
Exemples : "Mailchimp", "Salesforce", "Shopify", "Intégration CRM personnalisée"
ID d'intégration :
Identifiant unique pour cette intégration spécifique
Utilisé pour le dépannage technique et les références API
Généré automatiquement lors de la création de l'intégration
Date:
Quand l'intégration a été connectée pour la première fois
Vous aide à suivre depuis combien de temps l'intégration est active
Utile à des fins d’audit et d’examen
Statut:
État opérationnel actuel de l'intégration
Statuts courants :
Actif: L'intégration fonctionne normalement
Erreur: Problème de connexion ou échec de synchronisation
En pause : Intégration temporairement désactivée
Reconnexion requise : Autorisation expirée, doit être réauthentifiée
Détails:
Lien ou bouton pour afficher plus d'informations sur l'intégration
Cliquez pour voir la configuration détaillée, l'historique de synchronisation et les paramètres
Affichage des détails de l'intégration
Pour afficher des informations détaillées sur une intégration :
Localisez l'intégration dans le tableau Intégrations actives
Cliquez sur Détails dans la colonne la plus à droite
Consultez la page des détails de l'intégration
Les détails de l'intégration incluent généralement :
Paramètres de configuration et mappages de champs
Date et heure de la dernière synchronisation
Fréquence de synchronisation (en temps réel, horaire, quotidienne)
Données en cours de synchronisation (clients, transactions, cartes)
Journaux d'erreurs (si des problèmes sont survenus)
Métriques d’état de connexion
Options pour modifier, mettre en pause ou se déconnecter
Surveillance de l’intégrité de l’intégration
Signes d’une intégration saine :
Le statut indique "Actif"
L'heure de la dernière synchronisation est récente (dans les limites de la fréquence attendue)
Aucun message d'erreur dans les journaux
Les données apparaissent correctement dans les deux systèmes
Signes d'avertissement :
L'état indique « Erreur » ou « Reconnexion requise »
L'heure de la dernière synchronisation est obsolète (ancienne en heures ou en jours)
Messages d'erreur dans les journaux d'intégration
Données manquantes ou incohérentes entre les systèmes
Que faire si l'intégration affiche des erreurs :
Cliquez sur Détails pour afficher les messages d'erreur
Vérifiez les problèmes courants :
Autorisation expirée (réautoriser)
Limites de débit API dépassées (attendre et réessayer)
Identifiants invalides (mise à jour)
Service temporairement indisponible (vérifier le statut du tiers)
Suivez les étapes de dépannage dans le message d'erreur
Contactez l'assistance si l'erreur persiste
Suspendre une intégration
Quand suspendre une intégration :
Problèmes temporaires de qualité des données dans un système
Dépannage des problèmes de synchronisation
Apporter des modifications aux mappages ou paramètres de champs
Test des modifications de configuration de l'intégration
Pause saisonnière pour les périodes d'activité inactives
Comment faire une pause (si disponible) :
Ouvrir les détails de l'intégration
Cliquez sur le bouton Pause ou Désactiver
Confirmez la pause
L'intégration arrête la synchronisation mais la configuration est préservée
Pour reprendre :
Ouvrir les détails de l'intégration
Cliquez sur Reprendre ou Activer
L'intégration reprend la synchronisation à partir de l'état actuel
Déconnexion d'une intégration
Avant de vous déconnecter :
Exportez toutes les données dont vous avez besoin depuis l'intégration
Comprendre ce qui arrive aux données synchronisées (généralement conservées dans les deux systèmes)
Informer les membres de l'équipe qui comptent sur l'intégration
Documentez pourquoi vous vous déconnectez pour référence future
Comment se déconnecter :
Ouvrir la page de détails de l'intégration
Localisez le bouton Déconnecter, Supprimer ou Supprimer
Examiner l'avertissement concernant l'impact de la déconnexion
Confirmer la suppression
Intégration supprimée du tableau Intégrations actives
Après déconnexion :
L'intégration ne compte plus dans la limite de votre forfait
Les données arrêtent la synchronisation entre les systèmes
Les données historiques restent généralement dans les deux systèmes
Vous pourrez vous reconnecter plus tard si nécessaire (peut nécessiter une reconfiguration)
Ajout de nouvelles intégrations
Affichage des intégrations disponibles
Infos : La section Ajouter une intégration affiche toutes les plates-formes et services prenant en charge les connexions prédéfinies avec Perkstar.
Catégories d'intégration courantes :
Gestion de la Relation Client (CRM) :
Salesforce, HubSpot, Zoho CRM, Pipedrive
Synchronisez les profils clients et l’historique des interactions
Vue client unifiée sur toutes les plateformes
communication commerciale par courriel :
Mailchimp, Contact constant, Klaviyo, SendGrid
Ajoutez automatiquement des clients fidèles aux listes de diffusion
Déclenchez des campagnes basées sur l'activité de fidélité
Segmentez les clients par niveau de fidélité ou par points
Point de vente (système de caisse) :
Square, Clover, Pain grillé, Lightspeed
Attribution automatique de points de fidélité au moment du paiement
Synchronisation des transactions en temps réel
Identification du client à la caisse
Plateformes de commerce électronique :
Shopify, WooCommerce, BigCommerce, Magento
récompenses de fidélisation pour les achats en ligne
Synchronisation des comptes clients
Suivi de fidélité unifié en ligne et en magasin
Analyse et intelligence d'affaires :
Google Analyses, Tableau, Power BI
Données de fidélité dans des tableaux de bord complets
Suivi ROI et valeur à vie du client
Mesures combinées de fidélité et d’affaires
Comptabilité et Finance :
QuickBooks, Xéro, FreshBooks
Suivi des revenus du programme de fidélisation
Catégorisation des dépenses pour les coûts de fidélité
Intégration des rapports financiers
Connecter une nouvelle intégration
Processus de connexion étape par étape :
1. Accédez à la section Ajouter une intégration :
Faites défiler vers le bas de l’écran Intégrations
Parcourir les plateformes disponibles
2. Sélectionnez la plateforme à connecter :
Trouvez la plateforme que vous souhaitez intégrer
Cliquez sur le bouton Connecter dans la ligne de la plateforme
3. Autorisez la connexion :
Vous serez redirigé vers la page de connexion de la plateforme tierce
Connectez-vous avec vos identifiants pour cette plateforme
Examinez attentivement les demandes d’autorisation
Cliquez sur Autoriser, Autoriser ou Connecter
4. Configurez les paramètres d'intégration :
Sélectionnez les données à synchroniser (clients, transactions, cartes)
Choisissez la fréquence de synchronisation (en temps réel, horaire, quotidienne)
Mapper les champs de données entre les systèmes (courriel, téléphone, identifiant client)
Configurer toutes les options spécifiques à la plate-forme
5. Testez l'intégration :
Déclencher un test de synchronisation (bouton généralement fourni)
Vérifier que les données apparaissent correctement dans les deux systèmes
Vérifiez qu'aucune erreur ne se produit
6. Activez l'intégration :
Cliquez sur Enregistrer ou Activer
L'intégration est déplacée vers le tableau Intégrations actives
La synchronisation automatique commence
Cartographie des champs
Infos : La cartographie des champs connecte les champs de données entre Perkstar et la plate-forme tierce, garantissant ainsi le flux d'informations vers les bons endroits.
Mappages de champs courants :
Perkstar « courriel client » → CRM « Adresse courriel »
Perkstar "Numéro de téléphone" → communication commerciale par courriel "Téléphone portable"
Perkstar "Nom du client" → système de caisse "Nom complet du client"
Perkstar « Solde de points » → CRM « Points de fidélité »
Perkstar "Date de la dernière visite" → Analytics "Dernière transaction"
Meilleures pratiques pour la cartographie des champs :
Faites correspondre soigneusement les champs (un mappage incorrect entraîne des incohérences dans les données)
Utilisez des identifiants client cohérents (courriel ou téléphone) sur tous les systèmes
Testez avec des exemples de données avant d'activer
Documentez votre cartographie de terrain pour référence de l'équipe
Examiner le mappage lorsque les champs de l'un ou l'autre système changent
Options de fréquence de synchronisation
Synchronisation en temps réel :
Les données sont transférées immédiatement lorsque des changements se produisent
Idéal pour : intégrations de points de vente, données client en direct
Une utilisation plus élevée du API peut entraîner des coûts ou des limites tarifaires.
Synchronisation horaire :
Les données sont mises à jour toutes les heures
Idéal pour : la plupart des opérations commerciales, approche équilibrée
Bon compromis entre fraîcheur et utilisation du API
Synchronisation quotidienne :
Les données sont mises à jour une fois par jour à une heure programmée
Idéal pour : rapports historiques, données moins sensibles au facteur temps
Utilisation minimale de API, adaptée aux grands ensembles de données
Synchronisation manuelle :
Vous déclenchez la synchronisation en cas de besoin
Idéal pour : tests, dépannage, mises à jour peu fréquentes
Contrôle complet, pas d'appels automatiques API
Cas d'utilisation de l'intégration par type d'entreprise
Magasins de détail
Intégrations recommandées :
Système de point de vente (Square, Clover) :
Points de fidélité automatiques à la caisse
Identification du client par téléphone ou courriel
Synchronisation de l'historique des transactions
communication commerciale par courriel (Mailchimp) :
courriels de bienvenue pour les nouveaux membres fidélité
Campagnes de réengagement pour les clients inactifs
Offres d'anniversaire et promotions spéciales
CRM (Salesforce) :
Historique complet des achats des clients
Visibilité du niveau de fidélité pour le personnel commercial
Sensibilisation ciblée basée sur le comportement d'achat
Restaurants et cafés
Intégrations recommandées :
Système de point de vente (Toast, Square) :
Points pour les achats de nourriture et de boissons
Intégration de la fidélité des commandes en ligne
Allocation de fidélité sur facture fractionnée
Analyse Google :
Suivre l'impact du programme de fidélisation sur les revenus
Analyse de la valeur du client à vie
Mesure de l'efficacité des campagnes
Comptabilité (QuickBooks) :
Catégorisation des revenus (fidélité vs régulier)
Suivi des dépenses pour les coûts du programme de fidélisation
Rapports financiers
Salons et spas
Intégrations recommandées :
Système de réservation (Mindbody, Vagaro) :
Points pour les rendez-vous pris
Intégration avec l'historique des services
Points de fidélité automatiques à l'enregistrement
communication commerciale par courriel (contact constant) :
Rappels de rendez-vous avec solde fidélité
Campagnes de promotion des services
Offres d'anniversaire et d'anniversaire
CRM (HubSpot) :
Suivi des préférences du service client
Visibilité du niveau de fidélité pour un service personnalisé
Automatisation du suivi après rendez-vous
Entreprises de commerce électronique
Intégrations recommandées :
Plateforme de commerce électronique (Shopify, WooCommerce) :
Points pour les achats en ligne
Remises sur le niveau de fidélité à la caisse
Synchronisation des comptes clients
communication commerciale par courriel (Klaviyo) :
Récupération de panier abandonné avec incitations à la fidélité
Campagnes post-achat
Segmentation de la clientèle VIP
Analyse (Google Analyse) :
Suivi du programme de fidélisation ROI
Valeur à vie du client par segment
Analyse d'impact du taux de conversion
Meilleures pratiques pour la gestion de l'intégration
Stratégie d'intégration
Commencez par des intégrations à fort impact :
Identifiez les intégrations qui vous feront gagner le plus de temps
Donnez la priorité aux systèmes que vous utilisez le plus fréquemment
Connectez une intégration à la fois pour éviter toute surcharge
Testez minutieusement avant d’ajouter la prochaine intégration
Planifier la qualité des données :
Assurez-vous que les données client sont propres avant de les intégrer
Établir des normes de données (format du nom, format du téléphone, etc.)
Supprimez les doublons dans tous les systèmes avant la synchronisation
Documenter les règles de qualité des données pour l'équipe
Tenez compte de la direction du flux de données :
Perkstar → Autre système (exporter les données de fidélité)
Autre système → Perkstar (importer les données client)
Bidirectionnel (les deux systèmes se mettent à jour)
Choisissez en fonction du système qui constitue la « source de vérité »
Entretien régulier
Contrôles hebdomadaires :
Examiner les intégrations actives pour connaître les statuts d'erreur
Vérifier que les heures de synchronisation récentes sont actuelles
Vérifier les journaux d'intégration pour les avertissements
Testez les intégrations critiques avec des exemples de transactions
Audits mensuels :
Examinez toutes les intégrations actives : sont-elles toujours nécessaires ?
Déconnectez les intégrations inutilisées pour libérer de la capacité
Mettez à jour tous les identifiants qui expirent bientôt
Vérifier la qualité des données dans les deux systèmes
Bilans trimestriels :
Évaluer l'intégration ROI (temps gagné, erreurs évitées)
Rechercher de nouvelles opportunités d'intégration
Mettre à jour les mappages de champs si les structures de données ont changé
Vérifier la sécurité (rotation des clés API, audit des accès)
Coordination d'équipe
Documentation:
Tenir à jour la liste de toutes les intégrations actives et leurs objectifs
Cartographie des champs de document pour chaque intégration
Notez qui est responsable de chaque intégration
Gardez une trace des étapes de dépannage qui ont fonctionné
Gestion des accès :
Limiter la gestion de l’intégration au personnel technique
Ne partagez pas les clés API avec toute l'équipe
Fournir un accès en lecture seule lorsque cela est possible
Créer un processus pour demander de nouvelles intégrations
Changer de communication :
Informer l'équipe avant d'ajouter ou de supprimer des intégrations
Tester les modifications pendant les périodes de faible trafic
Avoir un plan de restauration si l'intégration pose des problèmes
Documenter toutes les modifications pour la piste d'audit
Confidentialité et conformité des données
Considérations relatives à la confidentialité :
Synchronisez uniquement les données nécessaires à des fins d'intégration
Consultez la politique de confidentialité de la plateforme tierce
Assurez-vous que les intégrations sont conformes au RGPD, au CCPA, etc.
Obtenez le consentement du client pour le partage de données si nécessaire
Sécurité:
Utiliser des plateformes avec de solides pratiques de sécurité
Activer l'authentification à deux facteurs sur les comptes intégrés
Examinez régulièrement les autorisations d’intégration
Révoquer l'accès lorsque les membres de l'équipe quittent
Conservation des données :
Comprendre combien de temps les plateformes tierces conservent les données
Sachez ce qui arrive aux données si vous déconnectez l'intégration
Planifier la suppression des données si la réglementation l'exige
Exportez les données critiques avant de vous déconnecter
Dépannage des intégrations
L'intégration affiche le statut « Erreur »
Dépannage étape par étape :
Cliquez sur Détails pour afficher le message d'erreur
Lire la description spécifique de l'erreur
Notez le code d'erreur s'il est fourni
Causes courantes et solutions :
"Autorisation expirée" : Réautorisez l'intégration en cliquant sur Reconnecter
« Limite de débit API dépassée » : Attendez que la limite de débit soit réinitialisée (généralement toutes les heures ou tous les jours)
"Identifiants invalides" : Mettre à jour la clé API ou les informations de connexion
"Service non disponible": Vérifiez la page d'état de la plate-forme tierce pour les pannes
Testez la connexion :
Essayez la synchronisation manuelle (si disponible)
Vérifiez que vous pouvez vous connecter séparément à une plate-forme tierce
Vérifiez si la plate-forme tierce rencontre des problèmes
Contacter l'assistance :
Si l'erreur persiste après un dépannage de base
Fournir l'ID d'intégration, le message d'erreur et l'horodatage
Décrivez ce que vous avez déjà essayé
Données non synchronisées
Problème : l'intégration affiche « Actif » mais les données n'apparaissent pas dans un autre système
Étapes de dépannage :
Vérifiez le timing de synchronisation :
À quand remonte la dernière synchronisation ? (Voir dans les détails de l'intégration)
Qu'est-ce que la fréquence de synchronisation ? (En temps réel, horaire, quotidien)
En temps différé, attendez la prochaine synchronisation planifiée
Vérifiez le mappage des champs :
Les champs sont-ils correctement mappés ?
Y a-t-il des champs vides qui devraient contenir des données ?
Essayez de synchroniser un enregistrement de test avec des données complètes
Vérifiez les filtres ou les conditions :
Certaines intégrations synchronisent uniquement les enregistrements répondant à certains critères
Vérifier les paramètres d'intégration des filtres
Assurez-vous que les données de test répondent aux conditions de filtrage
Recherchez les limites de taux :
Avez-vous dépassé les limites d'appels API ?
Vérifiez les journaux d'intégration pour les messages de limitation
Réduisez la fréquence de synchronisation si vous atteignez les limites
Vérifiez les autorisations :
L'intégration a-t-elle l'autorisation d'écrire des données ?
Vérifier les autorisations des utilisateurs de la plateforme tierce
Réautoriser l'intégration pour actualiser les autorisations
Dossiers clients en double
Problème : le même client apparaît plusieurs fois dans un ou les deux systèmes
Causes :
Identifiants client incohérents (courriel ou téléphone)
Différents formats de noms (John Smith contre J. Smith)
Plusieurs comptes dans un seul système
Problèmes de sensibilité à la casse (john@courriel.com vs John@courriel.com)
Solutions :
Standardisez les critères de correspondance :
Choisissez l'courriel ou le téléphone comme identifiant principal
Configurer l'intégration pour qu'elle corresponde à ce champ
Utiliser le même format dans les deux systèmes
Nettoyez les doublons existants :
Fusionner les doublons dans les deux systèmes avant la synchronisation
Utilisez les outils de déduplication si disponibles
Exporter, nettoyer et réimporter si nécessaire
Évitez les futurs doublons :
Appliquer des identifiants uniques dans les deux systèmes
Standardiser la saisie des données (courriels en minuscules, format de téléphone cohérent)
Configurer des alertes de détection de doublons
Intégration connectée mais ne fonctionne pas
Problème : L'intégration se connecte correctement mais ne fonctionne pas comme prévu
Dépannage :
Vérifiez la configuration de l'intégration :
Synchronisez-vous les bons types de données ?
La synchronisation bidirectionnelle est-elle correctement configurée ?
Les déclencheurs de mise à jour sont-ils correctement définis ?
Test avec des données connues :
Créer un client test dans Perkstar
Vérifiez qu'il apparaît dans le système tiers
Apportez des modifications et vérifiez qu'elles sont synchronisées
Supprimer les données de test après vérification
Consultez la documentation d'intégration :
Consultez le guide d'intégration de Perkstar pour une plate-forme spécifique
Consultez la documentation d'intégration de la plateforme tierce
Recherchez les problèmes ou limitations connus
Vérifiez la clé et les autorisations API :
Confirmez que la clé API est correcte (copiez-collez soigneusement)
Vérifiez que la clé API n'a pas été régénérée
Assurez-vous que la clé API dispose des autorisations nécessaires
Foire aux questions
Combien d’intégrations puis-je connecter ?
Le nombre dépend de votre plan d'abonnement. La limite d'intégration de votre plan est affichée en haut de l'écran Intégrations. Les forfaits Starter autorisent généralement 2 à 3 intégrations, tandis que les niveaux supérieurs en autorisent 10 à 20 ou plus.
Les intégrations sont-elles prises en compte dans les limites de mes clients ou de ma carte ?
Non. Les limites d’intégration sont distinctes de la taille de votre base de données clients et des limites de votre carte de fidélisation. Cependant, les intégrations peuvent synchroniser les clients dans Perkstar, ce qui serait pris en compte dans votre limite de clients.
Puis-je utiliser ma clé API avec plusieurs intégrations ?
Oui. Votre clé API peut être utilisée pour plusieurs intégrations personnalisées et outils tiers. Chaque connexion utilisant la même clé API s'authentifiera en tant que votre compte.
Qu'arrive-t-il à mes données si je déconnecte une intégration ?
La déconnexion arrête la synchronisation future, mais les données déjà présentes dans les deux systèmes demeurent généralement. Par exemple, les clients synchronisés depuis votre CRM resteront dans Perkstar. Vérifiez toujours avec la documentation d'intégration spécifique avant de vous déconnecter.
Puis-je reconnecter une intégration après une déconnexion ?
Oui. Vous pouvez vous reconnecter à tout moment en cliquant à nouveau sur le bouton Connecter. Vous devrez reconfigurer les paramètres et les mappages de champs, mais l'intégration fonctionnera normalement une fois reconnectée.
Ma clé API est-elle la même que mon mot de passe de connexion ?
Non. Votre clé API est spécifiquement destinée aux connexions de système à système, et non à la connexion à Perkstar. Ne partagez jamais votre clé API publiquement, mais vous pouvez la fournir à des développeurs de confiance ou à des applications tierces.
À quelle fréquence les données sont-elles synchronisées entre les systèmes ?
La fréquence de synchronisation dépend de la configuration de l'intégration. Les options incluent généralement le temps réel (immédiat), horaire, quotidien ou manuel. Vous pouvez généralement ajuster la fréquence dans les paramètres d'intégration.
Puis-je personnaliser les données synchronisées ?
La plupart des intégrations vous permettent de sélectionner les types de données à synchroniser (clients, transactions, cartes de fidélisation, etc.) et la manière dont les champs sont mappés entre les systèmes. Les options de configuration varient selon l'intégration.
Que dois-je faire si une intégration utilise d’anciennes données ?
Déclenchez une synchronisation manuelle pour actualiser les données. Dans les détails de l'intégration, recherchez « Sync Now » ou un bouton similaire. Si la synchronisation manuelle ne résout pas le problème, déconnectez et reconnectez l'intégration pour forcer la resynchronisation complète.
Puis-je voir un historique des données synchronisées ?
La plupart des intégrations fournissent des journaux de synchronisation dans la vue Détails, indiquant quand les synchronisations ont eu lieu, combien d'enregistrements ont été transférés et les erreurs éventuelles. Le niveau de détail du journal varie selon l’intégration.
Ai-je besoin de connaissances techniques pour mettre en place des intégrations ?
Les intégrations prédéfinies (bouton Connecter) nécessitent des connaissances techniques minimales : il suffit de se connecter aux informations d'identification pour l'autre plate-forme. Les intégrations API personnalisées nécessitent des connaissances en programmation ou l'assistance d'un développeur.
Puis-je intégrer une plateforme qui ne figure pas dans la liste Ajouter une intégration ?
Oui, en utilisant la clé API. Si une plateforme prend en charge les API REST ou les webhooks, vous pouvez créer une intégration personnalisée. Reportez-vous à la documentation Perkstar API pour obtenir des conseils ou contactez un développeur.
Que se passe-t-il si je régénère ma clé API ?
Toutes les intégrations utilisant l'ancienne clé API cesseront de fonctionner immédiatement. Vous devez mettre à jour chaque intégration personnalisée avec la nouvelle clé API. Les intégrations prédéfinies (basées sur OAuth) ne sont généralement pas affectées.
Dans quelle mesure les intégrations sont-elles sécurisées ?
Les intégrations utilisent des pratiques de sécurité standard du secteur, notamment le cryptage HTTPS, l'authentification OAuth 2.0 et la protection par clé API. Suivez toujours les meilleures pratiques de sécurité : ne partagez pas les clés API, utilisez des mots de passe forts et auditez régulièrement les intégrations.
Plusieurs membres de l’équipe peuvent-ils gérer les intégrations ?
Les propriétaires de compte et les administrateurs peuvent généralement accéder à la section Intégrations. Il est préférable de limiter la gestion de l'intégration au personnel technique qui comprend les implications de la connexion et de la déconnexion des systèmes.
Conseil: Besoin d'aide supplémentaire ? Contactez l'assistance Perkstar pour obtenir de l'aide sur des intégrations spécifiques, la documentation API, le dépannage des problèmes de connexion ou des recommandations pour votre type d'entreprise.