---
title: "Pipedrive Konektor"
description: "Kompletan vodič za integraciju Pipedrivea za sinkronizaciju poslova, kontakata, organizacija i podataka o cjevovodu s Brevom putem Taja."
url: https://tajo.io/hr/docs/connectors/crm/pipedrive/
markdown: https://tajo.io/hr/docs/connectors/crm/pipedrive.md
lang: hr-HR
robots: noindex
---

Zatražite rani pristup

Unesite ime i poslovnu adresu e-pošte. Poslat ćemo vam poveznicu za potvrdu zahtjeva za pristup Taju.

# Pipedrive Konektor

Status konektora: Planirano Još nije izrađeno. Tajo danas ne pokreće ovaj konektor.

| Izvorno polje | Odredišno polje | Primjer vrijednosti |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Povežite Pipedrive s Brevom putem Taja kako biste premostili jaz između prodajnog cjevovoda i marketinške automatizacije. Sinkronizirajte kontakte, poslove, organizacije i aktivnosti za pokretanje kampanja životnog ciklusa na temelju promjena faza u CRM-u.

## Pregled

| Svojstvo | Vrijednost |
| --- | --- |
| **Platforma** | Pipedrive |
| **Kategorija** | CRM |
| **Složenost postavljanja** | Jednostavno |
| **Službena integracija** | Ne |
| **Sinkronizirani podaci** | Osobe, Poslovi, Organizacije, Aktivnosti |
| **Dostupne vještine** | 8 |

## Značajke

- **Sinkronizacija kontakata** - Dvosmjerna sinkronizacija Pipedrive osoba s Brevo kontaktima
- **Praćenje faza poslova** - Pokrećite Brevo automatizacije na temelju promjena faza u prodajnom cjevovodu
- **Sinkronizacija organizacija** - Mapirajte Pipedrive organizacije na atribute tvrtki u Brevu
- **Praćenje aktivnosti** - Prosljeđujte Pipedrive aktivnosti (pozive, e-mailove, sastanke) kao Brevo događaje
- **Prilagođena polja** - Mapirajte prilagođena Pipedrive polja na atribute kontakata u Brevu
- **Izvješćivanje o cjevovodu** - Dohvatite podatke o prodajnom cjevovodu za marketinšku atribuciju
- **Sinkronizacija leadova** - Uvezite Pipedrive leadove u Brevo za kampanje njegovanja
- **Webhook automatizacija** - Ažuriranja u stvarnom vremenu putem Pipedrive webhookova

## Preduvjeti

Prije nego što počnete, osigurajte da imate:

1. Pipedrive račun s administratorskim pristupom
2. Vaš Pipedrive API Token (pronađite u Postavke > Osobne postavke > API)
3. Za OAuth aplikacije: registriranu Pipedrive aplikaciju s Client ID-jem i Client Secretom
4. Brevo račun s API pristupom
5. Tajo račun s API vjerodajnicama

## Autentifikacija

### API Token

Najjednostavnija metoda autentifikacije. Pronađite svoj API Token u Pipedriveu pod Postavke > Osobne postavke > API.

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

### OAuth 2.0 (Preporučeno za aplikacije)

Za produkcijske aplikacije, koristite OAuth 2.0:

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

# Razmjena tokena
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"
```

Nakon dobivanja tokena za pristup:

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

## Konfiguracija

### Osnovna konfiguracija

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

    # Opcije sinkronizacije podataka
    sync:
      persons: true
      deals: true
      organizations: true
      activities: true
      leads: true

    # Dodjela popisa u Brevu
    lists:
      all_contacts: 60
      qualified_leads: 61
      customers: 62
      churned: 63
```

### Mapiranje polja osoba

Mapirajte Pipedrive polja osoba na atribute kontakata u Brevu:

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

  # Izračunata polja vezana uz poslove
  won_deals_count: WON_DEALS
  lost_deals_count: LOST_DEALS
  open_deals_count: OPEN_DEALS
  closed_deals_count: CLOSED_DEALS
  total_revenue: LTV

  # Prilagođena polja (koristite Pipedrive ključ polja)
  custom_fields.lead_source: LEAD_SOURCE
  custom_fields.industry: INDUSTRY
  custom_fields.company_size: COMPANY_SIZE
```

### Mapiranje faza poslova

Mapirajte faze Pipedrive cjevovoda na dodjele Brevo popisa:

```yaml
deal_stage_mapping:
  # stage_id -> brevo_list_id
  1: 61   # Lead In
  2: 61   # Kontakt uspostavljen
  3: 62   # Prijedlog poslan
  4: 62   # Pregovori počeli
  "won": 63   # Dobitni -> Popis klijenata
  "lost": 64  # Gubitnički -> Popis za povratak
```

### Konfiguracija webhookova

```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 krajnje točke

| Metoda | Krajnja točka | Opis |
| --- | --- | --- |
| `GET` | `/v1/persons` | Popis osoba |
| `POST` | `/v1/persons` | Stvaranje osobe |
| `PUT` | `/v1/persons/{id}` | Ažuriranje osobe |
| `DELETE` | `/v1/persons/{id}` | Brisanje osobe |
| `GET` | `/v1/deals` | Popis poslova |
| `POST` | `/v1/deals` | Stvaranje posla |
| `PUT` | `/v1/deals/{id}` | Ažuriranje posla |
| `GET` | `/v1/organizations` | Popis organizacija |
| `POST` | `/v1/organizations` | Stvaranje organizacije |
| `GET` | `/v1/activities` | Popis aktivnosti |
| `POST` | `/v1/activities` | Stvaranje aktivnosti |
| `GET` | `/v1/leads` | Popis leadova |
| `GET` | `/v1/pipelines` | Popis cjevovoda |
| `GET` | `/v1/stages` | Popis faza cjevovoda |
| `GET` | `/v1/itemSearch` | Pretraživanje svih stavki |
| `POST` | `/v1/webhooks` | Stvaranje webhookova |
| `GET` | `/v1/recents` | Dohvaćanje nedavno izmijenjenih stavki |

