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

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

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

# Σύνδεσμος Pipedrive

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

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

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

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

| Ιδιότητα | Τιμή |
| --- | --- |
| **Πλατφόρμα** | Pipedrive |
| **Κατηγορία** | CRM |
| **Πολυπλοκότητα Ρύθμισης** | Εύκολη |
| **Επίσημη Ενσωμάτωση** | Όχι |
| **Δεδομένα που Συγχρονίζονται** | Άτομα, Συμφωνίες, Οργανισμοί, Δραστηριότητες |
| **Διαθέσιμες Δεξιότητες** | 8 |

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

- **Συγχρονισμός επαφών** - Αμφίδρομος συγχρονισμός ατόμων Pipedrive σε επαφές Brevo
- **Παρακολούθηση σταδίου συμφωνίας** - Ενεργοποίηση αυτοματισμών Brevo βάσει αλλαγών σταδίου pipeline συμφωνίας
- **Συγχρονισμός οργανισμών** - Αντιστοίχιση οργανισμών Pipedrive σε χαρακτηριστικά εταιρείας Brevo
- **Παρακολούθηση δραστηριοτήτων** - Προώθηση δραστηριοτήτων Pipedrive (κλήσεις, email, συναντήσεις) ως εκδηλώσεις Brevo
- **Προσαρμοσμένα πεδία** - Αντιστοίχιση προσαρμοσμένων πεδίων Pipedrive σε χαρακτηριστικά επαφών Brevo
- **Αναφορές pipeline** - Ανάκτηση δεδομένων pipeline συμφωνίας για απόδοση marketing
- **Συγχρονισμός leads** - Εισαγωγή leads Pipedrive στο Brevo για καμπάνιες ανάπτυξης
- **Αυτοματοποίηση webhook** - Ενημερώσεις σε πραγματικό χρόνο μέσω webhooks Pipedrive

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

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

1. Λογαριασμό Pipedrive με πρόσβαση διαχειριστή
2. Το API Token Pipedrive (βρίσκεται στο Settings > Personal preferences > API)
3. Για εφαρμογές OAuth: εγγεγραμμένη εφαρμογή Pipedrive με Client ID και Client Secret
4. Λογαριασμό Brevo με πρόσβαση API
5. Λογαριασμό Tajo με διαπιστευτήρια API

## Πιστοποίηση

### API Token

Η απλούστερη μέθοδος πιστοποίησης. Βρείτε το API Token στο Pipedrive υπό Settings > Personal preferences > API.

```bash
curl "https://api.pipedrive.com/v1/persons?api_token=YOUR_API_TOKEN"
```

### OAuth 2.0 (Συνιστάται για Εφαρμογές)

Για εφαρμογές παραγωγής, χρησιμοποιήστε OAuth 2.0:

```bash
# Authorization URL
https://oauth.pipedrive.com/oauth/authorize?client_id=CLIENT_ID&redirect_uri=REDIRECT_URI

# Token exchange
curl -X POST https://oauth.pipedrive.com/oauth/token \
  -d "grant_type=authorization_code" \
  -d "code=AUTH_CODE" \
  -d "redirect_uri=REDIRECT_URI" \
  -u "CLIENT_ID:CLIENT_SECRET"
```

Μετά την απόκτηση του access token:

```bash
curl "https://api.pipedrive.com/v1/persons" \
  -H "Authorization: Bearer ACCESS_TOKEN"
```

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

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

```yaml
connectors:
  pipedrive:
    enabled: true
    api_token: "your-pipedrive-api-token"
    company_domain: "yourcompany"  # yourcompany.pipedrive.com

    # Data sync options
    sync:
      persons: true
      deals: true
      organizations: true
      activities: true
      leads: true

    # Brevo list assignment
    lists:
      all_contacts: 60
      qualified_leads: 61
      customers: 62
      churned: 63
```

### Αντιστοίχιση Πεδίων Ατόμου

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

```yaml
person_mapping:
  email: email
  name: FULLNAME
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS
  org_id.name: COMPANY

  # Deal-related computed fields
  won_deals_count: WON_DEALS
  lost_deals_count: LOST_DEALS
  open_deals_count: OPEN_DEALS
  closed_deals_count: CLOSED_DEALS
  total_revenue: LTV

  # Custom fields (use Pipedrive field key)
  custom_fields.lead_source: LEAD_SOURCE
  custom_fields.industry: INDUSTRY
  custom_fields.company_size: COMPANY_SIZE
```

### Αντιστοίχιση Σταδίου Συμφωνίας

Αντιστοιχίστε στάδια pipeline Pipedrive σε αναθέσεις λίστας Brevo:

```yaml
deal_stage_mapping:
  # stage_id -> brevo_list_id
  1: 61   # Lead In
  2: 61   # Contact Made
  3: 62   # Proposal Made
  4: 62   # Negotiations Started
  "won": 63   # Won -> Customers list
  "lost": 64   # Lost -> Win-back list
```

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

```yaml
webhooks:
  - event_action: "added"
    event_object: "person"
    brevo_event: "contact_created"
  - event_action: "updated"
    event_object: "person"
    brevo_event: "contact_updated"
  - event_action: "added"
    event_object: "deal"
    brevo_event: "deal_created"
  - event_action: "updated"
    event_object: "deal"
    brevo_event: "deal_updated"
  - event_action: "merged"
    event_object: "person"
    brevo_event: "contact_merged"
  - event_action: "added"
    event_object: "activity"
    brevo_event: "activity_logged"
```

## Endpoints API

| Μέθοδος | Endpoint | Περιγραφή |
| --- | --- | --- |
| `GET` | `/v1/persons` | Λίστα ατόμων |
| `POST` | `/v1/persons` | Δημιουργία ατόμου |
| `PUT` | `/v1/persons/{id}` | Ενημέρωση ατόμου |
| `DELETE` | `/v1/persons/{id}` | Διαγραφή ατόμου |
| `GET` | `/v1/deals` | Λίστα συμφωνιών |
| `POST` | `/v1/deals` | Δημιουργία συμφωνίας |
| `PUT` | `/v1/deals/{id}` | Ενημέρωση συμφωνίας |
| `GET` | `/v1/organizations` | Λίστα οργανισμών |
| `POST` | `/v1/organizations` | Δημιουργία οργανισμού |
| `GET` | `/v1/activities` | Λίστα δραστηριοτήτων |
| `POST` | `/v1/activities` | Δημιουργία δραστηριότητας |
| `GET` | `/v1/leads` | Λίστα leads |
| `GET` | `/v1/pipelines` | Λίστα pipelines |
| `GET` | `/v1/stages` | Λίστα σταδίων pipeline |
| `GET` | `/v1/itemSearch` | Αναζήτηση σε όλα τα στοιχεία |
| `POST` | `/v1/webhooks` | Δημιουργία webhook |
| `GET` | `/v1/recents` | Λήψη πρόσφατα τροποποιημένων στοιχείων |

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

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

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

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

// Connect Pipedrive account
await tajo.connectors.connect('pipedrive', {
  apiToken: process.env.PIPEDRIVE_API_TOKEN,
  companyDomain: 'yourcompany'
});
```

### Συγχρονισμός Ατόμων στο Brevo

```javascript
// Fetch persons from Pipedrive
const response = await fetch(
  `https://api.pipedrive.com/v1/persons?start=0&limit=100&api_token=${API_TOKEN}`
);

const { data, additional_data } = await response.json();
// data: [{ id, name, first_name, last_name, email, phone, org_id, ... }]
// additional_data.pagination: { start, limit, more_items_in_collection }
```

### Παρακολούθηση Αλλαγών Σταδίου Συμφωνίας

```javascript
// Webhook handler for deal updates
app.post('/webhooks/pipedrive', async (req, res) => {
  const { meta, current, previous } = req.body;

  if (meta.object === 'deal' && meta.action === 'updated') {
    // Detect stage change
    if (current.stage_id !== previous.stage_id) {
      await tajo.connectors.handleWebhook('pipedrive', {
        topic: 'deal.stage_changed',
        payload: {
          dealId: current.id,
          dealTitle: current.title,
          previousStage: previous.stage_id,
          newStage: current.stage_id,
          personId: current.person_id,
          value: current.value,
          currency: current.currency
        }
      });
    }
  }

  res.status(200).send('OK');
});
```

### Αναζήτηση στο Pipedrive

```javascript
// Global search across persons, deals, and organizations
const query = encodeURIComponent('jane@example.com');
const response = await fetch(
  `https://api.pipedrive.com/v1/itemSearch?term=${query}&item_types=person,deal&api_token=${API_TOKEN}`
);

