---
title: "Σύνδεσμος Salesforce"
description: "Πλήρης οδηγός ενσωμάτωσης Salesforce CRM για συγχρονισμό leads, επαφών, λογαριασμών, ευκαιριών και προσαρμοσμένων αντικειμένων με το Brevo μέσω Tajo."
url: https://tajo.io/gr/docs/connectors/crm/salesforce/
markdown: https://tajo.io/gr/docs/connectors/crm/salesforce.md
lang: el-GR
robots: noindex
---

Ζητήστε πρώιμη πρόσβαση

Συμπληρώστε το μικρό σας όνομα και την επαγγελματική διεύθυνση email. Θα σας στείλουμε σύνδεσμο για να επιβεβαιώσετε το αίτημα πρόσβασης στο Tajo.

# Σύνδεσμος Salesforce

Κατάσταση συνδέσμου: Προγραμματισμένο Δεν έχει κατασκευαστεί ακόμη. Το Tajo δεν εκτελεί σήμερα αυτόν τον σύνδεσμο.

| Πεδίο πηγής | Πεδίο προορισμού | Ενδεικτική τιμή |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

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

## Επισκόπηση

| Ιδιότητα | Τιμή |
| --- | --- |
| **Πλατφόρμα** | Salesforce |
| **Κατηγορία** | CRM |
| **Πολυπλοκότητα Ρύθμισης** | Προχωρημένη |
| **Επίσημη Ενσωμάτωση** | Όχι |
| **Δεδομένα που Συγχρονίζονται** | Επαφές, Leads, Λογαριασμοί, Ευκαιρίες, Εκδηλώσεις |
| **Βασικό URL API** | `https://yourInstance.salesforce.com/services/data/vXX.0` |

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

- **Αμφίδρομος συγχρονισμός επαφών/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 (Συνιστάται)

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

```bash
# 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 χωρίς αλληλεπίδραση χρήστη.

```bash
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}"
```

Token Ασφαλείας

Το Salesforce απαιτεί να προσαρτάτε το token ασφαλείας σας στον κωδικό πρόσβασης για τη ροή ονόματος χρήστη-κωδικού. Επαναφέρετε το token από Setup > My Personal Information > Reset My Security Token.

## Διαμόρφωση

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

```yaml
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:

#### Προεπιλεγμένες Αντιστοιχίσεις

| Parameter | Type | Description |
| --- | --- | --- |
| `Email` required | string | Email επαφής/lead (μοναδικό αναγνωριστικό για το Brevo) |
| `FirstName` optional | string | Αντιστοιχίζεται στο χαρακτηριστικό FIRSTNAME στο Brevo |
| `LastName` optional | string | Αντιστοιχίζεται στο χαρακτηριστικό LASTNAME στο Brevo |
| `Phone` optional | string | Αντιστοιχίζεται στο χαρακτηριστικό SMS για μηνύματα WhatsApp/SMS |
| `Account.Name` optional | string | Όνομα συσχετισμένου λογαριασμού/εταιρείας |
| `LeadSource` optional | string | Πηγή απόκτησης lead |
| `StageName` optional | string | Στάδιο ευκαιρίας για παρακολούθηση συμφωνιών |
| `OwnerId` optional | string | Ανατεθειμένος αντιπρόσωπος πωλήσεων για δρομολόγηση |

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

