Σύνδεσμος Salesforce

Σύνδεσμος Salesforce

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

Επισκόπηση

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

• Αμφίδρομος συγχρονισμός επαφών/leads - Συγχρονισμός επαφών και leads Salesforce με λίστες επαφών Brevo
• Παρακολούθηση ευκαιριών - Αντιστοίχιση σταδίων συμφωνίας και ποσών για τμηματοποίηση βάσει εσόδων
• Ιεραρχία λογαριασμών - Συγχρονισμός εταιρικών λογαριασμών για marketing βάσει λογαριασμών στο Brevo
• Αντιστοίχιση προσαρμοσμένων αντικειμένων - Αντιστοίχιση προσαρμοσμένων αντικειμένων Salesforce σε χαρακτηριστικά και εκδηλώσεις Brevo
• Συγχρονισμός μελών καμπάνιας - Συγχρονισμός μελών καμπάνιας Salesforce με λίστες Brevo
• Παρακολούθηση δραστηριοτήτων - Συγχρονισμός εργασιών, εκδηλώσεων και δραστηριοτήτων email για βαθμολόγηση αλληλεπίδρασης
• Ροή σε πραγματικό χρόνο - Χρήση Streaming API Salesforce για άμεσες ενημερώσεις δεδομένων
• Υποστήριξη ερωτημάτων SOQL - Φιλτράρισμα συγχρονισμένων δεδομένων με προσαρμοσμένα ερωτήματα SOQL

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

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

1. Οργανισμό Salesforce (οποιαδήποτε έκδοση με πρόσβαση API)
2. Συνδεδεμένη Εφαρμογή ρυθμισμένη στο Salesforce Setup
3. Ενεργοποιημένη πρόσβαση API για το προφίλ χρήστη Salesforce
4. Λογαριασμό Brevo με πρόσβαση API
5. Λογαριασμό Tajo

Πιστοποίηση

Ροή Web Server OAuth 2.0 (Συνιστάται)

Ιδανική για ενσωματώσεις παραγωγής με εξουσιοδότηση χρήστη.

# Step 1: Authorize
https://login.salesforce.com/services/oauth2/authorize?
  response_type=code&
  client_id={consumer_key}&
  redirect_uri={callback_url}

# Step 2: Exchange code for tokens
curl -X POST https://login.salesforce.com/services/oauth2/token \
  -d "grant_type=authorization_code" \
  -d "code={auth_code}" \
  -d "client_id={consumer_key}" \
  -d "client_secret={consumer_secret}" \
  -d "redirect_uri={callback_url}"

Ροή Ονόματος Χρήστη-Κωδικού

Για ενσωματώσεις server-to-server χωρίς αλληλεπίδραση χρήστη.

curl -X POST https://login.salesforce.com/services/oauth2/token \
  -d "grant_type=password" \
  -d "client_id={consumer_key}" \
  -d "client_secret={consumer_secret}" \
  -d "username={username}" \
  -d "password={password}{security_token}"

Διαμόρφωση

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

connectors:
  salesforce:
    enabled: true
    instance_url: "https://yourorg.my.salesforce.com"
    api_version: "v59.0"
    auth:
      type: oauth2
      consumer_key: "${SF_CONSUMER_KEY}"
      consumer_secret: "${SF_CONSUMER_SECRET}"
      refresh_token: "${SF_REFRESH_TOKEN}"

    # Data sync options
    sync:
      contacts: true
      leads: true
      accounts: true
      opportunities: true
      campaigns: true

    # Sync direction
    direction: salesforce_to_brevo

    # Brevo list assignment
    lists:
      all_leads: 15
      qualified_leads: 16
      customers: 17

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

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

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

field_mapping:
  # Standard fields
  Email: email
  FirstName: FIRSTNAME
  LastName: LASTNAME
  Phone: SMS

  # CRM fields
  LeadSource: LEAD_SOURCE
  Lead_Score__c: LEAD_SCORE
  Account.Name: COMPANY_NAME
  Account.Industry: INDUSTRY

  # Opportunity fields
  Amount: DEAL_VALUE
  StageName: DEAL_STAGE
  CloseDate: EXPECTED_CLOSE_DATE

  # Custom fields
  Preferred_Channel__c: PREFERRED_CHANNEL
  Customer_Tier__c: VIP_TIER

