La Contacts Activity API te ofrece un feed ordenado por tiempo de cada cambio en tus contactos — creaciones, cambios de rol, eliminaciones permanentes y fusiones. A diferencia de una lista de contactos estándar, captura cambios que serían invisibles, lo que facilita mantener herramientas externas como CRMs, data warehouses y plataformas de marketing sincronizadas.
Important: Este endpoint requiere la versión Preview de la API y un token con el alcance `read_users_companies`. Incluye la cabecera `Intercom-Version: Preview` en cada solicitud.
Eventos de contacto rastreados por la API
El feed registra los siguientes eventos del ciclo de vida del contacto:
Contacto creado
Cambio de rol del contacto
Contacto eliminado permanentemente
Contactos fusionados
Esto es especialmente útil si sincronizas datos de contacto con herramientas externas — CRMs, data warehouses o plataformas de marketing — porque captura eliminaciones y fusiones que una lista de contactos estándar no reflejará.
Cómo realizar tu primera solicitud a la API
La API se accede directamente vía HTTP — no hay interfaz dentro del producto. Para empezar:
Autentícate con un token de acceso que tenga el alcance `read_users_companies`.
Envía una solicitud GET a `/contacts/activities`.
Navega por los resultados usando el parámetro de cursor `starting_after`.
Controla el tamaño de página con `per_page` (por defecto: 50, máximo: 150).
Limitaciones
Ten en cuenta las siguientes restricciones al construir tu integración:
Datos devueltos | El feed devuelve solo IDs, roles y marcas de tiempo — sin direcciones de correo, nombres u otros atributos de contacto. |
Retención | Los eventos se conservan durante 90 días mediante tiempo de vida (TTL). Los eventos mayores de 90 días no están disponibles. |
Sin retroceso | Solo se incluyen contactos creados o actualizados después del 6 de agosto de 2026. No hay retroceso del historial de contactos anterior. |
Entrega al menos una vez | El mismo evento puede aparecer más de una vez con diferentes cursores. Desduplicar por ID de contacto y tipo de evento en tu aplicación o integración. |
Escrituras con el mejor esfuerzo | Ocasionalmente, puede perderse un evento si ocurre una falla al escribir. Esto nunca afecta la acción de contacto originaria en sí. |
Solo eliminaciones | contact.deleted cubre solo la eliminación permanente — los contactos archivados no aparecen como eliminados. |
Solo paginación por cursor | Usa pages.next para comprobar si existen más eventos y pásalo como starting_after para recuperar la siguiente página. No se admite la paginación por offset. |
Note: La Contacts Activity API está disponible en el plan Contact Activities en las regiones de datos US, EU y AU. No forma parte de los espacios de trabajo Fin Standalone.