## Primjeri koda

### Inicijalizacija Pipedrive konektora

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

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

// Povezivanje Pipedrive računa
await tajo.connectors.connect('pipedrive', {
  apiToken: process.env.PIPEDRIVE_API_TOKEN,
  companyDomain: 'yourcompany'
});
```

### Sinkronizacija osoba s Brevom

```javascript
// Dohvaćanje osoba iz Pipedrivea
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 }
```

### Praćenje promjena faza poslova

```javascript
// Webhook handler za ažuriranja poslova
app.post('/webhooks/pipedrive', async (req, res) => {
  const { meta, current, previous } = req.body;

  if (meta.object === 'deal' && meta.action === 'updated') {
    // Otkrivanje promjene faze
    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');
});
```

### Pretraživanje u Pipedriveu

```javascript
// Globalno pretraživanje osoba, poslova i organizacija
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();
// Vraća odgovarajuće osobe, poslove i organizacije
```

## Ograničenja brzine

| Plan | Ograničenje | Detalji |
| --- | --- | --- |
| **Essential** | 80 zahtjeva/10 sek | Po API tokenu |
| **Advanced** | 100 zahtjeva/10 sek | Po API tokenu |
| **Professional** | 200 zahtjeva/10 sek | Po API tokenu |
| **Power** | 200 zahtjeva/10 sek | Po API tokenu |
| **Enterprise** | 400 zahtjeva/10 sek | Po API tokenu |
| **OAuth aplikacije** | 80 zahtjeva/2 sek | Po tokenu za pristup |

Dodatna ograničenja:

| Resurs | Ograničenje |
| --- | --- |
| **Po stranici** | Maks. 500 zapisa |
| **Webhooks** | 40 po računu |
| **Skupno brisanje** | 100 stavki/zahtjev |
| **Pretraživanje** | Standardna ograničenja brzine |

Zaglavlja ograničenja brzine

Pipedrive vraća zaglavlja `X-RateLimit-Limit`, `X-RateLimit-Remaining` i `X-RateLimit-Reset`. Implementirajte usporavanje kada se `X-RateLimit-Remaining` približi nuli.

## Rješavanje problema

| Problem | Uzrok | Rješenje |
| --- | --- | --- |
| `401 Unauthorized` | Nevažeći API token | Regenerirajte token u Pipedrive Postavke > API |
| `403 Forbidden` | Dozvole računa | Osigurajte da račun ima administratorski pristup za korištenje API-ja |
| Osobama nedostaje e-mail | Nema e-maila u zapisu | Filtrirajte osobe s važećim e-mailom prije sinkronizacije |
| Prilagođena polja se ne mapiraju | Pogrešan ključ polja | Koristite Pipedrive ključ polja (hash), ne naziv za prikaz |
| Webhooks se ne primaju | Vatrozid blokira | Osigurajte da je webhook URL javno dostupan putem HTTPS-a |
| Duplikati osoba | Višestruki e-mail zapisi | Koristite Pipedrive API za spajanje prije sinkronizacije |
| `429 Too Many Requests` | Prekoračeno ograničenje brzine | Implementirajte usporavanje koristeći zaglavlje `X-RateLimit-Reset` |

## Preporučene prakse

1. **Koristite OAuth za produkciju** - Za produkcijske aplikacije preferirajte OAuth 2.0 umjesto API tokena
2. **Pratite promjene faza poslova** - Koristite webhookove za pokretanje Brevo automatizacija pri prijelazima faza
3. **Mapirajte prilagođena polja** - Koristite Pipedrive ključeve prilagođenih polja (ne nazive) za pouzdano mapiranje
4. **Rukujte paginacijom** - Koristite parametre `start` i `limit`; provjerite `more_items_in_collection`
5. **Koristite krajnju točku Recents** - Anketirajte `/v1/recents` za inkrementalne sinkronizacije umjesto potpunih izvoza
6. **Deduplicirajte prije sinkronizacije** - Spojite duplikate osoba u Pipedriveu prije sinkronizacije s Brevom
7. **Koristite sandbox račune** - Stvorite razvojni sandbox račun za testiranje integracija

## Sigurnost

- **Autentifikacija API tokenom** - Jednostavni pristup temeljen na tokenima za osobnu upotrebu
- **OAuth 2.0** - Sigurni delegirani pristup za aplikacije trećih strana
- **Samo HTTPS** - Sva API komunikacija zahtijeva TLS enkripciju
- **HTTPS za webhooks** - Webhooks se isporučuju samo na HTTPS krajnje točke
- **Pristup temeljen na ulogama** - Pipedrive dozvole poštuju korisničke uloge
- **SOC 2 certificiran** - Pipedrive održava SOC 2 usklađenost
- **Usklađenost s GDPR-om** - Podržava zahtjeve za izvoz i brisanje podataka

## Povezani resursi

- [Brevo Konektor](https://tajo.io/hr/docs/connectors/marketing/brevo)
- [Shopify Konektor](https://tajo.io/hr/docs/connectors/ecommerce/shopify)
- [Vještina sinkronizacije korisnika](https://tajo.io/hr/docs/skills/data-sync/customer-sync)
- [Brevo API kontakata](https://tajo.io/hr/docs/contact-management)