# Conversion ## Conversions L'écran **Conversions** centralise les *événements opérationnels et marketing* déclenchés dans Hablla — création/mise à jour d'enregistrements, changements de statut, actions sur des cartes, entre autres.\ Il fonctionne comme un **journal auditable** pour l'observabilité et le dépannage : vous suivez la chronologie, appliquez des filtres et pouvez inspecter le **payload brut (JSON)** de chaque événement. > ⚠️ La liste des événements évolue continuellement. De nouveaux types peuvent être ajoutés et certains noms peuvent changer selon les améliorations du produit.
### Comment lire la timeline Chaque ligne affiche : * **Type d'événement** (ex. : *Conversion*, *A créé une personne*). * **Contexte/entité** (ex. : personne, carte, utilisateur, organisation). * **Message résumé** avec ce qui s'est passé. * **Date et heure** *(horodatage)*. * **Actions**: * **JSON** → ouvre le payload complet de l'événement. * **Voir les données mises à jour** / **Données anciennes** → lorsqu'il y a une comparaison entre avant/après. *** ### Filtres Utilisez le bouton **Filtres** (coin supérieur droit) pour affiner la timeline par : * **Type d'événement** * **Période (date et heure)** * **Origine** (lorsque applicable) * **Entité** (personne, carte, etc.) #### Période (Date et Heure) Permet de restreindre les événements par intervalle temporel **précis**, en combinant date et horaire. Champs : * **Date de début** et **Heure de début** * **Date de fin** et **Heure de fin** Comportement : * L'intervalle est **inclusif** : les événements avec un horodatage exactement à **l'heure de début/fin** sont également inclus dans le résultat. * Si vous **ne** remplissez pas les heures : * **Heure de début** prend par défaut `00:00` * **Heure de fin** prend par défaut `23:59` * La validation empêche **date/heure de fin antérieure** à la début. * Le fuseau utilisé est le **fuseau configuré dans l'espace de travail**. Exemples rapides : * « Aujourd'hui, de 09:00 à 12:00 » → trouvez les pics matinaux de conversions. * « Hier, 18:00 jusqu'à Aujourd'hui, 09:00 » → surveillez les effets des campagnes nocturnes. * « Les 7 derniers jours complets » → **Date de début** = aujourd'hui−7, **Heure de début** = `00:00`; **Date de fin** = aujourd'hui, **Heure de fin** = `23:59`. > Astuce : combinez **Type d'événement + Période** pour accélérer les diagnostics des campagnes et intégrations. *** ### Types d'événements (affichés dans cet écran) Ci-dessous, les événements indiqués pour cette page. De nouveaux événements peuvent apparaître au fil du temps. | Événement | Ce que cela signifie en pratique | Quand utiliser | | ---------------------------- | ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | | **Conversion** | Enregistrement d'une conversion (ex. : formulaire, parcours, short-link avec UTM) lié à une personne/lead. | Mesurer la performance, l'attribution de campagne et le parcours d'acquisition. | | **A créé une personne** | Un nouveau contact a été ajouté à la base. | Confirmer l'ingestion des leads (feuille de calcul, API, formulaire, webhook, etc.). | | **A modifié les données de** | Les données d'inscription/attributs d'une personne ont été mis à jour. | Auditer l'origine des mises à jour et comprendre *quand* et *qui* a modifié un champ critique. | | **A supprimé une personne** | Un contact a été supprimé. | Suivre les nettoyages de base, RGPD/consentement ou ajustements par lot. | | **A bloqué** | Personne/entité marquée comme bloquée pour un flux/canal. | Examiner pourquoi un contact a cessé de recevoir des communications. | | **A débloqué** | Suppression du statut de blocage. | Rétablir l'éligibilité aux campagnes et flux. | > Autres messages que vous pouvez voir (en fonction de votre espace de travail) : **a mis à jour/déplacé la carte**, **tâche créée**, **a supprimé une étiquette**, **données du dictionnaire mises à jour**. Ces événements suivent la même logique : résumé + horaire + action pour ouvrir le JSON. *** ### Inspection du JSON de l'événement Cliquez sur **JSON** pour ouvrir le payload brut. C'est essentiel pour : * Valider **variables** et **IDs** utilisés dans les flux/intégrations. * Vérifier **avant/après** d'une mise à jour. * Reproduire des scénarios dans des environnements de test. > Bonnes pratiques : en ouvrant le JSON, recherchez `id`/`external_id`, `origin`, `timestamp`, `before`/`after` et les champs sensibles métier (ex. : `stage`, `labels`, `owner`). *** ### Cas d'utilisation recommandés * **Attribution de campagne** : validez si un *Conversion* provenait d'un short-link avec la bonne UTM. * **Qualité des données** : auditez les mises à jour en masse (ex. : « A modifié les données de »). * **Support et CX** : expliquez pourquoi un contact **a bloqué/débloqué** et quand cela s'est produit. * **Opération commerciale** : suivez *mouvements de cartes* et *création de tâches* liées à la personne. *** ### Limitations et évolution * La nomenclature et l'ensemble des événements peuvent changer avec de nouvelles versions. * Certains événements dépendent des permissions et des intégrations activées dans l'espace de travail. *** #### Résumé L'écran **Conversions** est votre **panneau d'audit** pour le marketing conversationnel et les opérations.\ Utilisez **filtres** pour isoler ce qui vous intéresse, **ouvrez le JSON** pour voir la granularité technique et garantissez la traçabilité de bout en bout — de l'origine de la conversion au statut du contact.