Σύνδεσμος ActiveCampaign

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

Επισκόπηση

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

• Μετεγκατάσταση επαφών - Μετεγκατάσταση επαφών με προσαρμοσμένα πεδία, tags και συμμετοχές λίστας
• Συγχρονισμός pipeline deal - Συγχρονισμός σταδίων deal, αξιών και ιδιοκτητών για παρακολούθηση εσόδων
• Αντιστοίχηση αυτοματισμού - Αντιστοίχηση αυτοματισμών ActiveCampaign σε ενεργοποιητές ροής εργασίας Brevo
• Παρακολούθηση εκδηλώσεων - Συγχρονισμός παρακολούθησης τοποθεσίας και προσαρμοσμένων εκδηλώσεων για συμπεριφορική τμηματοποίηση
• Συγχρονισμός λίστας και tag - Αναπαραγωγή δομών λίστας και τμημάτων βάσει tag στο Brevo
• Ενσωμάτωση ηλεκτρονικού εμπορίου - Συγχρονισμός Deep Data (παραγγελίες, πελάτες, καλάθια) στο Brevo
• Συγχρονισμός προσαρμοσμένων αντικειμένων - Αντιστοίχηση προσαρμοσμένων αντικειμένων ActiveCampaign σε χαρακτηριστικά Brevo
• Συγχρονισμός βαθμολογίας - Μεταφορά βαθμολογιών lead και επαφής σε χαρακτηριστικά Brevo

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

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

1. Λογαριασμό ActiveCampaign (Lite, Plus, Professional ή Enterprise)
2. URL API και κλειδί API από Ρυθμίσεις > Developer
3. Λογαριασμό Brevo με πρόσβαση API
4. Λογαριασμό Tajo

Πιστοποίηση

Πιστοποίηση με API Key

Το ActiveCampaign χρησιμοποιεί κλειδί API που μεταβιβάζεται ως header ή παράμετρος ερωτήματος.

curl "https://{account}.api-us1.com/api/3/contacts" \
  -H "Api-Token: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Βρείτε το URL API και το κλειδί σας στο ActiveCampaign Ρυθμίσεις > Developer.

Διαμόρφωση

Βασική Ρύθμιση

connectors:
  activecampaign:
    enabled: true
    api_url: "https://yourcompany.api-us1.com"
    api_key: "${AC_API_KEY}"

    # Data sync options
    sync:
      contacts: true
      deals: true
      automations: true
      events: true
      ecommerce: true

    # List mapping to Brevo
    list_mapping:
      "Main List": 50
      "Newsletter": 51
      "Customers": 52

Αντιστοίχιση Πεδίων

Αντιστοίχηση πεδίων ActiveCampaign σε χαρακτηριστικά επαφών Brevo:

Αντιστοίχιση Προσαρμοσμένων Πεδίων

field_mapping:
  # Standard fields
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  phone: SMS

  # Engagement fields
  score: LEAD_SCORE
  rating: ENGAGEMENT_RATING

  # Deal fields
  deals.value: DEAL_VALUE
  deals.stage: DEAL_STAGE
  deals.owner: DEAL_OWNER

  # Custom fields
  fieldValues.company: COMPANY_NAME
  fieldValues.industry: INDUSTRY
  fieldValues.plan_tier: PLAN_TIER

Endpoints API

Επαφές

Deals

Αυτοματισμοί

Ηλεκτρονικό Εμπόριο (Deep Data)

Παρακολούθηση Εκδηλώσεων

Εκδηλώσεις

Εκδηλώσεις Επαφής

Εκδηλώσεις Deal

Εκδηλώσεις Αυτοματισμού

Παραδείγματα Κώδικα

Αρχικοποίηση Συνδέσμου

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

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

// Connect ActiveCampaign
await tajo.connectors.connect('activecampaign', {
  apiUrl: process.env.AC_API_URL,
  apiKey: process.env.AC_API_KEY
});

Μετεγκατάσταση Επαφών στο Brevo

// Full contact migration with custom fields and tags
await tajo.connectors.sync('activecampaign', {
  type: 'full',
  resources: ['contacts', 'deals', 'events'],
  options: {
    includeTags: true,
    includeCustomFields: true,
    includeScores: true,
    includeListMemberships: true
  }
});

// Check sync status
const status = await tajo.connectors.status('activecampaign');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsMigrated: 28000,
//   dealsSynced: 4500,
//   eventsSynced: 120000
// }

Παρακολούθηση Προσαρμοσμένων Εκδηλώσεων

// Forward ActiveCampaign events to Brevo
await tajo.activecampaign.trackEvent({
  email: '[email protected]',
  event: 'product_demo_requested',
  eventData: {
    product: 'Enterprise Plan',
    source: 'website'
  }
});

Όρια Ρυθμού

Όρια ρυθμού API ActiveCampaign:

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

• Μαζική εισαγωγή: 250 επαφές ανά batch
• Συχνότητα μαζικής εισαγωγής: 1 εισαγωγή τη φορά
• Παρακολούθηση εκδηλώσεων: 2 αιτήματα/δευτερόλεπτο
• Ημερήσιο όριο: Χωρίς ρητό ημερήσιο όριο (μόνο βάσει ρυθμού)

Αντιμετώπιση Προβλημάτων

Συνήθη Προβλήματα

Λειτουργία Εντοπισμού Σφαλμάτων

Ενεργοποιήστε λεπτομερή καταγραφή:

connectors:
  activecampaign:
    debug: true
    log_level: verbose
    log_webhooks: true

Δοκιμή Σύνδεσης

tajo connectors test activecampaign
# ✓ API connection successful
# ✓ Contacts readable
# ✓ Deals readable
# ✓ Automations accessible
# ✓ Event tracking enabled

Βέλτιστες Πρακτικές

1. Χρησιμοποιήστε endpoint συγχρονισμού επαφής - Χρησιμοποιήστε /contact/sync για λειτουργίες upsert αντί ξεχωριστής δημιουργίας/ενημέρωσης
2. Αντιστοιχίστε πεδία κατά ID - Τα IDs προσαρμοσμένων πεδίων είναι σταθερά· οι ετικέτες μπορούν να αλλάξουν
3. Διατηρήστε συμμετοχές λίστας - Μεταφέρετε αναθέσεις λίστας μαζί με δεδομένα επαφής
4. Συγχρονίστε pipelines deal - Αντιστοιχίστε στάδια pipeline για συνεπή αναφορά CRM
5. Εφαρμόστε παρακολούθηση εκδηλώσεων - Χρησιμοποιήστε παρακολούθηση τοποθεσίας για συμπεριφορικά δεδομένα στο Brevo
6. Εισαγωγές batch - Χρησιμοποιήστε μαζική εισαγωγή για σύνολα δεδομένων μεγαλύτερα από 1.000 επαφές

Ασφάλεια

• Πιστοποίηση API Key - Πρόσβαση βάσει token μέσω header Api-Token
• Επικύρωση webhook - Επικύρωση εύρους IP πηγής webhook
• Κρυπτογράφηση TLS - Όλη η επικοινωνία API κρυπτογραφείται μέσω HTTPS
• Πρόσβαση επιπέδου λογαριασμού - Το κλειδί API παρέχει πλήρη πρόσβαση λογαριασμού· χρησιμοποιήστε με προσοχή
• Περιορισμοί IP - Διαθέσιμο σε Enterprise πλάνα

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

• Τεκμηρίωση API ActiveCampaign
• Οδηγός Webhook ActiveCampaign
• Σύνδεσμος Mailchimp
• Σύνδεσμος Brevo
• Δεξιότητα Συγχρονισμού Πελατών