---
title: "Pipedrive konnektor"
description: "Teljes Pipedrive integrációs útmutató üzletek, kapcsolatok, szervezetek és pipeline-adatok Brevóval való szinkronizációjához a Tajo segítségével."
url: https://tajo.io/hu/docs/connectors/crm/pipedrive/
markdown: https://tajo.io/hu/docs/connectors/crm/pipedrive.md
lang: hu-HU
robots: noindex
---

Kérj korai hozzáférést

Adja meg keresztnevét és munkahelyi e-mail-címét. Küldünk egy hivatkozást, amellyel megerősítheti a Tajo-hozzáférési kérelmét.

# Pipedrive konnektor

Konnektor állapota: Tervezett Még nem készült el. A Tajo ma nem futtatja ezt a konnektort.

| Forrásmező | Célmező | Mintaérték |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Csatlakoztasd a Pipedrive-ot a Brevóhoz a Tajo segítségével, hogy áthidald az értékesítési pipeline-t a marketingautomatizálással. Szinkronizáld a kapcsolatokat, üzleteket, szervezeteket és tevékenységeket a CRM fázisváltozások által kiváltott életciklus-kampányokhoz.

## Áttekintés

| Tulajdonság | Érték |
| --- | --- |
| **Platform** | Pipedrive |
| **Kategória** | CRM |
| **Telepítés bonyolultsága** | Könnyű |
| **Hivatalos integráció** | Nem |
| **Szinkronizált adatok** | Személyek, Üzletek, Szervezetek, Tevékenységek |
| **Elérhető Skillek** | 8 |

## Funkciók

- **Kapcsolat-szinkronizáció** – Kétirányú szinkronizáció a Pipedrive személyek és a Brevo kapcsolatok között
- **Üzleti fáziskövetés** – Indíts Brevo automatizálásokat az üzleti pipeline fázisváltozásai alapján
- **Szervezet-szinkronizáció** – Képezd le a Pipedrive szervezeteket Brevo cég-attribútumokhoz
- **Tevékenységkövetés** – Pipedrive tevékenységek (hívások, e-mailek, találkozók) továbbítása Brevo eseményként
- **Egyedi mezők** – Pipedrive egyedi mezők leképezése Brevo kapcsolat-attribútumokhoz
- **Pipeline-riporting** – Üzleti pipeline-adatok lekérése marketingattribúcióhoz
- **Lead-szinkronizáció** – Pipedrive leadek importálása a Brevóba gondozási kampányokhoz
- **Webhook-automatizálás** – Valós idejű frissítések Pipedrive webhookok segítségével

## Előfeltételek

Mielőtt elkezdenéd, győződj meg róla, hogy rendelkezel:

1. Egy Pipedrive fiókkal adminisztrátori hozzáféréssel
2. A Pipedrive API tokenjével (megtalálható a Beállítások > Személyes beállítások > API menüpontban)
3. OAuth alkalmazásokhoz: egy regisztrált Pipedrive alkalmazással Client ID-vel és Client Secret-tel
4. Egy Brevo fiókkal API-hozzáféréssel
5. Egy Tajo fiókkal API hitelesítő adatokkal

## Hitelesítés

### API token

A legegyszerűbb hitelesítési módszer. Az API tokenedet megtalálod a Pipedrive-ban a Beállítások > Személyes beállítások > API alatt.

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

### OAuth 2.0 (alkalmazásokhoz ajánlott)

Éles alkalmazásokhoz használj OAuth 2.0-t:

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

A hozzáférési token megszerzése után:

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

## Konfiguráció

### Alapbeállítás

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

### Személy mezőleképezés

Képezd le a Pipedrive személy mezőket Brevo kapcsolat-attribútumokhoz:

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

### Üzleti fázis leképezés

Képezd le a Pipedrive pipeline fázisokat Brevo lista-hozzárendelésekhez:

```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 konfiguráció

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

## API végpontok

| Módszer | Végpont | Leírás |
| --- | --- | --- |
| `GET` | `/v1/persons` | Személyek listázása |
| `POST` | `/v1/persons` | Személy létrehozása |
| `PUT` | `/v1/persons/{id}` | Személy frissítése |
| `DELETE` | `/v1/persons/{id}` | Személy törlése |
| `GET` | `/v1/deals` | Üzletek listázása |
| `POST` | `/v1/deals` | Üzlet létrehozása |
| `PUT` | `/v1/deals/{id}` | Üzlet frissítése |
| `GET` | `/v1/organizations` | Szervezetek listázása |
| `POST` | `/v1/organizations` | Szervezet létrehozása |
| `GET` | `/v1/activities` | Tevékenységek listázása |
| `POST` | `/v1/activities` | Tevékenység létrehozása |
| `GET` | `/v1/leads` | Leadek listázása |
| `GET` | `/v1/pipelines` | Pipeline-ok listázása |
| `GET` | `/v1/stages` | Pipeline fázisok listázása |
| `GET` | `/v1/itemSearch` | Keresés az összes elem között |
| `POST` | `/v1/webhooks` | Webhook létrehozása |
| `GET` | `/v1/recents` | Nemrég módosított elemek lekérése |

## Kódpéldák

### A Pipedrive konnektor inicializálása

```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'
});
```

### Személyek szinkronizálása a Brevóba

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

### Üzleti fázisváltozások követése

```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');
});
```

### Keresés a Pipedrive-ban

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

## Ráta-korlátok

| Csomag | Korlát | Részletek |
| --- | --- | --- |
| **Essential** | 80 kérés/10 mp | API tokenenkénti |
| **Advanced** | 100 kérés/10 mp | API tokenenkénti |
| **Professional** | 200 kérés/10 mp | API tokenenkénti |
| **Power** | 200 kérés/10 mp | API tokenenkénti |
| **Enterprise** | 400 kérés/10 mp | API tokenenkénti |
| **OAuth alkalmazások** | 80 kérés/2 mp | Hozzáférési tokenenkénti |

További korlátok:

| Erőforrás | Korlát |
| --- | --- |
| **Oldalankénti rekordok** | Max. 500 rekord |
| **Webhookok** | 40 fiókonként |
| **Tömeges törlés** | 100 elem/kérés |
| **Keresés** | Standard ráta-korlátok |

Ráta-korlát fejlécek

A Pipedrive visszaadja az `X-RateLimit-Limit`, `X-RateLimit-Remaining` és `X-RateLimit-Reset` fejléceket. Implementálj visszalépést, ha az `X-RateLimit-Remaining` nullához közeledik.

## Hibaelhárítás

| Probléma | Ok | Megoldás |
| --- | --- | --- |
| `401 Unauthorized` | Érvénytelen API token | Generáld újra a tokent a Pipedrive Beállítások > API menüpontban |
| `403 Forbidden` | Fiók-engedélyek | Győződj meg róla, hogy a fióknak adminisztrátori hozzáférése van az API-hoz |
| Személyeknek nincs e-mailjük | Nincs e-mail a rekordban | Szinkronizálás előtt szűrd az érvényes e-maillel rendelkező személyeket |
| Egyedi mezők nem képeződnek le | Rossz mezőkulcs | Használd a Pipedrive mezőkulcsát (hash-t), ne a megjelenítési nevet |
| Webhookok nem érkeznek meg | Tűzfal blokkolja | Győződj meg róla, hogy a webhook URL HTTPS-en keresztül nyilvánosan elérhető |
| Duplikált személyek | Több e-mail rekord | Szinkronizálás előtt használd a Pipedrive összevonási API-ját |
| `429 Too Many Requests` | Ráta-korlát túllépve | Implementálj visszalépést az `X-RateLimit-Reset` fejléc alapján |

## Legjobb gyakorlatok

1. **Éles alkalmazásokhoz használj OAuth-ot** – Éles alkalmazásokhoz az OAuth 2.0-t részesítsd előnyben az API tokenekkel szemben
2. **Kövesd az üzleti fázisváltozásokat** – Használj webhookokat Brevo automatizálások indításához pipeline fázisátmeneteken
3. **Képezd le az egyedi mezőket** – Használd a Pipedrive egyedi mezőkulcsokat (ne neveket) a megbízható mezőleképezéshez
4. **Kezelj oldalazást** – Használd a `start` és `limit` paramétereket; ellenőrizd a `more_items_in_collection` értéket
5. **Használj Recents végpontot** – Növekményes szinkronizáláshoz kérdezd le a `/v1/recents` végpontot teljes exportok helyett
6. **Deduplikálj szinkronizálás előtt** – Vonj össze duplikált személyeket a Pipedrive-ban a Brevóba szinkronizálás előtt
7. **Használj sandbox fiókokat** – Hozz létre fejlesztői sandbox fiókot az integrációk teszteléséhez

## Biztonság

- **API token hitelesítés** – Egyszerű token alapú hozzáférés személyes használathoz
- **OAuth 2.0** – Biztonságos delegált hozzáférés harmadik fél alkalmazásokhoz
- **Csak HTTPS** – Minden API kommunikáció TLS titkosítást igényel
- **Webhook HTTPS** – A webhookok csak HTTPS végpontokra kerülnek kézbesítésre
- **Szerepkör alapú hozzáférés** – A Pipedrive engedélyek tiszteletben tartják a felhasználói szerepköröket
- **SOC 2 tanúsítás** – A Pipedrive fenntartja a SOC 2 megfelelőséget
- **GDPR megfelelőség** – Adatexport és törlési kérelmek támogatása

## Kapcsolódó források

- [Brevo konnektor](https://tajo.io/hu/docs/connectors/marketing/brevo)
- [Shopify konnektor](https://tajo.io/hu/docs/connectors/ecommerce/shopify)
- [Ügyfél-szinkronizáció Skill](https://tajo.io/hu/docs/skills/data-sync/customer-sync)
- [Brevo Contacts API](https://tajo.io/hu/docs/contact-management)