```yaml
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

| Μέθοδος | Endpoint | Περιγραφή |
| --- | --- | --- |
| `GET` | `/services/data/vXX.0/sobjects/Contact` | Ερώτημα επαφών |
| `POST` | `/services/data/vXX.0/sobjects/Contact` | Δημιουργία επαφής |
| `PATCH` | `/services/data/vXX.0/sobjects/Contact/{id}` | Ενημέρωση επαφής |
| `GET` | `/services/data/vXX.0/sobjects/Lead` | Ερώτημα leads |
| `GET` | `/services/data/vXX.0/sobjects/Account` | Ερώτημα λογαριασμών |
| `GET` | `/services/data/vXX.0/sobjects/Opportunity` | Ερώτημα ευκαιριών |
| `GET` | `/services/data/vXX.0/query?q={SOQL}` | Εκτέλεση ερωτήματος SOQL |
| `POST` | `/services/data/vXX.0/composite/sobjects` | Μαζική δημιουργία/ενημέρωση |

### Bulk API

| Μέθοδος | Endpoint | Περιγραφή |
| --- | --- | --- |
| `POST` | `/services/data/vXX.0/jobs/ingest` | Δημιουργία εργασίας μαζικής εισαγωγής |
| `PUT` | `/services/data/vXX.0/jobs/ingest/{jobId}/batches` | Μεταφόρτωση δεδομένων batch |
| `GET` | `/services/data/vXX.0/jobs/ingest/{jobId}` | Έλεγχος κατάστασης εργασίας |

### Streaming API

| Endpoint | Περιγραφή |
| --- | --- |
| `/cometd/XX.0` | CometD long-polling για εκδηλώσεις σε πραγματικό χρόνο |
| PushTopic | Εγγραφή σε αλλαγές εγγραφών μέσω topics βάσει SOQL |
| Change Data Capture | Ροή λεπτομερών αλλαγών σε επίπεδο πεδίου |
| Platform Events | Προσαρμοσμένη αρχιτεκτονική event-driven |

## Εκδηλώσεις

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

| Εκδήλωση | Ενεργοποίηση | Περίπτωση Χρήσης |
| --- | --- | --- |
| `ContactChangeEvent` | Δημιουργία/ενημέρωση/διαγραφή επαφής | Συγχρονισμός επαφών σε πραγματικό χρόνο |
| `LeadChangeEvent` | Δημιουργία/ενημέρωση/μετατροπή lead | Παρακολούθηση κύκλου ζωής lead |
| `OpportunityChangeEvent` | Αλλαγή σταδίου ευκαιρίας | Αυτοματοποίηση pipeline συμφωνίας |
| `AccountChangeEvent` | Τροποποίηση εγγραφής λογαριασμού | Συγχρονισμός εταιρικών δεδομένων |

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

| Εκδήλωση | Ενεργοποίηση | Περίπτωση Χρήσης |
| --- | --- | --- |
| `Lead_Converted__e` | Μετατροπή lead σε επαφή | Ανάπτυξη μετά τη μετατροπή |
| `Deal_Won__e` | Κλείσιμο ευκαιρίας-νίκη | Ροή εισαγωγής πελάτη |
| `Deal_Lost__e` | Κλείσιμο ευκαιρίας-ήττα | Καμπάνιες ανάκτησης |

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

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

```javascript
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

```javascript
// 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
// }
```

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

```javascript
// 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 ανά 24 ώρες |
| --- | --- |
| Developer | 15.000 |
| Enterprise | 1.000 ανά άδεια χρήστη (ελάχ. 15.000) |
| Unlimited | 5.000 ανά άδεια χρήστη (ελάχ. 15.000) |
| Performance | 5.000 ανά άδεια χρήστη (ελάχ. 15.000) |

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

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

Παρακολούθηση Χρήσης API

Παρακολουθήστε τη χρήση API στο Salesforce Setup > System Overview. Το Tajo χρησιμοποιεί Bulk API για μεγάλους συγχρονισμούς ώστε να εξοικονομεί τα όρια API σας.

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

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

| Πρόβλημα | Αιτία | Λύση |
| --- | --- | --- |
| INVALID\_SESSION\_ID | Το token έληξε | Αυτόματη ανανέωση OAuth token |
| REQUEST\_LIMIT\_EXCEEDED | Υπέρβαση ημερήσιου ορίου API | Χρησιμοποιήστε Bulk API ή μειώστε τη συχνότητα συγχρονισμού |
| FIELD\_INTEGRITY\_EXCEPTION | Λείπει υποχρεωτικό πεδίο | Αντιστοιχίστε όλα τα απαιτούμενα πεδία στη διαμόρφωση |
| DUPLICATES\_DETECTED | Ενεργοί κανόνες διπλοτύπων | Ρυθμίστε προτιμήσεις χειρισμού διπλοτύπων |
| INSUFFICIENT\_ACCESS | Λείπουν δικαιώματα αντικειμένου | Παραχωρήστε πρόσβαση API στο προφίλ Salesforce |

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

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

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

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

```bash
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](https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/intro_rest.htm)
- [Οδηγός Salesforce Bulk API 2.0](https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/asynch_api_intro.htm)
- [Σύνδεσμος HubSpot](https://tajo.io/gr/docs/connectors/crm/hubspot)
- [Δεξιότητα Συγχρονισμού Πελατών](https://tajo.io/gr/docs/skills/data-sync/customer-sync)
- [API Επαφών Brevo](https://tajo.io/gr/docs/contact-management)