Intercom کنیکٹر

متحدہ گاہک پیغام رسانی، گفتگو ٹریکنگ، اور آپ کے سپورٹ اور پروڈکٹ ڈیٹا سے چلنے والی engagement پر مبنی مارکیٹنگ آٹومیشن کے لیے Tajo کے ذریعے اپنے Intercom ورک اسپیس کو Brevo سے منسلک کریں۔

جائزہ

خصوصیات

• رابطہ سنک - Brevo رابطوں کے ساتھ Intercom صارفین اور لیڈز کا دو طرفہ سنک
• گفتگو ٹریکنگ - سپورٹ سے چلنے والی segmentation کے لیے گفتگو ڈیٹا سنک کریں
• کمپنی میپنگ - account پر مبنی ورک فلوز کے لیے رابطوں کو کمپنیوں سے منسلک کریں
• کسٹم خصوصیات - Intercom کسٹم خصوصیات کو Brevo رابطہ فیلڈز پر میپ کریں
• ایونٹ ٹریکنگ - رویاتی targeting کے لیے کسٹم ایونٹس اور صارف سرگرمیاں سنک کریں
• ٹیگ سنک - Intercom ٹیگز کو Brevo فہرست رکنیت یا خصوصیات پر میپ کریں
• Messenger ڈیٹا - in-app پیغام رسانی engagement اور چیٹ تعاملات ٹریک کریں
• AI agent انٹیگریشن - AI agent گفتگو کے نتائج کو Brevo کے ساتھ سنک کریں

شرائط

شروع کرنے سے پہلے، یقینی بنائیں کہ آپ کے پاس ہے:

1. Intercom ورک اسپیس (Starter, Pro, یا Premium plan)
2. access token (private app) کے ساتھ Intercom ایپ یا OAuth ترتیب دیا گیا (public app)
3. API رسائی کے ساتھ Brevo اکاؤنٹ
4. Tajo اکاؤنٹ

تصدیق

Access Token (Private App)

پرائیویٹ انٹیگریشنز کے لیے جو آپ کے اپنے ورک اسپیس ڈیٹا تک رسائی حاصل کرتے ہیں۔

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 (Public App)

ان انٹیگریشنز کے لیے جو دیگر گاہکوں کے 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

ایونٹس

گفتگو ایونٹس

رابطہ ایونٹس

صارف ایونٹس

کوڈ کی مثالیں

کنیکٹر کو انیشیلائز کریں

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

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 آپ کے پلان کی بنیاد پر شرح کی حدود لاگو کرتا ہے:

اضافی حدود:

• بلک آپریشنز: 15 رابطے فی بلک درخواست
• ایونٹ سبمیشنز: 500 ایونٹس/سیکنڈ فی ورک اسپیس
• Webhook ڈیلیوری: 24 گھنٹوں کے لیے خودکار retry
• 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 کو موثر طریقے سے استعمال کریں - ڈیٹا منتقلی کم کرنے کے لیے فلٹرز اور pagination استعمال کریں
3. صارفین اور leads دونوں سنک کریں - Brevo میں مکمل funnel capture کریں
4. گفتگو ٹیگز میپ کریں - سپورٹ کے بعد مارکیٹنگ سیگمنٹس کے لیے گفتگو ٹیگز استعمال کریں
5. کسٹم ایونٹس ٹریک کریں - رویاتی targeting کے لیے Intercom کو اہم پروڈکٹ ایونٹس submit کریں
6. رابطہ merges کو سنبھالیں - ڈپلیکیٹ رابطوں کے لیے merge لاجک نافذ کریں

سیکیورٹی

• Access Token - private apps کے لیے Bearer token تصدیق
• OAuth 2.0 - client secret کے ساتھ public apps کے لیے delegated اجازت
• Webhook توثیق - X-Hub-Signature کے ذریعے HMAC SHA-1 دستخط کی توثیق
• TLS انکرپشن - تمام API مواصلات HTTPS کے ذریعے انکرپٹڈ
• ڈیٹا رسائی کنٹرول - فی ایپ تشکیل گرانولر ڈیٹا رسائی

متعلقہ وسائل

• Intercom Developer دستاویزات
• Intercom API Reference
• Zendesk کنیکٹر
• گاہک سنک اسکل
• Brevo Contacts API