HubSpot کنیکٹر

HubSpot کنیکٹر

دو طرفہ رابطہ سنک، ڈیل ٹریکنگ، مصروفیت ڈیٹا، اور دونوں پلیٹ فارمز پر متحدہ مارکیٹنگ آٹومیشن کے لیے Tajo کے ذریعے اپنے HubSpot CRM کو Brevo سے منسلک کریں۔

جائزہ

خصوصیات

• دو طرفہ رابطہ سنک - HubSpot اور Brevo کے درمیان رابطوں کو ریئل ٹائم میں سنک رکھیں
• ڈیل پائپ لائن ٹریکنگ - آمدنی پر مبنی سیگمنٹیشن کے لیے ڈیل مراحل اور اقدار سنک کریں
• کمپنی ڈیٹا سنک - رابطوں کو کمپنی ریکارڈز اور firmographic ڈیٹا سے منسلک کریں
• ٹکٹ انٹیگریشن - گاہک کی صحت کی اسکورنگ کے لیے سپورٹ ٹکٹس ٹریک کریں
• مصروفیت ٹریکنگ - ای میل اوپن، کلکس، میٹنگز، کالز، اور نوٹس سنک کریں
• کسٹم آبجیکٹ سپورٹ - HubSpot کسٹم آبجیکٹس کو Brevo خصوصیات پر میپ کریں
• ورک فلو ٹرگرز - Brevo آٹومیشن ٹرگر کرنے کے لیے HubSpot لائف سائیکل مرحلے کی تبدیلیاں استعمال کریں
• Webhook ایونٹس - CRM ڈیٹا تبدیلیوں کے لیے ریئل ٹائم نوٹیفکیشنز

شرائط

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

1. HubSpot اکاؤنٹ (Free, Starter, Professional, یا Enterprise)
2. مطلوبہ اسکوپس کے ساتھ HubSpot پرائیویٹ ایپ یا OAuth ایپ
3. API رسائی کے ساتھ Brevo اکاؤنٹ
4. Tajo اکاؤنٹ

تصدیق

پرائیویٹ ایپ ایکسیس ٹوکن (تجویز کردہ)

گرانولر اسکوپ کنٹرول کے ساتھ براہ راست API رسائی کے لیے HubSpot میں ایک پرائیویٹ ایپ بنائیں۔

1. HubSpot Settings > Integrations > Private Apps پر جائیں
2. ایک نئی پرائیویٹ ایپ بنائیں
3. مطلوبہ اسکوپس ترتیب دیں
4. ایکسیس ٹوکن کاپی کریں

curl -X GET "https://api.hubapi.com/crm/v3/objects/contacts" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

OAuth 2.0

ملٹی اکاؤنٹ انٹیگریشنز کے لیے OAuth 2.0 استعمال کریں جن کے لیے صارف کی اجازت درکار ہوتی ہے۔

# Authorization URL
https://app.hubspot.com/oauth/authorize?client_id={client_id}&scope=crm.objects.contacts.read&redirect_uri={redirect_uri}

مطلوبہ اسکوپس

crm.objects.contacts.read
crm.objects.contacts.write
crm.objects.companies.read
crm.objects.deals.read
crm.objects.deals.write
crm.objects.custom.read
crm.schemas.custom.read

تشکیل

بنیادی سیٹ اپ

connectors:
  hubspot:
    enabled: true
    access_token: "${HUBSPOT_ACCESS_TOKEN}"

    # Data sync options
    sync:
      contacts: true
      companies: true
      deals: true
      tickets: true
      engagements: true

    # Sync direction
    direction: bidirectional  # or 'hubspot_to_brevo' | 'brevo_to_hubspot'

    # List assignment in Brevo
    lists:
      all_contacts: 10
      qualified_leads: 11
      customers: 12

فیلڈ میپنگ

HubSpot خصوصیات کو Brevo رابطہ خصوصیات پر میپ کریں:

کسٹم خصوصیت میپنگ

field_mapping:
  # Standard fields
  email: email
  firstname: FIRSTNAME
  lastname: LASTNAME
  phone: SMS

  # CRM fields
  lifecyclestage: LIFECYCLE_STAGE
  hs_lead_status: LEAD_STATUS
  company: COMPANY_NAME

  # Deal metrics
  hs_total_deal_value: DEAL_VALUE
  num_associated_deals: DEAL_COUNT

  # Custom properties
  preferred_channel: PREFERRED_CHANNEL
  customer_segment: SEGMENT

