Przejdź do treści
Biblioteka skilli
Prawo i compliance · Budowanie i kod

intercom-data-handling

/intercom-data-handling

Wdraża obsługę danych Intercom pod kątem GDPR, eksportu kontaktów, retencji i PII: wnioski o dostęp i usunięcie, redakcja logów i retencja cache.

Licencja
MIT
Ostatnia zmiana repozytorium
26.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
3
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
3
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Wdraża obsługę danych Intercom pod kątem GDPR, eksportu kontaktów, retencji i PII: wnioski o dostęp i usunięcie, redakcja logów i retencja cache.

Wyzwalacze z opisu

intercom dataintercom PIIintercom GDPRintercom data retentionintercom privacyintercom CCPAintercom data exportintercom delete contact
Oryginalny opis (EN)

Implement Intercom data handling for GDPR, contact export, data retention, and PII. Use when handling sensitive Intercom contact data, fulfilling a data subject access or deletion request, redacting PII in logs, or setting retention policy for cached Intercom records. Trigger with phrases like "intercom data", "intercom PII", "intercom GDPR", "intercom data retention", "intercom privacy", "intercom CCPA", "intercom data export", "intercom delete contact".

Jak działa

  1. Overview
  2. Prerequisites
  3. Authentication
  4. Data Classification for Intercom
  5. Instructions
  6. Output
  7. Error Handling
  8. Examples
  9. Resources
  10. Next Steps
Sekcje z nagłówków SKILL.md, w oryginale · 128 linii, 750 słów
Podgląd SKILL.md
---
name: intercom-data-handling
description: 'Implement Intercom data handling for GDPR, contact export, data retention,
  and PII.

  Use when handling sensitive Intercom contact data, fulfilling a data subject
  access or deletion request, redacting PII in logs, or setting retention policy
  for cached Intercom records.

  Trigger with phrases like "intercom data", "intercom PII",

  "intercom GDPR", "intercom data retention", "intercom privacy", "intercom CCPA",

  "intercom data export", "intercom delete contact".

  '
allowed-tools: Read, Write, Edit
version: 1.6.0
license: MIT
author: Jeremy Longshore <jeremy@intentsolutions.io>
tags:
- saas
- support
- messaging
- intercom
compatibility: Designed for Claude Code
---
# Intercom Data Handling

## Overview

Handle sensitive contact data in Intercom integrations with GDPR/CCPA compliance:
data export via the Data Export API, contact deletion with an audit trail, PII
redaction in logs, and data retention policies. This skill gives you a lean map of
the five workflows here; the full copy-ready TypeScript lives in
[references/implementation.md](references/implementation.md) and worked usage in
[references/examples.md](references/examples.md).

## Prerequisites

- Understanding of GDPR/CCPA requirements
- `intercom-client` SDK installed
- Database for audit logging
- Familiarity with Intercom's contact and conversation data model

## Authentication

Every call authenticates with an Intercom access token via a Bearer header. Store
it as `INTERCOM_ACCESS_TOKEN` in the environment — never hardcode it and never log
it:

```typescript
import { IntercomClient } from "intercom-client";

const client = new IntercomClient({
  token: process.env.INTERCOM_ACCESS_TOKEN!,
});
// Raw REST calls use: Authorization: `Bearer ${process.env.INTERCOM_ACCESS_TOKEN}`
```

Grant the token the minimum scopes needed (read contacts/conversations for export,
write/delete for erasure). Rotate it if it ever appears in a log or a diff.

## Data Classification for Intercom

| Category | Intercom Fields | Handling |
|----------|----------------|----------|
| PII | `email`, `name`, `phone`, `location` | Encrypt at rest, redact in logs |
| Identifiers | `id`, `external_id`, `user_id` | Use for lookups, no display |
| Conversation content | `body`, `conversation_parts` | May contain PII, scan before logging |
| Custom attributes | User-defined | Depends on content |
| System metadata | `created_at`, `updated_at`, `role` | Standard handling |

## Instructions

The five workflows below compose into a compliant Intercom data lifecycle. Follow
the summary here, then open [references/implementation.md](references/implementation.md)
for the complete function bodies.

1. **DSAR export** — `exportContactData(contactId)` gathers the contact profile,
   all conversations (with parts), tags, segments, and data events into one bundle.
   This is the "give me all my data" request.
2. **Right to deletion (Article 17)** — `deleteContactData(contactId)` exports for
   the audit trail *first*, then deletes from Intercom and every local cache, and
   records a PII-free audit entry (email is hashed, not stored).
