Σύνδεσμος HubSpot

Σύνδεσμος HubSpot

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

Επισκόπηση

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

• Αμφίδρομος συγχρονισμός επαφών - Διατηρήστε τις επαφές συγχρονισμένες μεταξύ HubSpot και Brevo σε πραγματικό χρόνο
• Παρακολούθηση pipeline συμφωνιών - Συγχρονισμός σταδίων συμφωνιών και αξιών για τμηματοποίηση βάσει εσόδων
• Συγχρονισμός δεδομένων εταιρείας - Συσχέτιση επαφών με εγγραφές εταιρειών και firmographic δεδομένα
• Ενσωμάτωση αιτημάτων - Παρακολούθηση αιτημάτων υποστήριξης για βαθμολόγηση υγείας πελατών
• Παρακολούθηση αλληλεπιδράσεων - Συγχρονισμός ανοιγμάτων email, κλικ, συναντήσεων, κλήσεων και σημειώσεων
• Υποστήριξη προσαρμοσμένων αντικειμένων - Αντιστοίχιση προσαρμοσμένων αντικειμένων HubSpot σε χαρακτηριστικά Brevo
• Ενεργοποιητές ροής εργασίας - Χρήση αλλαγών σταδίου κύκλου ζωής HubSpot για ενεργοποίηση αυτοματισμών Brevo
• Εκδηλώσεις webhook - Ειδοποιήσεις σε πραγματικό χρόνο για αλλαγές δεδομένων CRM

Προαπαιτούμενα

Πριν ξεκινήσετε, βεβαιωθείτε ότι διαθέτετε:

1. Λογαριασμό HubSpot (Free, Starter, Professional ή Enterprise)
2. Ιδιωτική εφαρμογή HubSpot ή εφαρμογή OAuth με τα απαραίτητα scopes
3. Λογαριασμό Brevo με πρόσβαση API
4. Λογαριασμό Tajo

Πιστοποίηση

Token Πρόσβασης Ιδιωτικής Εφαρμογής (Συνιστάται)

Δημιουργήστε μια ιδιωτική εφαρμογή στο HubSpot για άμεση πρόσβαση API με λεπτομερή έλεγχο scope.

1. Μεταβείτε στο HubSpot Settings > Integrations > Private Apps
2. Δημιουργήστε νέα ιδιωτική εφαρμογή
3. Ρυθμίστε τα απαιτούμενα scopes
4. Αντιγράψτε το token πρόσβασης

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}

Απαιτούμενα Scopes

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

Endpoints 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:

Πρόσθετα όρια:

• Search API: 5 αιτήματα/δευτερόλεπτο ανά εφαρμογή
• Λειτουργίες Batch: 100 εγγραφές ανά αίτημα batch
• Ημερήσιο όριο: 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 keys - Τα API keys είναι deprecated· χρησιμοποιήστε ιδιωτικές εφαρμογές για καλύτερη ασφάλεια
2. Εφαρμόστε αμφίδρομο συγχρονισμό προσεκτικά - Αποφύγετε άπειρες επαναλήψεις παρακολουθώντας την πηγή συγχρονισμού
3. Αντιστοιχίστε στάδια κύκλου ζωής - Χρησιμοποιήστε στάδια κύκλου ζωής HubSpot για τμηματοποίηση επαφών στο Brevo
4. Αιτήματα API σε batch - Χρησιμοποιήστε endpoints batch για μαζικές λειτουργίες εντός των ορίων ρυθμού
5. Παρακολούθηση παράδοσης webhook - Ρυθμίστε λογική επανάληψης και χειρισμό νεκρών γραμμάτων
6. Χρησιμοποιήστε σταδιακό συγχρονισμό - Συγχρονίστε μόνο αλλαγμένες εγγραφές χρησιμοποιώντας την ιδιότητα lastmodifieddate

Ασφάλεια

• Tokens Ιδιωτικής Εφαρμογής - Tokens πρόσβασης με περιορισμένα δικαιώματα
• OAuth 2.0 - Τυπική βιομηχανική εξουσιοδότηση με εναλλαγή refresh token
• Υπογραφές Webhook - Επαλήθευση υπογραφής βάσει HMAC (v3)
• Κρυπτογράφηση TLS - Όλη η επικοινωνία API κρυπτογραφημένη κατά τη μεταφορά
• Δικαιώματα βάσει scope - Ελάχιστη απαιτούμενη πρόσβαση scope ανά ενσωμάτωση

Σχετικοί Πόροι

• Τεκμηρίωση API HubSpot
• Οδηγός Πιστοποίησης HubSpot
• Σύνδεσμος Salesforce
• Δεξιότητα Συγχρονισμού Πελατών
• API Επαφών Brevo