HubSpot Konektor

HubSpot Konektor

Povežite svoj HubSpot CRM s Brevom putem Taja za dvosmjernu sinkronizaciju kontakata, praćenje poslova, angažmanske podatke i unificiranu marketinšku automatizaciju na obje platforme.

Pregled

Značajke

• Dvosmjerna sinkronizacija kontakata - Zadržite kontakte sinkroniziranim između HubSpota i Breva u stvarnom vremenu
• Praćenje prodajnog cjevovoda - Sinkronizirajte faze i vrijednosti poslova za segmentaciju temeljenu na prihodima
• Sinkronizacija podataka o tvrtkama - Povežite kontakte s evidencijama tvrtki i firmografskim podacima
• Integracija tiketa - Pratite tikete za podršku radi ocjenjivanja zdravlja korisnika
• Praćenje angažmana - Sinkronizirajte otvaranja e-pošte, klikove, sastanke, pozive i bilješke
• Podrška za prilagođene objekte - Mapirajte prilagođene HubSpot objekte na atribute Breva
• Okidači tijekova rada - Koristite promjene životnog ciklusa u HubSpotu za pokretanje automatizacija u Brevu
• Webhook događaji - Obavijesti u stvarnom vremenu o promjenama CRM podataka

Preduvjeti

Prije nego što počnete, osigurajte da imate:

1. HubSpot račun (Besplatni, Starter, Professional ili Enterprise)
2. HubSpot privatnu aplikaciju ili OAuth aplikaciju s potrebnim opsezima
3. Brevo račun s API pristupom
4. Tajo račun

Autentifikacija

Token za pristup privatnoj aplikaciji (Preporučeno)

Stvorite privatnu aplikaciju u HubSpotu za izravan API pristup s granularnom kontrolom opsega.

1. Idite na HubSpot Postavke > Integracije > Privatne aplikacije
2. Stvorite novu privatnu aplikaciju
3. Konfigurirajte potrebne opsege
4. Kopirajte token za pristup

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

Koristite OAuth 2.0 za integracije s više računa koje zahtijevaju korisničku autorizaciju.

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

Potrebni opsezi

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

Konfiguracija

Osnovna konfiguracija

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

    # Opcije sinkronizacije podataka
    sync:
      contacts: true
      companies: true
      deals: true
      tickets: true
      engagements: true

    # Smjer sinkronizacije
    direction: bidirectional  # ili 'hubspot_to_brevo' | 'brevo_to_hubspot'

    # Dodjela popisa u Brevu
    lists:
      all_contacts: 10
      qualified_leads: 11
      customers: 12

Mapiranje polja

Mapirajte HubSpot svojstva na atribute kontakata u Brevu:

Mapiranje prilagođenih svojstava

field_mapping:
  # Standardna polja
  email: email
  firstname: FIRSTNAME
  lastname: LASTNAME
  phone: SMS

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

  # Metrike poslova
  hs_total_deal_value: DEAL_VALUE
  num_associated_deals: DEAL_COUNT

  # Prilagođena svojstva
  preferred_channel: PREFERRED_CHANNEL
  customer_segment: SEGMENT

API krajnje točke

CRM objekti

Asocijacije

Angažmani

Događaji

Događaji kontakata

Događaji poslova

Događaji tvrtki

Primjeri koda

Inicijalizacija konektora

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

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

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

Pokretanje sinkronizacije kontakata

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

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

Rukovanje Webhook događajima

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

  // Verifikacija webhook potpisa
  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');
});

Ograničenja brzine

HubSpot primjenjuje ograničenja brzine po privatnoj ili OAuth aplikaciji:

Dodatna ograničenja:

• Search API: 5 zahtjeva/sekundi po aplikaciji
• Skupne operacije: 100 zapisa po skupnom zahtjevu
• Dnevno ograničenje: 500.000 zahtjeva/dan (OAuth aplikacije)

Rješavanje problema

Uobičajeni problemi

Način otklanjanja grešaka

Omogućite opširno zapisivanje:

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

Testiranje veze

tajo connectors test hubspot
# ✓ API veza uspješna
# ✓ Kontakti čitljivi
# ✓ Tvrtke čitljive
# ✓ Poslovi čitljivi
# ✓ Webhooks registrirani

Preporučene prakse

1. Koristite privatne aplikacije umjesto API ključeva - API ključevi su zastarjeli; koristite privatne aplikacije za bolju sigurnost
2. Pažljivo implementirajte dvosmjernu sinkronizaciju - Izbjegavajte beskonačne petlje praćenjem izvora sinkronizacije
3. Mapirajte faze životnog ciklusa - Koristite faze životnog ciklusa HubSpota za segmentaciju kontakata u Brevu
4. Skupni API zahtjevi - Koristite skupne krajnje točke za masovne operacije kako biste ostali u granicama
5. Pratite isporuku webhookova - Postavite logiku ponovnog pokušaja i rukovanje mrtvim pismima
6. Koristite inkrementalnu sinkronizaciju - Sinkronizirajte samo promijenjene zapise koristeći svojstvo lastmodifieddate

Sigurnost

• Tokeni privatnih aplikacija - Opsežni tokeni za pristup s granularnim dozvolama
• OAuth 2.0 - Industrijski standardna autorizacija s rotacijom tokena za osvježavanje
• Webhook potpisi - Verifikacija potpisa temeljena na HMAC-u (v3)
• TLS enkripcija - Sva API komunikacija šifrirana u tranzitu
• Opsežne dozvole - Minimalni potrebni pristup opsegu po integraciji

Povezani resursi

• HubSpot API dokumentacija
• HubSpot vodič za autentifikaciju
• Salesforce Konektor
• Vještina sinkronizacije korisnika
• Brevo API kontakata