3. **Bulk data export** — `bulkExportMessages(start, end)` kicks off the async
   `/export/messages/data` job; `checkExportStatus(jobId)` polls until a CSV
   `download_url` is returned.
4. **PII redaction in logs** — `redactIntercomData(data)` masks a fixed
   `PII_FIELDS` set (including nested `custom_attributes.*`) before anything is
   logged.
5. **Retention enforcement** — `enforceRetention()` sweeps cached records past
   their `RETENTION` window on a daily cron, and never touches the 7-year audit log.

Data minimization underpins all five: sync only the fields you need so the erasure
and breach surface stays small (see [references/examples.md](references/examples.md)).

Here is the entry-point skeleton — the export that DSAR and deletion both build on:

```typescript
const contact = await client.contacts.find({ contactId });
const convList = await client.conversations.search({
  query: { field: "contact_ids", operator: "=", value: contactId },
});
// ...gather tags, segments, events → return one bundle
```

## Output

Each workflow returns a structured, PII-aware result:

- **DSAR export** → an object with `contact`, `conversations[]`, `tags[]`,
  `segments[]`, and `events[]` — the full data bundle to hand to the requester.
- **Deletion** → `{ deleted: true, auditRecord }` where `auditRecord` holds the
  action, hashed email, timestamp, purged data sources, and conversation count —
  proof of erasure that contains no raw PII.
- **Bulk export** → a `job_identifier`, then a `{ status, downloadUrl }` once the
  CSV is ready.
- **Redaction** → the same object shape with PII fields replaced by `[REDACTED]`.
- **Retention** → `{ deleted: { [cacheType]: count } }` per swept cache type.

## Error Handling

| Issue | Cause | Solution |
|-------|-------|----------|
| Export job stuck in "pending" | Large dataset | Poll every 30s, timeout at 1h |
| Deletion returns 404 | Already deleted | Log and continue (idempotent) |
| PII in conversation bodies | User-submitted content | Scan with regex, redact in logs |
| Audit log gap | Failed write | Use write-ahead log or queue |

## Examples

Full worked examples — fulfilling a DSAR, honoring a deletion request, polling a
bulk export to completion, and redacting before logging — are in
[references/examples.md](references/examples.md). The shortest one:

```typescript
// A user asks for all their data — export the whole bundle to JSON.
const bundle = await exportContactData("5f3c9b2e8a1d4e0012ab34cd");
await fs.writeFile(`dsar/${bundle.contact.id}.json`, JSON.stringify(bundle, null, 2));
```

## Resources

- [Full implementation walkthrough](references/implementation.md) — all five workflows, copy-ready
- [Worked examples](references/examples.md) — end-to-end usage + data minimization
- [Data Export API](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/data-export/data_export)
- [Contacts API](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/contacts)
- [Intercom Privacy](https://www.intercom.com/privacy)

## Next Steps

For enterprise access control and permission scoping on top of these data
workflows, see the `intercom-enterprise-rbac` skill in this pack.
Pliki w paczce (3)
  • SKILL.md 6 KB
  • references/examples.md 3 KB
  • references/implementation.md 6 KB

Wersje

W bazie nie ma innych skilli o nazwie intercom-data-handling.

Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.

Migawka bazy z 13.11.2026 · wersja paczki ad346d471f35 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100posthog-data-handling
    Wdraża obsługę PII, retencję danych i zgodność z GDPR i CCPA w integracjach PostHog: redakcja danych wrażliwych i polityki retencji.
  • 100vercel-data-handling
    Wdraża wzorce obsługi PII, retencji danych i zgodności z GDPR i CCPA w integracjach Vercel, w tym redakcję i polityki retencji.
  • 100klaviyo-data-handling
    Wdraża prywatność danych w Klaviyo, zgodność z GDPR i CCPA oraz obsługę PII: dane profili, prawo do usunięcia i retencja danych.
  • 100intercom-webhooks-events
    Wdraża obsługę webhooków Intercom i śledzenie zdarzeń danych: endpointy, przetwarzanie powiadomień i wysyłanie własnych zdarzeń o aktywności kontaktów.
  • 100gdpr
    Wdraża zgodność z RODO w kodzie: prawa osób, których dane dotyczą (dostęp, usunięcie, przenoszenie), zarządzanie zgodami, rejestry przetwarzania, obsługa PII i privacy by design.
  • 100gdpr-compliance
    Automatyzuje zgodność aplikacji webowych z RODO: audyt PII, zgody i cookies, endpointy żądań osób, polityki retencji i generator polityki prywatności.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.