Passer au contenu principal

Exporter les données des coéquipiers et des journaux d'activité vers un stockage cloud

Utilisez cet article pour inclure les données des coéquipiers et des journaux d'activité dans vos exports programmés vers le stockage cloud — afin de pouvoir effectuer des revues d'accès, une surveillance de la sécurité et des workflows de gouvernance ...

Écrit par Yasser Aboelgheit

Exportez vos Teammates et Teammate activity logs vers Amazon S3, Google Cloud Storage ou Azure Blob Storage en parallèle de vos données de conversations.

Les exports de données programmés couvraient auparavant uniquement les conversations. Vous pouvez désormais choisir quels objets de données chaque export programmé inclut, et faire livrer les données des coéquipiers vers votre propre stockage cloud selon le même calendrier que le reste.

Utilisez-le pour :

  • Revues d'accès et preuves d'audit — qui a accès à votre espace de travail, et ce qui a changé

  • Surveillance de la sécurité — connexions, modifications des permissions et changements SSO dans votre propre SIEM (système de gestion des informations et des événements de sécurité)

  • Gouvernance des données et conservation en parallèle de vos données de conversation


Quels objets de données puis-je exporter ?

Le tableau ci-dessous décrit chaque objet de données : ce qu'il contient et la fréquence d'exportation.

Objet de données

Contenu

Mode d'exportation

Conversations

Conversations et leurs parties, y compris les auteurs, affectations, tags et attributs personnalisés.

Nouvelles conversations et mises à jour à chaque exécution

Teammates

Chaque coéquipier dans l'espace de travail, avec son nom, adresse e-mail et rôle.

Un instantané complet à chaque exécution

Teammate activity logs

Un enregistrement de l'activité des comptes des coéquipiers, comme les connexions, modifications des permissions et changements SSO.

Nouvelle activité depuis la dernière exécution

Chaque objet de données s'exporte indépendamment selon votre calendrier existant et est livré dans le même bucket, dans un dossier séparé par objet. Les exécutions sont suivies séparément, donc un problème avec un objet de données n'arrêtera pas les autres.

Les données des coéquipiers s'exportent au format JSON ou JSONL (JSON Lines — un format où chaque ligne est un objet JSON distinct, utile pour le streaming de grands ensembles de données), en utilisant le même schéma que les points de terminaison List all admins et List all activity logs de la Data API version configurée pour votre export.

Où les données exportées des coéquipiers sont-elles stockées dans mon bucket ?

Les données des coéquipiers sont écrites dans un dossier propre par objet de données, elles ne se mélangent donc jamais avec vos fichiers de conversation. Vos fichiers de conversation existants ne bougent pas — ils restent exactement là où ils sont aujourd'hui, à la racine de votre dossier d'export.

Les données des coéquipiers sont stockées dans des sous-dossiers dédiés au sein de votre bucket d'export existant, séparés de vos fichiers de conversation, comme illustré ci-dessous.

Dossier

Contenu

<folder_name>/

Vos fichiers de conversation, inchangés

<folder_name>/admins/

Coéquipiers

<folder_name>/admin_activity_logs/

Journaux d'activité des coéquipiers

Si vous avez activé Export data dated folders, le dossier daté se trouve à l'intérieur du dossier de l'objet de données, et non l'inverse :

Dossiers datés

Exemple de chemin

Désactivé

<folder_name>/admins/2026-08-19T13-00-00Z-2026-08-19T14-00-00Z-90210.json

Activé

<folder_name>/admins/2026-08-19/2026-08-19T13-00-00Z-2026-08-19T14-00-00Z-90210.json

Si vous utilisez un glob sur votre préfixe de conversation dans un pipeline en aval, ce modèle continue de fonctionner sans changement et ne commencera pas à inclure les fichiers des coéquipiers.

Noms de fichiers suivent la même convention que les exports de conversation — <batch start>-<batch end>-<batch id> en UTC, avec : remplacé par -, et une extension .json ou .jsonl correspondant à votre Format de sortie.

Nombre de fichiers par exécution :

  • Teammates — un fichier par exécution, contenant toute la liste.

  • Teammate activity logs — un ou plusieurs fichiers par exécution, divisés en lots comme les conversations.

  • La date dans le nom du dossier est la date à laquelle l'export a été exécuté, pas la date à laquelle l'activité a eu lieu.


