---
title: "Σύνδεσμος Intercom"
description: "Πλήρης οδηγός ενσωμάτωσης Intercom για συγχρονισμό επαφών, συνομιλιών, εταιρειών και εκδηλώσεων αφοσίωσης με το Brevo μέσω Tajo."
url: https://tajo.io/gr/docs/connectors/support/intercom/
markdown: https://tajo.io/gr/docs/connectors/support/intercom.md
lang: el-GR
robots: noindex
---

Ζητήστε πρώιμη πρόσβαση

Συμπληρώστε το μικρό σας όνομα και την επαγγελματική διεύθυνση email. Θα σας στείλουμε σύνδεσμο για να επιβεβαιώσετε το αίτημα πρόσβασης στο Tajo.

# Σύνδεσμος Intercom

Κατάσταση συνδέσμου: Προγραμματισμένο Δεν έχει κατασκευαστεί ακόμη. Το Tajo δεν εκτελεί σήμερα αυτόν τον σύνδεσμο.

| Πεδίο πηγής | Πεδίο προορισμού | Ενδεικτική τιμή |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Συνδέστε τον χώρο εργασίας Intercom με το Brevo μέσω Tajo για ενοποιημένη αποστολή μηνυμάτων πελατών, παρακολούθηση συνομιλιών και αυτοματισμό marketing βάσει αφοσίωσης τροφοδοτούμενο από δεδομένα υποστήριξης και προϊόντος.

## Επισκόπηση

| Ιδιότητα | Τιμή |
| --- | --- |
| **Πλατφόρμα** | Intercom |
| **Κατηγορία** | Υποστήριξη |
| **Πολυπλοκότητα Ρύθμισης** | Μέτρια |
| **Επίσημη Ενσωμάτωση** | Όχι |
| **Δεδομένα που Συγχρονίζονται** | Επαφές, Συνομιλίες, Εταιρείες, Εκδηλώσεις |
| **Βασικό URL API** | `https://api.intercom.io` |

## Χαρακτηριστικά

- **Συγχρονισμός επαφών** - Αμφίδρομος συγχρονισμός χρηστών και δυνητικών πελατών Intercom με επαφές Brevo
- **Παρακολούθηση συνομιλιών** - Συγχρονισμός δεδομένων συνομιλίας για τμηματοποίηση βάσει υποστήριξης
- **Αντιστοίχηση εταιρείας** - Συσχέτιση επαφών με εταιρείες για ροές εργασίας βάσει λογαριασμού
- **Προσαρμοσμένα χαρακτηριστικά** - Αντιστοίχηση προσαρμοσμένων χαρακτηριστικών Intercom σε πεδία επαφών Brevo
- **Παρακολούθηση εκδηλώσεων** - Συγχρονισμός προσαρμοσμένων εκδηλώσεων και δραστηριοτήτων χρήστη για συμπεριφορική στόχευση
- **Συγχρονισμός ετικετών** - Αντιστοίχηση ετικετών Intercom σε συμμετοχή λίστας ή χαρακτηριστικά Brevo
- **Δεδομένα Messenger** - Παρακολούθηση αφοσίωσης μηνυμάτων εντός εφαρμογής και αλληλεπιδράσεων chat
- **Ενσωμάτωση AI agent** - Συγχρονισμός αποτελεσμάτων συνομιλίας AI agent με το Brevo

## Προαπαιτούμενα

Πριν ξεκινήσετε, βεβαιωθείτε ότι διαθέτετε:

1. Χώρο εργασίας Intercom (πλάνο Starter, Pro ή Premium)
2. Εφαρμογή Intercom με access token (ιδιωτική εφαρμογή) ή ρυθμισμένο OAuth (δημόσια εφαρμογή)
3. Λογαριασμό Brevo με πρόσβαση API
4. Λογαριασμό Tajo

## Πιστοποίηση

### Access Token (Ιδιωτική Εφαρμογή)

Για ιδιωτικές ενσωματώσεις που προσπελαύνουν δεδομένα του δικού σας χώρου εργασίας.

1. Μεταβείτε στο Developer Hub > Your Apps > Create new app
2. Συσχετίστε με τον χώρο εργασίας Intercom
3. Αντιγράψτε το access 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 (Δημόσια Εφαρμογή)

Για ενσωματώσεις που προσπελαύνουν δεδομένα Intercom άλλων πελατών.

```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}"
```

Εκδόσεις API

Να συμπεριλαμβάνετε πάντα την κεφαλίδα `Intercom-Version` στα αιτήματά σας. Το Tajo χρησιμοποιεί έκδοση API 2.11 ως προεπιλογή. Ελέγξτε το αρχείο αλλαγών Intercom για αλλαγές που προκαλούν διακοπή λειτουργίας.

## Διαμόρφωση

### Βασική Ρύθμιση

```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
```

### Αντιστοίχιση Πεδίων

