Depannage Live Data
En bref
Ce guide couvre les problemes courants lies aux connecteurs Live Data : erreurs de connexion, echecs de synchronisation, donnees manquantes et problemes de performance.
Problemes de connexion
La source affiche "Deconnectee"
Causes possibles :
- Identifiants invalides ou expires
- URL de la source inaccessible
- Autorisation OAuth revoquee
Solutions :
- Verifiez les identifiants dans Live Data > Votre source > Configuration.
- Testez la connexion avec le bouton Tester la connexion.
- Si la source utilise OAuth, relancez le flux d'autorisation depuis la configuration du connecteur.
Erreur "Connexion refusee"
Causes possibles :
- L'API de la source est hors service
- Un pare-feu bloque la connexion sortante
Solutions :
- Verifiez la disponibilite de la source sur son site de status.
- Verifiez que votre reseau autorise les connexions sortantes vers l'URL de la source.
- Si vous utilisez un proxy, verifiez sa configuration.
Erreur "Timeout de connexion"
Causes possibles :
- La source met trop de temps a repondre
- Latence reseau elevee
Solutions :
- Reessayez apres quelques minutes — le probleme peut etre temporaire.
- Verifiez les temps de reponse de la source sur son tableau de bord.
Problemes de synchronisation
La synchronisation echoue
Causes possibles :
- Le schema de la source a change (nouvelles colonnes, types modifies)
- La source retourne des donnees dans un format inattendu
- Le quota de requetes de la source est epuise
Solutions :
- Consultez le detail de l'erreur dans Live Data > Votre source > Logs.
- Si le schema a change, relancez une decouverte du schema depuis la configuration.
- Verifiez les quotas sur le tableau de bord de la source.
Donnees manquantes apres synchronisation
Causes possibles :
- La source filtre certaines donnees (pagination incomplete)
- Le mapping des colonnes est incorrect
- Les nouveaux champs ne sont pas mappes
Solutions :
- Verifiez le nombre de lignes dans la source d'origine.
- Consultez le mapping dans Live Data > Votre source > Mapping.
- Relancez une synchronisation complete via le bouton Actualiser.
Donnees en double
Causes possibles :
- La deduplication n'est pas configuree
- La cle primaire n'est pas definie
Solutions :
- Verifiez que la colonne de cle primaire est correctement configuree dans le mapping.
- Lancez une synchronisation complete (mode reset) pour reinitialiser les donnees.
Problemes par connecteur
Google Sheets
| Probleme | Cause | Solution |
|---|---|---|
| "Spreadsheet not found" | ID de feuille incorrect ou supprime | Verifiez l'URL du Google Sheet dans la configuration |
| "Insufficient permissions" | L'acces au Sheet a ete revoque | Relancez l'autorisation OAuth |
| Colonnes vides | Colonnes sans en-tete dans la premiere ligne | Ajoutez des en-tetes a toutes les colonnes |
Airtable
| Probleme | Cause | Solution |
|---|---|---|
| "Invalid API key" | Token personnel expire | Regenerez un token dans les parametres Airtable |
| "Base not found" | ID de base incorrect | Copiez l'ID depuis l'URL de votre base Airtable |
| Champs formule vides | Les formules Airtable ne sont pas evaluees | Utilisez le champ resultat au lieu du champ formule |
HubSpot
| Probleme | Cause | Solution |
|---|---|---|
| "Scope missing" | Scopes OAuth insuffisants | Relancez l'autorisation avec les scopes requis |
| Contacts incomplets | Limite de l'API HubSpot (100 contacts/page) | La pagination est geree automatiquement, attendez la fin de la sync |
Webhooks
| Probleme | Cause | Solution |
|---|---|---|
| Webhook non recu | URL incorrecte ou endpoint inactif | Verifiez l'URL dans la source emettrice |
| Signature invalide | Secret HMAC incorrect | Verifiez que le secret correspond entre la source et Ontologie |
| Payload rejete | Format JSON invalide | Verifiez que le payload est un JSON valide avec Content-Type correct |
Journaux de synchronisation
Pour consulter les logs detailles d'une source :
- Allez dans Live Data.
- Cliquez sur la source concernee.
- Ouvrez l'onglet Logs.
Les logs affichent pour chaque synchronisation :
- Horodatage de debut et de fin
- Nombre de lignes traitees
- Erreurs eventuelles avec detail
Voir aussi
- Live Data — Vue d'ensemble des connecteurs
- Monitoring — Surveillance des sources
- Diagnostic — Outil de diagnostic integre
- Erreurs courantes — Codes HTTP
Besoin d'aide ?
Ecrivez-nous : Support et contact.