Endpoints API

Πόροι REST API

Bulk API

Streaming API

Εκδηλώσεις

Εκδηλώσεις Εγγραφών (Change Data Capture)

Εκδηλώσεις Πλατφόρμας

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

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

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

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

// Connect Salesforce
await tajo.connectors.connect('salesforce', {
  instanceUrl: 'https://yourorg.my.salesforce.com',
  consumerKey: process.env.SF_CONSUMER_KEY,
  consumerSecret: process.env.SF_CONSUMER_SECRET,
  refreshToken: process.env.SF_REFRESH_TOKEN
});

Συγχρονισμός Επαφών με Φίλτρο SOQL

// Sync only qualified leads from Salesforce
await tajo.connectors.sync('salesforce', {
  type: 'filtered',
  resources: ['leads'],
  filter: "SELECT Id, Email, FirstName, LastName, LeadScore__c FROM Lead WHERE Status = 'Qualified' AND Email != null",
  brevoListId: 16
});

// Check sync status
const status = await tajo.connectors.status('salesforce');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsSynced: 18400,
//   leadsSynced: 7200,
//   opportunitiesSynced: 3100
// }

Ροή σε Πραγματικό Χρόνο

// Subscribe to Salesforce Change Data Capture
await tajo.connectors.stream('salesforce', {
  channels: [
    '/data/ContactChangeEvent',
    '/data/LeadChangeEvent',
    '/data/OpportunityChangeEvent'
  ],
  handler: async (event) => {
    console.log(`Change detected: ${event.entity} ${event.changeType}`);
    // Automatically synced to Brevo by Tajo
  }
});

Όρια Ρυθμού

Τα όρια REST API Salesforce εξαρτώνται από την έκδοση και τον αριθμό αδειών:

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

• Ταυτόχρονο όριο API: 25 εκτελούμενα μακρόχρονα αιτήματα
• Bulk API: 15.000 batches ανά 24 ώρες
• Streaming API: 2.000 εκδηλώσεις ανά ημέρα (μπορεί να αυξηθεί)
• Composite API: 25 υποαιτήματα ανά composite αίτημα

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

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

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

Ενεργοποίηση λεπτομερούς καταγραφής:

connectors:
  salesforce:
    debug: true
    log_level: verbose
    log_api_calls: true

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

tajo connectors test salesforce
# ✓ OAuth token valid
# ✓ Contacts accessible
# ✓ Leads accessible
# ✓ Accounts accessible
# ✓ Opportunities accessible
# ✓ Bulk API enabled

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

1. Χρησιμοποιήστε Bulk API για μεγάλους συγχρονισμούς - Μεταβείτε σε Bulk API 2.0 για δεδομένα άνω των 2.000 εγγραφών
2. Υλοποιήστε Change Data Capture - Χρησιμοποιήστε CDC για συγχρονισμό σε πραγματικό χρόνο αντί polling
3. Αντιστοιχίστε μόνο τα απαραίτητα πεδία - Μειώστε χρήση API συγχρονίζοντας μόνο τα απαιτούμενα πεδία
4. Χειριστείτε ανανέωση token - Υλοποιήστε αυτόματη λογική ανανέωσης OAuth token
5. Χρησιμοποιήστε composite αιτήματα - Συνδυάστε σχετικές κλήσεις API για μείωση του αριθμού αιτημάτων
6. Δοκιμάστε πρώτα σε sandbox - Χρησιμοποιήστε sandbox Salesforce πριν την ανάπτυξη παραγωγής

Ασφάλεια

• OAuth 2.0 - Τυπική βιομηχανική εξουσιοδότηση με πολλαπλούς τύπους grant
• Περιορισμοί IP - Το Salesforce υποστηρίζει εύρη IP σύνδεσης και ρυθμίσεις αξιόπιστων IP
• TLS 1.2+ - Όλη η επικοινωνία API κρυπτογραφημένη με ελάχιστο TLS 1.2
• Ασφάλεια σε επίπεδο πεδίου - Λεπτομερής έλεγχος πρόσβασης πεδίου ανά προφίλ
• Διαχείριση συνεδρίας - Ρυθμιζόμενη λήξη συνεδρίας και όρια ταυτόχρονων συνεδριών

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

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