Αντιστοίχηση δεδομένων επαφής Intercom σε χαρακτηριστικά επαφών Brevo:

#### Προεπιλεγμένες Αντιστοιχίσεις

| Parameter | Type | Description |
| --- | --- | --- |
| `email` required | string | Διεύθυνση email επαφής (μοναδικό αναγνωριστικό) |
| `name` optional | string | Πλήρες όνομα, χωρίζεται σε FIRSTNAME/LASTNAME |
| `phone` optional | string | Αντιστοιχεί στο χαρακτηριστικό SMS για WhatsApp/SMS |
| `role` optional | string | Τύπος επαφής: user ή lead |
| `company.name` optional | string | Όνομα συσχετισμένης εταιρείας |
| `signed_up_at` optional | timestamp | Ημερομηνία εγγραφής χρήστη |
| `last_seen_at` optional | timestamp | Τελευταία χρονική σήμανση δραστηριότητας |
| `custom_attributes` optional | object | Ζεύγη κλειδιού-τιμής προσαρμοσμένων χαρακτηριστικών |

#### Αντιστοίχηση Προσαρμοσμένων Χαρακτηριστικών

```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
```

## Endpoints API

### Contacts API

| Μέθοδος | Endpoint | Περιγραφή |
| --- | --- | --- |
| `GET` | `/contacts` | Λίστα όλων των επαφών |
| `POST` | `/contacts` | Δημιουργία επαφής |
| `PUT` | `/contacts/{id}` | Ενημέρωση επαφής |
| `GET` | `/contacts/{id}` | Ανάκτηση επαφής |
| `POST` | `/contacts/search` | Αναζήτηση επαφών |
| `DELETE` | `/contacts/{id}` | Αρχειοθέτηση επαφής |

### Conversations API

| Μέθοδος | Endpoint | Περιγραφή |
| --- | --- | --- |
| `GET` | `/conversations` | Λίστα συνομιλιών |
| `GET` | `/conversations/{id}` | Ανάκτηση συνομιλίας |
| `POST` | `/conversations` | Δημιουργία συνομιλίας |
| `POST` | `/conversations/{id}/reply` | Απάντηση σε συνομιλία |
| `POST` | `/conversations/{id}/parts` | Προσθήκη μέρους συνομιλίας |

### Companies API

| Μέθοδος | Endpoint | Περιγραφή |
| --- | --- | --- |
| `GET` | `/companies` | Λίστα εταιρειών |
| `POST` | `/companies` | Δημιουργία ή ενημέρωση εταιρείας |
| `GET` | `/companies/{id}` | Ανάκτηση εταιρείας |
| `GET` | `/companies/{id}/contacts` | Λίστα επαφών εταιρείας |

### Events API

| Μέθοδος | Endpoint | Περιγραφή |
| --- | --- | --- |
| `POST` | `/events` | Υποβολή εκδήλωσης |
| `GET` | `/events?type=user&intercom_user_id={id}` | Λίστα εκδηλώσεων χρήστη |

## Εκδηλώσεις

### Εκδηλώσεις Συνομιλίας

| Εκδήλωση | Trigger | Χρήση |
| --- | --- | --- |
| `conversation.created` | Έναρξη νέας συνομιλίας | Ειδοποίηση εισιτηρίου υποστήριξης |
| `conversation.closed` | Επίλυση συνομιλίας | Trigger έρευνας CSAT |
| `conversation.rating.added` | Υποβολή βαθμολογίας | Παρακολούθηση ικανοποίησης |
| `conversation.snoozed` | Αναβολή συνομιλίας | Προγραμματισμός follow-up |

### Εκδηλώσεις Επαφής

| Εκδήλωση | Trigger | Χρήση |
| --- | --- | --- |
| `contact.created` | Προσθήκη νέας επαφής | Ακολουθία καλωσορίσματος |
| `contact.updated` | Αλλαγή δεδομένων επαφής | Συγχρονισμός χαρακτηριστικών |
| `contact.deleted` | Αρχειοθέτηση επαφής | Εκκαθάριση |
| `contact.tag.created` | Προσθήκη ετικέτας σε επαφή | Ενημέρωση τμήματος |

### Εκδηλώσεις Χρήστη

| Εκδήλωση | Trigger | Χρήση |
| --- | --- | --- |
| `user.created` | Εγγραφή νέου χρήστη | Ροή onboarding |
| `user.email.updated` | Αλλαγή email | Συγχώνευση επαφής |
| `user.unsubscribed` | Διαγραφή από email | Ενημέρωση προτίμησης |

## Παραδείγματα Κώδικα

### Αρχικοποίηση Συνδέσμου

```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'
});
```

### Συγχρονισμός Επαφών και Συνομιλιών

```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
// }
```

