--- title: "Pipedrive konektor" description: "Kompletný sprievodca integráciou Pipedrive na synchronizáciu obchodov, kontaktov, organizácií a dát pipeline s Brevo cez Tajo." url: https://tajo.io/sk/docs/connectors/crm/pipedrive/ markdown: https://tajo.io/sk/docs/connectors/crm/pipedrive.md lang: sk-SK robots: noindex --- Požiadajte o skorý prístup Zadajte svoje meno a pracovnú e-mailovú adresu. Pošleme vám odkaz na potvrdenie žiadosti o prístup k Tajo. # Pipedrive konektor Stav konektora: Plánované Zatiaľ nevytvorené. Tajo tento konektor dnes neprevádzkuje. | Zdrojové pole | Cieľové pole | Ukážková hodnota | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | Prepoj Pipedrive s Brevo cez Tajo a premosti svoju obchodnú pipeline s marketingovou automatizáciou. Synchronizuj kontakty, obchody, organizácie a aktivity na napájanie life-cycle kampaní spúšťaných zmenami fáz v CRM. ## Prehľad | Vlastnosť | Hodnota | | --- | --- | | **Platforma** | Pipedrive | | **Kategória** | CRM | | **Zložitosť nastavenia** | Ľahké | | **Oficiálna integrácia** | Nie | | **Synchronizované dáta** | Osoby, Obchody, Organizácie, Aktivity | | **Dostupné skilly** | 8 | ## Funkcie - **Synchronizácia kontaktov** - Obojsmerná synchronizácia osôb z Pipedrive s kontaktmi v Brevo - **Sledovanie fáz obchodov** - Spúšťaj automatizácie v Brevo na základe zmien fáz v pipeline - **Synchronizácia organizácií** - Namapuj organizácie z Pipedrive na atribúty spoločností v Brevo - **Sledovanie aktivít** - Preposielaj aktivity z Pipedrive (hovory, e-maily, stretnutia) ako udalosti v Brevo - **Vlastné polia** - Namapuj vlastné polia Pipedrive na atribúty kontaktov v Brevo - **Reportovanie pipeline** - Získaj dáta o pipeline obchodov pre marketingovú atribúciu - **Synchronizácia leadov** - Importuj leady z Pipedrive do Brevo pre nurture kampane - **Webhook automatizácia** - Aktualizácie v reálnom čase cez webhooky Pipedrive ## Predpoklady Predtým, než začneš, uisti sa, že máš: 1. Pipedrive účet s admin prístupom 2. API Token Pipedrive (nájdeš v Settings > Personal preferences > API) 3. Pre OAuth aplikácie: zaregistrovanú Pipedrive aplikáciu s Client ID a Client Secret 4. Brevo účet s API prístupom 5. Tajo účet s API prihlasovacími údajmi ## Autentifikácia ### API Token Najjednoduchší spôsob autentifikácie. Nájdi API Token v Pipedrive pod Settings > Personal preferences > API. ```bash curl "https://api.pipedrive.com/v1/persons?api_token=YOUR_API_TOKEN" ``` ### OAuth 2.0 (odporúčané pre aplikácie) Pre produkčné aplikácie použi 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" ``` Po získaní prístupového tokenu: ```bash curl "https://api.pipedrive.com/v1/persons" \ -H "Authorization: Bearer ACCESS_TOKEN" ``` ## Konfigurácia ### Základné nastavenie ```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 ``` ### Mapovanie polí osôb Namapuj polia osôb z Pipedrive na atribúty kontaktov v 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 ``` ### Mapovanie fáz obchodov Namapuj fázy pipeline Pipedrive na priradenie zoznamov v 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 ``` ### Konfigurácia webhookov ```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 endpointy | Metóda | Endpoint | Popis | | --- | --- | --- | | `GET` | `/v1/persons` | Zoznam osôb | | `POST` | `/v1/persons` | Vytvorenie osoby | | `PUT` | `/v1/persons/{id}` | Aktualizácia osoby | | `DELETE` | `/v1/persons/{id}` | Odstránenie osoby | | `GET` | `/v1/deals` | Zoznam obchodov | | `POST` | `/v1/deals` | Vytvorenie obchodu | | `PUT` | `/v1/deals/{id}` | Aktualizácia obchodu | | `GET` | `/v1/organizations` | Zoznam organizácií | | `POST` | `/v1/organizations` | Vytvorenie organizácie | | `GET` | `/v1/activities` | Zoznam aktivít | | `POST` | `/v1/activities` | Vytvorenie aktivity | | `GET` | `/v1/leads` | Zoznam leadov | | `GET` | `/v1/pipelines` | Zoznam pipeline | | `GET` | `/v1/stages` | Zoznam fáz pipeline | | `GET` | `/v1/itemSearch` | Vyhľadávanie naprieč všetkými položkami | | `POST` | `/v1/webhooks` | Vytvorenie webhooku | | `GET` | `/v1/recents` | Nedávno upravené položky | ## Ukážky kódu ### Inicializácia konektora 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' }); ``` ### Synchronizácia osôb do 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 } ``` ### Sledovanie zmien fáz obchodov ```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'); }); ``` ### Vyhľadávanie v 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 ``` ## Obmedzenia rýchlosti | Plán | Limit | Podrobnosti | | --- | --- | --- | | **Essential** | 80 požiadaviek/10 sek | Na API token | | **Advanced** | 100 požiadaviek/10 sek | Na API token | | **Professional** | 200 požiadaviek/10 sek | Na API token | | **Power** | 200 požiadaviek/10 sek | Na API token | | **Enterprise** | 400 požiadaviek/10 sek | Na API token | | **OAuth aplikácie** | 80 požiadaviek/2 sek | Na prístupový token | Ďalšie limity: | Zdroj | Limit | | --- | --- | | **Na stránku** | Max 500 záznamov | | **Webhooky** | 40 na účet | | **Hromadné mazanie** | 100 položiek/požiadavku | | **Vyhľadávanie** | Štandardné limity | Hlavičky obmedzenia rýchlosti Pipedrive vracia hlavičky `X-RateLimit-Limit`, `X-RateLimit-Remaining` a `X-RateLimit-Reset`. Implementuj backoff, keď sa `X-RateLimit-Remaining` blíži k nule. ## Riešenie problémov | Problém | Príčina | Riešenie | | --- | --- | --- | | `401 Unauthorized` | Neplatný API token | Znovu vygeneruj token v Pipedrive Settings > API | | `403 Forbidden` | Oprávnenia účtu | Uisti sa, že účet má admin prístup pre použitie API | | Osoby bez e-mailu | Žiadny e-mail v záznamu | Filtruj osoby s platným e-mailom pred synchronizáciou | | Vlastné polia sa nemapujú | Nesprávny kľúč poľa | Použi kľúč poľa Pipedrive (hash), nie zobrazovaný názov | | Webhooky nie sú prijímané | Firewall blokuje | Uisti sa, že URL webhookov je verejne dostupná cez HTTPS | | Duplicitné osoby | Viacero e-mailových záznamov | Použi merge API Pipedrive pred synchronizáciou | | `429 Too Many Requests` | Prekročenie limitu | Implementuj backoff pomocou hlavičky `X-RateLimit-Reset` | ## Odporúčané postupy 1. **Použi OAuth pre produkciu** - Preferuj OAuth 2.0 pred API tokenmi pre produkčné aplikácie 2. **Sleduj zmeny fáz obchodov** - Použi webhooky na spúšťanie automatizácií Brevo pri prechodoch fáz pipeline 3. **Namapuj vlastné polia** - Použi kľúče vlastných polí Pipedrive (nie názvy) pre spoľahlivé mapovanie 4. **Spravuj stránkovanie** - Použi parametre `start` a `limit`; skontroluj `more_items_in_collection` 5. **Použi endpoint Recents** - Polluj `/v1/recents` pre inkrementálne synchronizácie namiesto plného exportu 6. **Deduplikuj pred synchronizáciou** - Zlúč duplicitné osoby v Pipedrive pred synchronizáciou s Brevo 7. **Použi sandbox účty** - Vytvor vývojársky sandbox účet na testovanie integrácií ## Bezpečnosť - **Autentifikácia API tokenmi** - Jednoduchý prístup na základe tokenov pre osobné použitie - **OAuth 2.0** - Bezpečný delegovaný prístup pre aplikácie tretích strán - **Iba HTTPS** - Všetka API komunikácia vyžaduje TLS šifrovanie - **HTTPS webhooky** - Webhooky sú doručované iba na HTTPS endpointy - **Prístup podľa rolí** - Oprávnenia Pipedrive rešpektujú roly používateľov - **SOC 2 certifikácia** - Pipedrive udržiava súlad so SOC 2 - **GDPR compliance** - Podporuje export a mazanie dát ## Súvisiace zdroje - [Brevo konektor](https://tajo.io/sk/docs/connectors/marketing/brevo) - [Shopify konektor](https://tajo.io/sk/docs/connectors/ecommerce/shopify) - [Customer Sync skill](https://tajo.io/sk/docs/skills/data-sync/customer-sync) - [Brevo Contacts API](https://tajo.io/sk/docs/contact-management)