Σύνδεσμος Intercom

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

Επισκόπηση

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

• Συγχρονισμός επαφών - Αμφίδρομος συγχρονισμός χρηστών και δυνητικών πελατών 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

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 άλλων πελατών.

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

Διαμόρφωση

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

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:

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

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

Conversations API

Companies API

Events API

Εκδηλώσεις

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

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

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

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

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

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

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

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

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 εφαρμόζει όρια ρυθμού βάσει πλάνου:

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

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

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

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

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

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

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

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

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
• Intercom API Reference
• Σύνδεσμος Zendesk
• Δεξιότητα Συγχρονισμού Πελατών
• API Επαφών Brevo