### Χειρισμός Webhooks 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');
});
```

## Όρια Ρυθμού

Το Intercom εφαρμόζει όρια ρυθμού βάσει πλάνου:

| Πλάνο | Όριο Ρυθμού | Λεπτομέρειες |
| --- | --- | --- |
| Starter | 20 αιτήματα/10 δευτερόλεπτα | Ανά εφαρμογή |
| Pro | 50 αιτήματα/10 δευτερόλεπτα | Ανά εφαρμογή |
| Premium | 100 αιτήματα/10 δευτερόλεπτα | Ανά εφαρμογή |
| Search endpoint | 1 αίτημα/δευτερόλεπτο | Ανά εφαρμογή |
| Scroll endpoint | 1 αίτημα/λεπτό | Ανά εφαρμογή |

Επιπλέον όρια:

- **Μαζικές λειτουργίες**: 15 επαφές ανά μαζικό αίτημα
- **Υποβολές εκδηλώσεων**: 500 εκδηλώσεις/δευτερόλεπτο ανά χώρο εργασίας
- **Παράδοση webhook**: Αυτόματη επανάληψη για 24 ώρες
- **Εξαγωγή δεδομένων**: 1 ταυτόχρονη εξαγωγή

Απόκριση Ορίου Ρυθμού

Το Intercom επιστρέφει `429 Too Many Requests` με κεφαλίδα `Retry-After`. Υλοποιήστε εκθετική καθυστέρηση και σεβαστείτε το παράθυρο επανάληψης.

## Αντιμετώπιση Προβλημάτων

### Συνήθη Προβλήματα

| Πρόβλημα | Αιτία | Λύση |
| --- | --- | --- |
| 401 Unauthorized | Μη έγκυρο ή ληγμένο token | Αναγεννήστε access token στο Developer Hub |
| Μη συγχρονισμένη επαφή | Λείπει πεδίο email | Οι δυνητικοί πελάτες Intercom ενδέχεται να μην έχουν email· φιλτράρετε κατά ρόλο |
| Κενά δεδομένα συνομιλίας | Η εφαρμογή δεν έχει εύρος συνομιλίας | Επανεξουσιοδοτήστε με δικαιώματα ανάγνωσης συνομιλίας |
| Δεν λαμβάνεται webhook | Το webhook δεν είναι εγγεγραμμένο | Ρυθμίστε webhooks στις ρυθμίσεις Developer Hub |
| Αναντιστοιχία έκδοσης API | Αλλαγές που προκαλούν διακοπή σε νέα έκδοση | Καρφιτσώστε έκδοση API με κεφαλίδα `Intercom-Version` |

### Λειτουργία Εντοπισμού Σφαλμάτων

Ενεργοποίηση λεπτομερούς καταγραφής:

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

### Δοκιμή Σύνδεσης

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

## Βέλτιστες Πρακτικές

1. **Καρφιτσώστε έκδοση API** - Να καθορίζετε πάντα `Intercom-Version` για αποφυγή αλλαγών που προκαλούν διακοπή
2. **Χρησιμοποιήστε αποδοτικά το search API** - Χρησιμοποιήστε φίλτρα και σελιδοποίηση για μείωση μεταφοράς δεδομένων
3. **Συγχρονίστε τόσο χρήστες όσο και δυνητικούς πελάτες** - Καταγράψτε πλήρη χοάνη στο Brevo
4. **Αντιστοιχίστε ετικέτες συνομιλίας** - Χρησιμοποιήστε ετικέτες συνομιλίας για τμήματα marketing μετά-υποστήριξη
5. **Παρακολουθήστε προσαρμοσμένες εκδηλώσεις** - Υποβάλλετε βασικές εκδηλώσεις προϊόντος στο Intercom για συμπεριφορική στόχευση
6. **Χειριστείτε συγχωνεύσεις επαφών** - Υλοποιήστε λογική συγχώνευσης για διπλότυπες επαφές

## Ασφάλεια

- **Access Token** - Πιστοποίηση bearer token για ιδιωτικές εφαρμογές
- **OAuth 2.0** - Εκχωρημένη εξουσιοδότηση για δημόσιες εφαρμογές με client secret
- **Επαλήθευση webhook** - Επικύρωση υπογραφής HMAC SHA-1 μέσω `X-Hub-Signature`
- **Κρυπτογράφηση TLS** - Όλη η επικοινωνία API κρυπτογραφείται μέσω HTTPS
- **Έλεγχοι πρόσβασης δεδομένων** - Λεπτομερής πρόσβαση δεδομένων ανά ρύθμιση εφαρμογής

## Σχετικοί Πόροι

- [Intercom Developer Documentation](https://developers.intercom.com/docs)
- [Intercom API Reference](https://developers.intercom.com/docs/references/introduction)
- [Σύνδεσμος Zendesk](https://tajo.io/gr/docs/connectors/support/zendesk)
- [Δεξιότητα Συγχρονισμού Πελατών](https://tajo.io/gr/docs/skills/data-sync/customer-sync)
- [API Επαφών Brevo](https://tajo.io/gr/docs/contact-management)