---
title: "Intercom konektor"
description: "Kompletný sprievodca integráciou Intercom na synchronizáciu kontaktov, konverzácií, spoločností a udalostí zapojenia s Brevo cez Tajo."
url: https://tajo.io/sk/docs/connectors/support/intercom/
markdown: https://tajo.io/sk/docs/connectors/support/intercom.md
lang: sk-SK
robots: noindex
---

Požiadajte o skorý prístup

Zadajte svoje meno a pracovnú e-mailovú adresu. Pošleme vám odkaz na potvrdenie žiadosti o prístup k Tajo.

# Intercom konektor

Stav konektora: Plánované Zatiaľ nevytvorené. Tajo tento konektor dnes neprevádzkuje.

| Zdrojové pole | Cieľové pole | Ukážková hodnota |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Prepoj svoj Intercom workspace s Brevo cez Tajo pre zjednotenú zákaznícku komunikáciu, sledovanie konverzácií a marketingovú automatizáciu riadenú zapojením, poháňanú tvojimi podpornými a produktovými dátami.

## Prehľad

| Vlastnosť | Hodnota |
| --- | --- |
| **Platforma** | Intercom |
| **Kategória** | Podpora |
| **Zložitosť nastavenia** | Stredná |
| **Oficiálna integrácia** | Nie |
| **Synchronizované dáta** | Kontakty, Konverzácie, Spoločnosti, Udalosti |
| **API Base URL** | `https://api.intercom.io` |

## Funkcie

- **Synchronizácia kontaktov** - Obojsmerná synchronizácia používateľov a leadov Intercom s kontaktmi Brevo
- **Sledovanie konverzácií** - Synchronizuj dáta konverzácií pre segmentáciu riadenú podporou
- **Mapovanie spoločností** - Asociuj kontakty so spoločnosťami pre workflowy na základe účtov
- **Vlastné atribúty** - Mapuj vlastné atribúty Intercom na polia kontaktov Brevo
- **Sledovanie udalostí** - Synchronizuj vlastné udalosti a aktivity používateľov pre behaviorálne cielenie
- **Synchronizácia tagov** - Mapuj tagy Intercom na členstvo v zoznamoch Brevo alebo atribúty
- **Dáta Messengera** - Sleduj zapojenie v in-app správach a chatových interakciách
- **Integrácia AI agenta** - Synchronizuj výsledky konverzácií AI agenta s Brevo

## Predpoklady

Predtým, než začneš, uisti sa, že máš:

1. Intercom workspace (plán Starter, Pro alebo Premium)
2. Intercom aplikáciu s prístupovým tokenom (súkromná aplikácia) alebo nakonfigurovaný OAuth (verejná aplikácia)
3. Brevo účet s API prístupom
4. Tajo účet

## Autentifikácia

### Prístupový token (súkromná aplikácia)

Pre súkromné integrácie, ktoré pristupujú k dátam tvojho vlastného workspacu.

1. Prejdi do Developer Hub > Your Apps > Create new app
2. Prirad k svojmu Intercom workspacu
3. Skopíruj prístupový token

```bash
curl https://api.intercom.io/contacts \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -H "Intercom-Version: 2.11"
```

### OAuth 2.0 (verejná aplikácia)

Pre integrácie, ktoré pristupujú k Intercom dátam iných zákazníkov.

```bash
# Authorization URL
https://app.intercom.com/oauth?client_id={client_id}&state={state}

# Token exchange
curl -X POST https://api.intercom.io/auth/eagle/token \
  -d "client_id={client_id}" \
  -d "client_secret={client_secret}" \
  -d "code={auth_code}"
```

Verziovanie API

Vždy zahrň hlavičku `Intercom-Version` do svojich požiadaviek. Tajo predvolene používa API verziu 2.11. Skontroluj changelog Intercom pre prelomové zmeny.

## Konfigurácia

### Základné nastavenie

```yaml
connectors:
  intercom:
    enabled: true
    access_token: "${INTERCOM_ACCESS_TOKEN}"
    api_version: "2.11"

    # Data sync options
    sync:
      contacts: true
      conversations: true
      companies: true
      events: true
      tags: true

    # Sync direction
    direction: intercom_to_brevo

    # Brevo list assignment
    lists:
      all_users: 35
      active_conversations: 36
      leads: 37
```

### Mapovanie polí

Namapuj dáta kontaktov Intercom na atribúty kontaktov Brevo:

#### Predvolené mapovania