Que dois-je avoir avant d'exporter les données des coéquipiers ?

  • Permissions. Vous devez avoir à la fois Gérer les coéquipiers et Voir tous les coéquipiers et détails de l'équipe. Sans ces deux permissions, les objets de données des coéquipiers ne sont pas proposés.

  • Destination. Les objets de données des coéquipiers sont disponibles pour AWS S3, Google Cloud Storage et Azure Blob Storage. Ils ne sont pas disponibles pour les destinations Snowflake Data Share.

  • Version de l'API Data. Les journaux d'activité des coéquipiers nécessitent une version récente de la Data API version. Les exports fixés à une version plus ancienne ne peuvent pas les inclure.


Comment exporter les données des coéquipiers vers un stockage cloud

1. Allez dans Paramètres > Données > Importations & exportations > Exporter les données et ouvrez votre export de données existant, ou sélectionnez Nouvel export de données.

Si vous créez un nouvel export, suivez Exporter les données des conversations vers un stockage cloud pour configurer votre Data API version, Format de sortie, les options de dossier, le bucket de destination et le planning en premier.

2. Dans la section Objets de données, cochez les objets de données que vous souhaitez exporter. Vous pouvez choisir n'importe quelle combinaison.

Section des objets de données montrant les cases à cocher Conversations, Coéquipiers et journaux d'activité des coéquipiers

Un export nécessite au moins un objet de données. La dernière case cochée restante est désactivée — cochez un autre objet de données avant de la décocher.

3. Faites défiler jusqu'en bas de la page et cliquez sur Mettre à jour (ou Démarrer l'export de données pour un nouvel export).

4. Une boîte de dialogue de confirmation apparaît chaque fois que les données des coéquipiers commencent ou cessent de circuler. Il existe deux versions selon que vous ajoutez ou supprimez un objet de données — lisez la boîte de dialogue et cliquez sur Enregistrer les modifications.

Lorsque vous ajoutez des données de coéquipiers, la boîte de dialogue confirme qu'elles seront incluses à partir de la prochaine exécution planifiée, qu'il s'agit de données personnelles (noms, adresses e-mail et rôles, ainsi que l'activité du compte comme les connexions, les changements d'autorisations et les modifications SSO), et qu'elles sont écrites dans un stockage que vous contrôlez — donc Intercom ne peut pas les rappeler ou les supprimer après leur exportation.

Boîte de dialogue « Démarrer l'export des données des coéquipiers ? » expliquant que les données des coéquipiers sont des données personnelles écrites dans un stockage contrôlé par le client que Intercom ne peut pas rappeler ou supprimer après l'exportation

Lorsque vous supprimez un objet de données, la boîte de dialogue explique ce que vous pouvez récupérer :

  • Journaux d'activité des coéquipiers — si vous les réactivez dans les quelques jours, le prochain export rattrapera le retard. Après cela, seul un export historique demandé à Intercom peut combler le vide.

  • Coéquipiers — chaque exécution exporte la liste complète, donc la réactivation restaure les données complètes sans lacune permanente.

Un enregistrement qui ajoute et supprime des objets de données affiche une seule boîte de dialogue couvrant les deux. Cliquer sur Annuler n'envoie rien et laisse votre sélection non enregistrée à l'écran. Une fois que vous avez enregistré les objets de données des coéquipiers, vous ne serez plus invité pour des modifications non liées, comme le changement de Format de sortie.

5. Après la prochaine exécution planifiée, vérifiez votre bucket. Les données des coéquipiers apparaissent sous leur propre dossier par objet de données — admins/ et admin_activity_logs/.

6. Pour confirmer qu'un export a été exécuté, retournez dans Paramètres > Données > Importations & exportations > Exporter les données et vérifiez l'onglet Exécutions. Chaque ligne est étiquetée par son objet de données — Conversations, Coéquipiers ou Journaux d'activité des coéquipiers.

Onglet Exécutions montrant les lignes d'export des Journaux d'activité des coéquipiers, Coéquipiers et Conversations avec badges de statut En cours et Terminé

7. Pour voir qui a modifié la configuration de votre export et quand, allez dans Paramètres > Espace de travail > Coéquipiers > journal d'activité et filtrez les événements d'export de données. Les entrées enregistrent les objets de données concernés. Les événements enregistrés avant la mise en place de cette fonctionnalité conservent leur formulation originale, sans objets de données.

Journal d'activité des coéquipiers filtré sur les événements de mise à jour des paramètres d'export de données, montrant le menu déroulant du type d'événement avec les options de filtre disponibles

Journal d'activité filtré sur la mise à jour des paramètres d'export de données, montrant les entrées avec détails des objets de données modifiés

