Intercom कनेक्टर

एकीकृत ग्राहक मैसेजिंग, conversation ट्रैकिंग, और आपके सपोर्ट और product डेटा द्वारा संचालित engagement-संचालित मार्केटिंग ऑटोमेशन के लिए अपने Intercom workspace को Tajo के माध्यम से Brevo से कनेक्ट करें।

अवलोकन

विशेषताएं

• कॉन्टैक्ट सिंक - Brevo कॉन्टैक्ट्स के साथ Intercom users और leads का द्विदिशीय sync
• Conversation ट्रैकिंग - support-संचालित सेगमेंटेशन के लिए conversation डेटा सिंक करें
• कंपनी मैपिंग - account-आधारित workflows के लिए कंपनियों के साथ कॉन्टैक्ट्स को संबद्ध करें
• कस्टम एट्रिब्यूट्स - Intercom कस्टम एट्रिब्यूट्स को Brevo कॉन्टैक्ट फ़ील्ड्स में मैप करें
• इवेंट ट्रैकिंग - व्यवहारिक targeting के लिए कस्टम इवेंट्स और उपयोगकर्ता गतिविधियां सिंक करें
• Tag सिंक - Intercom tags को Brevo list membership या एट्रिब्यूट्स में मैप करें
• Messenger डेटा - in-app मैसेजिंग engagement और chat इंटरैक्शन्स ट्रैक करें
• AI agent इंटीग्रेशन - AI agent conversation outcomes को Brevo के साथ सिंक करें

पूर्वावश्यकताएं

शुरू करने से पहले, सुनिश्चित करें कि आपके पास है:

1. एक Intercom workspace (Starter, Pro, या Premium प्लान)
2. access token के साथ एक Intercom ऐप (private app) या OAuth कॉन्फ़िगर (public app)
3. API एक्सेस वाला एक Brevo खाता
4. एक Tajo खाता

प्रमाणीकरण

Access Token (Private App)

निजी integrations के लिए जो आपके अपने workspace डेटा तक पहुंचते हैं।

1. Developer Hub > Your Apps > Create new app पर जाएं
2. अपने Intercom workspace के साथ संबद्ध करें
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 (Public App)

integrations के लिए जो अन्य customers’ 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

API एंडपॉइंट्स

Contacts API

Conversations API

Companies API

Events API

इवेंट्स

Conversation इवेंट्स

कॉन्टैक्ट इवेंट्स

User इवेंट्स

कोड उदाहरण

कनेक्टर प्रारंभ करें

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

कॉन्टैक्ट्स और Conversations सिंक करें

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

Intercom Webhooks हैंडल करें

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 आपके प्लान के आधार पर दर सीमाएं लागू करता है:

अतिरिक्त सीमाएं:

• Bulk operations: 15 कॉन्टैक्ट्स प्रति bulk अनुरोध
• Event सबमिशन: 500 इवेंट्स/सेकंड प्रति workspace
• Webhook डिलीवरी: 24 घंटे के लिए स्वचालित रीट्राई
• Data export: 1 समवर्ती export

समस्या निवारण

सामान्य समस्याएं

डीबग मोड

विस्तृत लॉगिंग सक्षम करें:

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 version pin करें - breaking changes से बचने के लिए हमेशा Intercom-Version निर्दिष्ट करें
2. search API का कुशलता से उपयोग करें - डेटा transfer कम करने के लिए filters और pagination का उपयोग करें
3. users और leads दोनों सिंक करें - Brevo में पूर्ण funnel कैप्चर करें
4. conversation tags मैप करें - पोस्ट-सपोर्ट मार्केटिंग segments के लिए conversation tags का उपयोग करें
5. कस्टम इवेंट्स ट्रैक करें - व्यवहारिक targeting के लिए मुख्य product इवेंट्स को Intercom में सबमिट करें
6. contact merges हैंडल करें - डुप्लिकेट कॉन्टैक्ट्स के लिए merge logic लागू करें

सुरक्षा

• Access Token - private apps के लिए Bearer token प्रमाणीकरण
• OAuth 2.0 - client secret के साथ public apps के लिए delegated authorization
• Webhook सत्यापन - X-Hub-Signature के माध्यम से HMAC SHA-1 सिग्नेचर सत्यापन
• TLS एन्क्रिप्शन - सभी API संचार HTTPS के माध्यम से एन्क्रिप्टेड
• Data access नियंत्रण - प्रति app कॉन्फ़िगरेशन granular डेटा एक्सेस

संबंधित संसाधन

• Intercom Developer Documentation
• Intercom API Reference
• Zendesk Connector
• Customer Sync Skill
• Brevo Contacts API