| Parameter | Type | Description |
| --- | --- | --- |
| `email` required | string | E-mailová adresa kontaktu (unikátny identifikátor) |
| `name` optional | string | Celé meno, rozdelené na FIRSTNAME/LASTNAME |
| `phone` optional | string | Mapuje sa na atribút SMS pre WhatsApp/SMS |
| `role` optional | string | Typ kontaktu: user alebo lead |
| `company.name` optional | string | Názov pridruženej spoločnosti |
| `signed_up_at` optional | timestamp | Dátum registrácie používateľa |
| `last_seen_at` optional | timestamp | Časová pečiatka poslednej aktivity |
| `custom_attributes` optional | object | Páry kľúč-hodnota vlastných atribútov |

#### Mapovanie vlastných atribútov

```yaml
field_mapping:
  # Standard fields
  email: email
  name: FULLNAME
  phone: SMS

  # Engagement fields
  signed_up_at: SIGNUP_DATE
  last_seen_at: LAST_ACTIVE
  session_count: SESSION_COUNT
  unsubscribed_from_emails: UNSUBSCRIBED

  # Company fields
  company.name: COMPANY_NAME
  company.plan: COMPANY_PLAN
  company.size: COMPANY_SIZE

  # Custom attributes
  custom_attributes.plan_tier: PLAN_TIER
  custom_attributes.feature_usage: FEATURE_USAGE
```

## API endpointy

### Contacts API

| Metóda | Endpoint | Popis |
| --- | --- | --- |
| `GET` | `/contacts` | Zoznam všetkých kontaktov |
| `POST` | `/contacts` | Vytvorenie kontaktu |
| `PUT` | `/contacts/{id}` | Aktualizácia kontaktu |
| `GET` | `/contacts/{id}` | Načítanie kontaktu |
| `POST` | `/contacts/search` | Vyhľadávanie kontaktov |
| `DELETE` | `/contacts/{id}` | Archivácia kontaktu |

### Conversations API

| Metóda | Endpoint | Popis |
| --- | --- | --- |
| `GET` | `/conversations` | Zoznam konverzácií |
| `GET` | `/conversations/{id}` | Načítanie konverzácie |
| `POST` | `/conversations` | Vytvorenie konverzácie |
| `POST` | `/conversations/{id}/reply` | Odpoveď na konverzáciu |
| `POST` | `/conversations/{id}/parts` | Pridanie časti konverzácie |

### Companies API

| Metóda | Endpoint | Popis |
| --- | --- | --- |
| `GET` | `/companies` | Zoznam spoločností |
| `POST` | `/companies` | Vytvorenie alebo aktualizácia spoločnosti |
| `GET` | `/companies/{id}` | Načítanie spoločnosti |
| `GET` | `/companies/{id}/contacts` | Zoznam kontaktov spoločnosti |

### Events API

| Metóda | Endpoint | Popis |
| --- | --- | --- |
| `POST` | `/events` | Odoslanie udalosti |
| `GET` | `/events?type=user&intercom_user_id={id}` | Zoznam udalostí používateľa |

## Udalosti

### Udalosti konverzácií

| Udalosť | Trigger | Prípad použitia |
| --- | --- | --- |
| `conversation.created` | Začatá nová konverzácia | Upozornenie na podporný ticket |
| `conversation.closed` | Konverzácia vyriešená | Trigger prieskumu CSAT |
| `conversation.rating.added` | Odovzdané hodnotenie | Sledovanie spokojnosti |
| `conversation.snoozed` | Konverzácia odložená | Plánovanie follow-upu |

### Udalosti kontaktov

| Udalosť | Trigger | Prípad použitia |
| --- | --- | --- |
| `contact.created` | Pridaný nový kontakt | Uvítacia sekvencia |
| `contact.updated` | Zmenené dáta kontaktu | Synchronizácia atribútov |
| `contact.deleted` | Kontakt archivovaný | Čistenie |
| `contact.tag.created` | Tag pridaný ku kontaktu | Aktualizácia segmentu |

### Udalosti používateľov

| Udalosť | Trigger | Prípad použitia |
| --- | --- | --- |
| `user.created` | Zaregistrovaný nový používateľ | Onboardingový tok |
| `user.email.updated` | Zmenený e-mail | Zlúčenie kontaktov |
| `user.unsubscribed` | Odhlásenie z e-mailov | Aktualizácia preferencií |

## Ukážky kódu

### Inicializácia konektora

```javascript
import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Connect Intercom
await tajo.connectors.connect('intercom', {
  accessToken: process.env.INTERCOM_ACCESS_TOKEN,
  apiVersion: '2.11'
});
```

### Synchronizácia kontaktov a konverzácií

```javascript
// Full sync of contacts and conversation data
await tajo.connectors.sync('intercom', {
  type: 'full',
  resources: ['contacts', 'conversations', 'companies'],
  since: '2023-01-01'
});

// Check sync status
const status = await tajo.connectors.status('intercom');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsSynced: 14200,
//   conversationsSynced: 28400,
//   companiesSynced: 2100
// }
```

