L'API Contacts Activity vous fournit un flux ordonné chronologiquement de chaque modification apportée à vos contacts — créations, changements de rôle, suppressions définitives et fusions. Contrairement à une liste de contacts classique, elle capture des modifications autrement invisibles, ce qui facilite la synchronisation d'outils externes tels que les CRM, les entrepôts de données et les plateformes marketing.
Important : cet endpoint nécessite la version Preview de l'API et un token avec la portée `read_users_companies`. Incluez l'en-tête `Intercom-Version: Preview` dans chaque requête.
Événements de contact suivis par l'API
Le flux enregistre les événements suivants du cycle de vie d'un contact :
Contact créé
Rôle du contact modifié
Contact supprimé définitivement
Contacts fusionnés
Ceci est particulièrement utile si vous synchronisez les données de contact vers des outils externes — CRM, entrepôts de données ou plateformes marketing — car cela capture les suppressions et les fusions qu'une liste de contacts standard ne refléterait pas.
Comment effectuer votre première requête API
L'API est accessible directement via HTTP — il n'y a pas d'interface utilisateur intégrée. Pour commencer :
Authentifiez-vous avec un jeton d'accès ayant la portée `read_users_companies`.
Envoyez une requête GET à `/contacts/activities`.
Parcourez les résultats en utilisant le paramètre de curseur `starting_after`.
Contrôlez la taille des pages avec `per_page` (par défaut : 50, max : 150).
Limitations
Gardez les contraintes suivantes à l'esprit lors de la création de votre intégration :
Données renvoyées | Le flux ne renvoie que des IDs, des rôles et des horodatages — pas d'adresses e-mail, de noms ni d'autres attributs de contact. |
Rétention | Les événements sont conservés pendant 90 jours via un time-to-live (TTL). Les événements de plus de 90 jours ne sont pas disponibles. |
Pas de backfill | Seuls les contacts créés ou mis à jour après le 6 août 2026 sont inclus. Il n'y a pas de reconstitution de l'historique des contacts antérieur. |
Livraison au moins une fois | Le même événement peut apparaître plusieurs fois avec des curseurs différents. Dédupliquez par ID de contact et type d'événement dans votre application ou intégration. |
Écritures en best-effort | Occasionnellement, un événement peut être manqué en cas d'échec d'écriture. Cela n'affecte jamais l'action d'origine sur le contact lui-même. |
Suppression uniquement | contact.deleted couvre uniquement la suppression définitive — les contacts archivés n'apparaissent pas comme supprimés. |
Pagination par curseur uniquement | Utilisez pages.next pour vérifier si d'autres événements existent et passez-le comme starting_after pour récupérer la page suivante. La pagination par offset n'est pas prise en charge. |
Note : l'API Contacts Activity est disponible dans le plan Contact Activities dans les régions de données US, EU et AU. Elle ne fait pas partie des espaces de travail Fin Standalone.