API اینڈ پوائنٹس

CRM آبجیکٹس

ایسوسی ایشنز

مصروفیات

ایونٹس

رابطہ ایونٹس

ڈیل ایونٹس

کمپنی ایونٹس

کوڈ کی مثالیں

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

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

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

// Connect HubSpot
await tajo.connectors.connect('hubspot', {
  accessToken: process.env.HUBSPOT_ACCESS_TOKEN
});

رابطہ سنک چلائیں

// Full bidirectional sync
await tajo.connectors.sync('hubspot', {
  type: 'full',
  resources: ['contacts', 'companies', 'deals'],
  direction: 'bidirectional',
  since: '2023-01-01'
});

// Check sync status
const status = await tajo.connectors.status('hubspot');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsSynced: 34200,
//   companiesSynced: 5100,
//   dealsSynced: 2340
// }

Webhook ایونٹس کو سنبھالیں

// Handle HubSpot webhook notifications
app.post('/webhooks/hubspot', async (req, res) => {
  const signature = req.get('X-HubSpot-Signature-v3');

  // Verify webhook signature
  if (!verifyHubSpotSignature(req.body, signature)) {
    return res.status(401).send('Unauthorized');
  }

  for (const event of req.body) {
    await tajo.connectors.handleWebhook('hubspot', {
      eventType: event.subscriptionType,
      objectId: event.objectId,
      propertyName: event.propertyName,
      propertyValue: event.propertyValue
    });
  }

  res.status(200).send('OK');
});

شرح کی حدود

HubSpot فی پرائیویٹ ایپ یا OAuth ایپ شرح کی حدود لاگو کرتا ہے:

اضافی حدود:

• سرچ API: 5 درخواستیں/سیکنڈ فی ایپ
• بیچ آپریشنز: 100 ریکارڈز فی بیچ درخواست
• روزانہ حد: 500,000 درخواستیں/دن (OAuth ایپس)

ٹربل شوٹنگ

عام مسائل

ڈیبگ موڈ

تفصیلی لاگنگ فعال کریں:

connectors:
  hubspot:
    debug: true
    log_level: verbose
    log_webhooks: true

کنکشن ٹیسٹ کریں

tajo connectors test hubspot
# ✓ API connection successful
# ✓ Contacts readable
# ✓ Companies readable
# ✓ Deals readable
# ✓ Webhooks registered

بہترین طرز عمل

1. API کیز کی بجائے پرائیویٹ ایپس استعمال کریں - API کیز متروک ہیں؛ بہتر سیکیورٹی کے لیے پرائیویٹ ایپس استعمال کریں
2. دو طرفہ سنک کو احتیاط سے نافذ کریں - سنک سورس کو ٹریک کرکے لامتناہی لوپس سے بچیں
3. لائف سائیکل مراحل میپ کریں - Brevo میں رابطوں کو سیگمنٹ کرنے کے لیے HubSpot لائف سائیکل مراحل استعمال کریں
4. بیچ API درخواستیں - شرح کی حدود کے اندر رہنے کے لیے بلک آپریشنز کے لیے بیچ اینڈ پوائنٹس استعمال کریں
5. Webhook ڈیلیوری کی نگرانی کریں - ری ٹرائی لاجک اور ڈیڈ لیٹر ہینڈلنگ ترتیب دیں
6. انکریمنٹل سنک استعمال کریں - صرف تبدیل شدہ ریکارڈز کو lastmodifieddate خصوصیت کا استعمال کرتے ہوئے سنک کریں

سیکیورٹی

• پرائیویٹ ایپ ٹوکنز - گرانولر اجازتوں کے ساتھ اسکوپڈ ایکسیس ٹوکنز
• OAuth 2.0 - ریفریش ٹوکن روٹیشن کے ساتھ صنعتی معیار کی اجازت
• Webhook دستخط - HMAC پر مبنی دستخط کی توثیق (v3)
• TLS انکرپشن - تمام API مواصلات ٹرانزٹ میں انکرپٹڈ
• اسکوپڈ اجازتیں - فی انٹیگریشن کم از کم مطلوبہ اسکوپ رسائی

متعلقہ وسائل

• HubSpot API دستاویزات
• HubSpot تصدیق گائیڈ
• Salesforce کنیکٹر
• گاہک سنک اسکل
• Brevo Contacts API