Konektor Intercom

Propojte svůj pracovní prostor Intercom s Brevo přes Tajo pro sjednocenou zákaznickou komunikaci, sledování konverzací a marketingovou automatizaci řízenou zapojením využívající data podpory a produktu.

Přehled

Funkce

• Synchronizace kontaktů – Obousměrná synchronizace uživatelů a potenciálních zákazníků Intercom s kontakty Brevo
• Sledování konverzací – Synchronizujte data konverzací pro segmentaci řízenou podporou
• Mapování společností – Přiřazujte kontakty ke společnostem pro pracovní toky na základě účtů
• Vlastní atributy – Mapujte vlastní atributy Intercom na pole kontaktů Brevo
• Sledování událostí – Synchronizujte vlastní události a aktivity uživatelů pro behaviorální cílení
• Synchronizace štítků – Mapujte štítky Intercom na členství v seznamech Brevo nebo atributy
• Data Messenger – Sledujte zapojení v in-app komunikaci a chatové interakce
• Integrace AI agenta – Synchronizujte výsledky konverzací AI agenta s Brevo

Předpoklady

Než začnete, ujistěte se, že máte:

1. Pracovní prostor Intercom (plán Starter, Pro nebo Premium)
2. Aplikaci Intercom s přístupovým tokenem (soukromá aplikace) nebo nakonfigurovaný OAuth (veřejná aplikace)
3. Účet Brevo s přístupem k API
4. Účet Tajo

Ověření

Přístupový token (Soukromá aplikace)

Pro soukromé integrace přistupující k datům vlastního pracovního prostoru.

1. Přejděte do Developer Hub > Vaše aplikace > Vytvořit novou aplikaci
2. Přiřaďte ke svému pracovnímu prostoru Intercom
3. Zkopírujte přístupový 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 (Veřejná aplikace)

Pro integrace přistupující k datům Intercom jiných zákazníků.

# Autorizační URL
https://app.intercom.com/oauth?client_id={client_id}&state={state}

# Výměna tokenů
curl -X POST https://api.intercom.io/auth/eagle/token \
  -d "client_id={client_id}" \
  -d "client_secret={client_secret}" \
  -d "code={auth_code}"

Konfigurace

Základní nastavení

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

    # Možnosti synchronizace dat
    sync:
      contacts: true
      conversations: true
      companies: true
      events: true
      tags: true

    # Směr synchronizace
    direction: intercom_to_brevo

    # Přiřazení seznamů Brevo
    lists:
      all_users: 35
      active_conversations: 36
      leads: 37

Mapování polí

Mapujte data kontaktů Intercom na atributy kontaktů Brevo:

Mapování vlastních atributů

field_mapping:
  # Standardní pole
  email: email
  name: FULLNAME
  phone: SMS

  # Pole zapojení
  signed_up_at: SIGNUP_DATE
  last_seen_at: LAST_ACTIVE
  session_count: SESSION_COUNT
  unsubscribed_from_emails: UNSUBSCRIBED

  # Pole společnosti
  company.name: COMPANY_NAME
  company.plan: COMPANY_PLAN
  company.size: COMPANY_SIZE

  # Vlastní atributy
  custom_attributes.plan_tier: PLAN_TIER
  custom_attributes.feature_usage: FEATURE_USAGE

Koncové body API

API kontaktů

API konverzací

API společností

API událostí

Události

Události konverzací

Události kontaktů

Události uživatelů

Příklady kódu

Inicializace konektoru

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

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

// Připojení Intercom
await tajo.connectors.connect('intercom', {
  accessToken: process.env.INTERCOM_ACCESS_TOKEN,
  apiVersion: '2.11'
});

Synchronizace kontaktů a konverzací

// Úplná synchronizace kontaktů a dat konverzací
await tajo.connectors.sync('intercom', {
  type: 'full',
  resources: ['contacts', 'conversations', 'companies'],
  since: '2023-01-01'
});

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

Zpracování webhooků 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');
});

Omezení rychlosti

Intercom aplikuje limity rychlosti na základě vašeho plánu:

Další limity:

• Hromadné operace: 15 kontaktů na hromadný požadavek
• Odeslání událostí: 500 událostí/sekundu na pracovní prostor
• Doručení webhooků: Automatické opakování po dobu 24 hodin
• Export dat: 1 souběžný export

Řešení problémů

Časté problémy

Režim ladění

Povolte podrobné protokolování:

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

Test připojení

tajo connectors test intercom
# ✓ Připojení API úspěšné
# ✓ Kontakty čitelné
# ✓ Konverzace čitelné
# ✓ Společnosti čitelné
# ✓ Webhooky zaregistrovány

Osvědčené postupy

1. Připněte verzi API – Vždy specifikujte Intercom-Version pro zabránění zpětně nekompatibilním změnám
2. Efektivně používejte Search API – Používejte filtry a stránkování pro snížení přenosu dat
3. Synchronizujte uživatele i potenciální zákazníky – Zachyťte celý trychtýř v Brevo
4. Mapujte štítky konverzací – Používejte štítky konverzací pro marketingové segmenty po podpoře
5. Sledujte vlastní události – Odesílejte klíčové produktové události do Intercomu pro behaviorální cílení
6. Zpracovávejte sloučení kontaktů – Implementujte logiku sloučení pro duplicitní kontakty

Zabezpečení

• Přístupový token – Ověřování Bearer tokenem pro soukromé aplikace
• OAuth 2.0 – Delegovaná autorizace pro veřejné aplikace s client secret
• Ověření webhooků – Ověření podpisu HMAC SHA-1 přes X-Hub-Signature
• Šifrování TLS – Veškerá komunikace API šifrovaná přes HTTPS
• Řízení přístupu k datům – Granulární přístup k datům podle konfigurace aplikace

Související zdroje

• Dokumentace pro vývojáře Intercom
• Reference API Intercom
• Konektor Zendesk
• Dovednost synchronizace zákazníků
• API kontaktů Brevo