const { data } = await response.json();
// Returns matching persons, deals, and organizations
```

## Όρια Ρυθμού

| Πλάνο | Όριο | Λεπτομέρειες |
| --- | --- | --- |
| **Essential** | 80 αιτήματα/10 δευτ. | Ανά API token |
| **Advanced** | 100 αιτήματα/10 δευτ. | Ανά API token |
| **Professional** | 200 αιτήματα/10 δευτ. | Ανά API token |
| **Power** | 200 αιτήματα/10 δευτ. | Ανά API token |
| **Enterprise** | 400 αιτήματα/10 δευτ. | Ανά API token |
| **Εφαρμογές OAuth** | 80 αιτήματα/2 δευτ. | Ανά access token |

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

| Πόρος | Όριο |
| --- | --- |
| **Ανά σελίδα** | 500 εγγραφές μέγ. |
| **Webhooks** | 40 ανά λογαριασμό |
| **Μαζική διαγραφή** | 100 στοιχεία/αίτημα |
| **Αναζήτηση** | Τυπικά όρια ρυθμού |

Headers Ορίου Ρυθμού

Το Pipedrive επιστρέφει headers `X-RateLimit-Limit`, `X-RateLimit-Remaining` και `X-RateLimit-Reset`. Εφαρμόστε backoff όταν το `X-RateLimit-Remaining` πλησιάζει το μηδέν.

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

| Πρόβλημα | Αιτία | Λύση |
| --- | --- | --- |
| `401 Unauthorized` | Μη έγκυρο API token | Αναγέννηση token στο Pipedrive Settings > API |
| `403 Forbidden` | Δικαιώματα λογαριασμού | Βεβαιωθείτε ότι ο λογαριασμός έχει πρόσβαση διαχειριστή για χρήση API |
| Άτομα χωρίς email | Δεν υπάρχει email στην εγγραφή | Φιλτράρετε άτομα με έγκυρο email πριν τον συγχρονισμό |
| Τα προσαρμοσμένα πεδία δεν αντιστοιχίζονται | Λάθος κλειδί πεδίου | Χρησιμοποιήστε το κλειδί πεδίου Pipedrive (hash), όχι εμφανιζόμενο όνομα |
| Δεν λαμβάνονται webhooks | Αποκλεισμός firewall | Βεβαιωθείτε ότι το URL webhook είναι δημόσια προσβάσιμο μέσω HTTPS |
| Διπλά άτομα | Πολλαπλές εγγραφές email | Χρησιμοποιήστε merge API του Pipedrive πριν τον συγχρονισμό |
| `429 Too Many Requests` | Υπέρβαση ορίου ρυθμού | Εφαρμόστε backoff χρησιμοποιώντας το header `X-RateLimit-Reset` |

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

1. **Χρησιμοποιήστε OAuth για παραγωγή** - Προτιμήστε OAuth 2.0 αντί API tokens για εφαρμογές παραγωγής
2. **Παρακολουθήστε αλλαγές σταδίου συμφωνίας** - Χρησιμοποιήστε webhooks για ενεργοποίηση αυτοματισμών Brevo σε μεταβάσεις σταδίου pipeline
3. **Αντιστοιχίστε προσαρμοσμένα πεδία** - Χρησιμοποιήστε κλειδιά προσαρμοσμένων πεδίων Pipedrive (όχι ονόματα) για αξιόπιστη αντιστοίχιση
4. **Χειριστείτε σελιδοποίηση** - Χρησιμοποιήστε παραμέτρους `start` και `limit`· ελέγξτε `more_items_in_collection`
5. **Χρησιμοποιήστε το endpoint Recents** - Ανακτήστε `/v1/recents` για σταδιακούς συγχρονισμούς αντί πλήρων εξαγωγών
6. **Αποκλείστε διπλότυπα πριν τον συγχρονισμό** - Συγχωνεύστε διπλά άτομα στο Pipedrive πριν τον συγχρονισμό με το Brevo
7. **Χρησιμοποιήστε sandbox λογαριασμούς** - Δημιουργήστε sandbox λογαριασμό developer για δοκιμή ενσωματώσεων

## Ασφάλεια

- **Πιστοποίηση με API token** - Απλή πρόσβαση βάσει token για προσωπική χρήση
- **OAuth 2.0** - Ασφαλής μεταβιβαζόμενη πρόσβαση για εφαρμογές τρίτων
- **Μόνο HTTPS** - Όλη η επικοινωνία API απαιτεί κρυπτογράφηση TLS
- **Webhook HTTPS** - Τα webhooks παραδίδονται μόνο σε endpoints HTTPS
- **Πρόσβαση βάσει ρόλου** - Τα δικαιώματα Pipedrive σέβονται τους ρόλους χρηστών
- **Πιστοποιημένο SOC 2** - Το Pipedrive διατηρεί συμμόρφωση SOC 2
- **Συμμόρφωση GDPR** - Υποστηρίζει αιτήματα εξαγωγής και διαγραφής δεδομένων

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

- [Σύνδεσμος Brevo](https://tajo.io/gr/docs/connectors/marketing/brevo)
- [Σύνδεσμος Shopify](https://tajo.io/gr/docs/connectors/ecommerce/shopify)
- [Δεξιότητα Συγχρονισμού Πελατών](https://tajo.io/gr/docs/skills/data-sync/customer-sync)
- [API Επαφών Brevo](https://tajo.io/gr/docs/contact-management)