8. Pour arrêter l'export des données des coéquipiers, décochez les objets de données, cliquez sur Mettre à jour et confirmez. Supprimer l'export entier supprime la configuration mais ne supprimera pas les fichiers déjà écrits dans votre bucket.


Quelles sont les limitations actuelles ?

Les limitations suivantes s'appliquent aux exports de données des coéquipiers et des journaux d'activité vers le stockage cloud.

  • Intercom ne peut pas supprimer les fichiers exportés. Une fois les données écrites dans votre bucket, Intercom ne peut que les écrire — il ne peut ni les lire ni les supprimer. Les demandes d'effacement ne peuvent pas se propager aux fichiers exportés, donc la suppression des données d'un coéquipier dans les fichiers déjà présents dans votre bucket est de votre responsabilité. C'est la même chose que pour les exports de conversations existants.

  • Coéquipiers est un instantané complet, pas un delta. Chaque exécution exporte toute votre liste dans un seul fichier. Il n'y a pas de mode incrémental ou de mode uniquement modifié, ni de filtrage par coéquipier ou par plage de dates.

  • Pas d'export historique en libre-service pour les données des coéquipiers. Contrairement aux conversations, il n'y a pas d'option de rattrapage sur deux ans — les données des coéquipiers commencent à circuler à partir de la prochaine exécution planifiée après activation. Si vous avez besoin d'une activité antérieure, contactez le Support et Intercom peut effectuer un export historique pour vous.

  • Au moins un objet de données est requis. Vous ne pouvez pas laisser un export sans rien coché.

  • Les journaux d'activité des coéquipiers nécessitent une version récente de la Data API version. Les exports fixés à une version plus ancienne ne peuvent pas les inclure.

  • Certaine activité est anonymisée. Lorsqu'une action a été effectuée par un compte qui n'est plus dans la liste des coéquipiers de votre espace de travail, l'ID de l'acteur et l'adresse IP ne sont pas inclus. Les métadonnées du journal d'activité sont limitées à un ensemble sélectionné de champs, donc un journal d'activité exporté peut contenir moins de détails que le même enregistrement provenant de la Data API version.

  • Un espace de travail par bucket. Comme pour les conversations, vous ne pouvez pas exporter plusieurs espaces de travail vers le même bucket.


Dépannage

Si quelque chose semble incorrect dans la configuration de votre export ou dans l'historique des exécutions, utilisez le tableau ci-dessous pour le diagnostiquer.

Ce que vous voyez

Ce que cela signifie

Les cases à cocher des coéquipiers sont manquantes, mais Conversations s'affiche

Il vous manque probablement Gérer les coéquipiers et/ou Voir tous les coéquipiers et les détails de l'équipe.

Une case à cocher est grisée et ne peut pas être décochée

C'est le dernier objet de données restant. Cochez-en un autre d'abord.

Une case à cocher est cochée et grisée

L'export inclut déjà cet objet de données, mais il ne peut pas être modifié ici — vos permissions ou la Data API version de l'export ont changé après sa configuration. Demandez à un coéquipier avec toutes les permissions, ou contactez le Support.

"Vous avez besoin de la permission pour gérer les coéquipiers et voir tous les coéquipiers et les détails de l'équipe…"

Vous n'avez pas les deux permissions requises. Un administrateur peut les accorder dans Paramètres > Coéquipiers.

"Actualisez la page pour voir les types d'objets disponibles…"

Les objets de données disponibles ont changé depuis le chargement de la page, généralement une Data API version qui ne peut pas fournir les journaux d'activité. Actualisez et réessayez, puis contactez le Support si cela persiste.

Une exécution apparaît dans l'onglet Exécutions mais aucun fichier n'atterrit dans votre bucket

Généralement un problème de permissions sur le bucket. Relancez le bouton Test sur votre destination, puis contactez le Support.

Certaines lignes du journal d'activité n'ont pas d'acteur, ou des métadonnées vides

C'est normal — le coéquipier qui a effectué l'action ne fait plus partie de la liste des coéquipiers de votre espace de travail.

Les métadonnées exportées diffèrent de GET /admins/activity_logs

Attendu — les exports utilisent un ensemble plus strict et sélectionné de champs de métadonnées que la réponse API.

Vous avez manqué une fenêtre et devez la reconstituer

Contactez le Support — Intercom peut effectuer un export historique des données de votre coéquipier et du journal d'activité.


Articles connexes

Avez-vous trouvé la réponse à votre question ?