### Spracovanie webhookov Intercom

```javascript
import crypto from 'crypto';

app.post('/webhooks/intercom', async (req, res) => {
  const signature = req.get('X-Hub-Signature');
  const expectedSig = 'sha1=' + crypto
    .createHmac('sha1', process.env.INTERCOM_CLIENT_SECRET)
    .update(JSON.stringify(req.body))
    .digest('hex');

  if (signature !== expectedSig) {
    return res.status(401).send('Unauthorized');
  }

  await tajo.connectors.handleWebhook('intercom', {
    topic: req.body.topic,
    data: req.body.data
  });

  res.status(200).send('OK');
});
```

## Obmedzenia rýchlosti

Intercom uplatňuje limity rýchlosti podľa tvojho plánu:

| Plán | Limit rýchlosti | Detaily |
| --- | --- | --- |
| Starter | 20 požiadaviek/10 sekúnd | Na aplikáciu |
| Pro | 50 požiadaviek/10 sekúnd | Na aplikáciu |
| Premium | 100 požiadaviek/10 sekúnd | Na aplikáciu |
| Search endpoint | 1 požiadavka/sekundu | Na aplikáciu |
| Scroll endpoint | 1 požiadavka/minútu | Na aplikáciu |

Ďalšie limity:

- **Hromadné operácie**: 15 kontaktov na hromadnú požiadavku
- **Odosielanie udalostí**: 500 udalostí/sekundu na workspace
- **Doručenie webhookov**: Automatické opakovanie po dobu 24 hodín
- **Export dát**: 1 súbežný export

Odpoveď pri limite rýchlosti

Intercom vracia `429 Too Many Requests` s hlavičkou `Retry-After`. Implementuj exponenciálny backoff a rešpektuj okno opakovania.

## Riešenie problémov

### Bežné problémy

| Problém | Príčina | Riešenie |
| --- | --- | --- |
| 401 Unauthorized | Neplatný alebo vypršaný token | Regeneruj prístupový token v Developer Hub |
| Kontakt nie je synchronizovaný | Chýba pole e-mail | Leady Intercom môžu nemať e-mail; filtruj podľa roly |
| Dáta konverzácií sú prázdne | Aplikácia nemá scope konverzácií | Znovu autorizuj s oprávneniami na čítanie konverzácií |
| Webhook nebol prijatý | Webhook nie je zaregistrovaný | Nakonfiguruj webhooky v nastaveniach Developer Hub |
| Nesúlad verzií API | Prelomové zmeny v novej verzii | Pripni verziu API s hlavičkou `Intercom-Version` |

### Debug režim

Zapni verbose logovanie:

```yaml
connectors:
  intercom:
    debug: true
    log_level: verbose
    log_webhooks: true
```

### Test pripojenia

```bash
tajo connectors test intercom
# ✓ API connection successful
# ✓ Contacts readable
# ✓ Conversations readable
# ✓ Companies readable
# ✓ Webhooks registered
```

## Odporúčané postupy

1. **Pripni verziu API** - Vždy špecifikuj `Intercom-Version` aby si sa vyhol prelomovým zmenám
2. **Použi Search API efektívne** - Použi filtre a stránkovanie na zníženie prenosu dát
3. **Synchronizuj používateľov aj leady** - Zachyť celý lievik v Brevo
4. **Mapuj tagy konverzácií** - Použi tagy konverzácií pre marketingové segmenty po podpore
5. **Sleduj vlastné udalosti** - Odosielaj kľúčové produktové udalosti do Intercom pre behaviorálne cielenie
6. **Spracovávaj zlúčenia kontaktov** - Implementuj logiku zlúčenia pre duplicitné kontakty

## Bezpečnosť

- **Prístupový token** - Autentifikácia bearer tokenom pre súkromné aplikácie
- **OAuth 2.0** - Delegovaná autorizácia pre verejné aplikácie s tajomstvom klienta
- **Overenie webhookov** - Validácia podpisu HMAC SHA-1 cez `X-Hub-Signature`
- **TLS šifrovanie** - Všetka API komunikácia šifrovaná cez HTTPS
- **Kontrola prístupu k dátam** - Granulárny prístup k dátam podľa konfigurácie aplikácie

## Súvisiace zdroje

- [Intercom Developer dokumentácia](https://developers.intercom.com/docs)
- [Intercom API referencia](https://developers.intercom.com/docs/references/introduction)
- [Zendesk konektor](https://tajo.io/sk/docs/connectors/support/zendesk)
- [Customer Sync skill](https://tajo.io/sk/docs/skills/data-sync/customer-sync)
- [Brevo Contacts API](https://tajo.io/sk/docs/contact-management)