--- title: "Konektor Pipedrive" description: "Kompletní průvodce integrací Pipedrive pro synchronizaci obchodů, kontaktů, organizací a dat pipeline s Brevo přes Tajo." url: https://tajo.io/cz/docs/connectors/crm/pipedrive/ markdown: https://tajo.io/cz/docs/connectors/crm/pipedrive.md lang: cs-CZ robots: noindex --- Požádejte o přednostní přístup Zadejte své jméno a pracovní e-mailovou adresu. Pošleme vám odkaz pro potvrzení žádosti o přístup k Tajo. # Konektor Pipedrive Stav konektoru: Plánováno Zatím nevytvořeno. Tajo tento konektor dnes neprovozuje. | Zdrojové pole | Cílové pole | Ukázková hodnota | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | Propojte Pipedrive s Brevo přes Tajo, abyste propojili svůj obchodní pipeline s marketingovou automatizací. Synchronizujte kontakty, obchody, organizace a aktivity pro spouštění životního cyklu kampaní na základě změn ve fázích CRM. ## Přehled | Vlastnost | Hodnota | | --- | --- | | **Platforma** | Pipedrive | | **Kategorie** | CRM | | **Složitost nastavení** | Snadná | | **Oficiální integrace** | Ne | | **Synchronizovaná data** | Osoby, Obchody, Organizace, Aktivity | | **Dostupné dovednosti** | 8 | ## Funkce - **Synchronizace kontaktů** – Obousměrná synchronizace osob z Pipedrive na kontakty v Brevo - **Sledování fází obchodů** – Spouštějte automatizace Brevo na základě změn fází v obchodním pipeline - **Synchronizace organizací** – Mapujte organizace z Pipedrive na firemní atributy Brevo - **Sledování aktivit** – Přeposílejte aktivity Pipedrive (hovory, e-maily, schůzky) jako události Brevo - **Vlastní pole** – Mapujte vlastní pole Pipedrive na atributy kontaktů Brevo - **Reporting pipeline** – Získávejte data obchodního pipeline pro marketingovou atribuci - **Synchronizace leadů** – Importujte leady z Pipedrive do Brevo pro pečovatelské kampaně - **Webhooková automatizace** – Aktualizace v reálném čase přes webhooky Pipedrive ## Předpoklady Než začnete, ujistěte se, že máte: 1. Účet Pipedrive s administrátorským přístupem 2. Váš API Token Pipedrive (nalezený v Nastavení > Osobní předvolby > API) 3. Pro OAuth aplikace: zaregistrovanou aplikaci Pipedrive s Client ID a Client Secret 4. Účet Brevo s přístupem k API 5. Účet Tajo s API přihlašovacími údaji ## Ověření ### API Token Nejjednodušší metoda ověření. Najdete svůj API Token v Pipedrive v Nastavení > Osobní předvolby > API. ```bash curl "https://api.pipedrive.com/v1/persons?api_token=YOUR_API_TOKEN" ``` ### OAuth 2.0 (doporučeno pro aplikace) Pro produkční aplikace použijte OAuth 2.0: ```bash # Autorizační URL https://oauth.pipedrive.com/oauth/authorize?client_id=CLIENT_ID&redirect_uri=REDIRECT_URI # Výměna tokenů 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ískání přístupového tokenu: ```bash curl "https://api.pipedrive.com/v1/persons" \ -H "Authorization: Bearer ACCESS_TOKEN" ``` ## Konfigurace ### Základní nastavení ```yaml connectors: pipedrive: enabled: true api_token: "your-pipedrive-api-token" company_domain: "yourcompany" # yourcompany.pipedrive.com # Možnosti synchronizace dat sync: persons: true deals: true organizations: true activities: true leads: true # Přiřazení seznamů Brevo lists: all_contacts: 60 qualified_leads: 61 customers: 62 churned: 63 ``` ### Mapování polí osoby Mapujte pole osob z Pipedrive na atributy kontaktů Brevo: ```yaml person_mapping: email: email name: FULLNAME first_name: FIRSTNAME last_name: LASTNAME phone: SMS org_id.name: COMPANY # Vypočítaná pole vztahující se k obchodům won_deals_count: WON_DEALS lost_deals_count: LOST_DEALS open_deals_count: OPEN_DEALS closed_deals_count: CLOSED_DEALS total_revenue: LTV # Vlastní pole (použijte klíč pole Pipedrive) custom_fields.lead_source: LEAD_SOURCE custom_fields.industry: INDUSTRY custom_fields.company_size: COMPANY_SIZE ``` ### Mapování fází obchodů Mapujte fáze pipeline Pipedrive na přiřazení seznamů Brevo: ```yaml deal_stage_mapping: # stage_id -> brevo_list_id 1: 61 # Vstup leadu 2: 61 # Navázán kontakt 3: 62 # Vytvořen návrh 4: 62 # Zahájena jednání "won": 63 # Získán -> Seznam zákazníků "lost": 64 # Ztracen -> Seznam pro opětovné získání ``` ### Konfigurace 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" ``` ## Koncové body API | Metoda | Koncový bod | Popis | | --- | --- | --- | | `GET` | `/v1/persons` | Výpis osob | | `POST` | `/v1/persons` | Vytvoření osoby | | `PUT` | `/v1/persons/{id}` | Aktualizace osoby | | `DELETE` | `/v1/persons/{id}` | Smazání osoby | | `GET` | `/v1/deals` | Výpis obchodů | | `POST` | `/v1/deals` | Vytvoření obchodu | | `PUT` | `/v1/deals/{id}` | Aktualizace obchodu | | `GET` | `/v1/organizations` | Výpis organizací | | `POST` | `/v1/organizations` | Vytvoření organizace | | `GET` | `/v1/activities` | Výpis aktivit | | `POST` | `/v1/activities` | Vytvoření aktivity | | `GET` | `/v1/leads` | Výpis leadů | | `GET` | `/v1/pipelines` | Výpis pipeline | | `GET` | `/v1/stages` | Výpis fází pipeline | | `GET` | `/v1/itemSearch` | Vyhledávání napříč všemi záznamy | | `POST` | `/v1/webhooks` | Vytvoření webhooku | | `GET` | `/v1/recents` | Získání nedávno upravených položek | ## Příklady kódu ### Inicializace konektoru Pipedrive ```javascript import { TajoClient } from '@tajo/sdk'; const tajo = new TajoClient({ apiKey: process.env.TAJO_API_KEY, brevoApiKey: process.env.BREVO_API_KEY }); // Připojení účtu Pipedrive await tajo.connectors.connect('pipedrive', { apiToken: process.env.PIPEDRIVE_API_TOKEN, companyDomain: 'yourcompany' }); ``` ### Synchronizace osob do Brevo ```javascript // Načtení osob z 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 } ``` ### Sledování změn fází obchodů ```javascript // Obsluha webhooků pro aktualizace obchodů app.post('/webhooks/pipedrive', async (req, res) => { const { meta, current, previous } = req.body; if (meta.object === 'deal' && meta.action === 'updated') { // Zjistit změnu fáze 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'); }); ``` ### Vyhledávání napříč Pipedrive ```javascript // Globální vyhledávání napříč osobami, obchody a organizacemi 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(); // Vrací odpovídající osoby, obchody a organizace ``` ## Omezení rychlosti | Plán | Limit | Podrobnosti | | --- | --- | --- | | **Essential** | 80 požadavků/10 sek | Na API token | | **Advanced** | 100 požadavků/10 sek | Na API token | | **Professional** | 200 požadavků/10 sek | Na API token | | **Power** | 200 požadavků/10 sek | Na API token | | **Enterprise** | 400 požadavků/10 sek | Na API token | | **OAuth aplikace** | 80 požadavků/2 sek | Na přístupový token | Další limity: | Prostředek | Limit | | --- | --- | | **Na stránku** | Max 500 záznamů | | **Webhooky** | 40 na účet | | **Hromadné smazání** | 100 položek/požadavek | | **Vyhledávání** | Standardní limity rychlosti | Hlavičky omezení rychlosti Pipedrive vrací hlavičky `X-RateLimit-Limit`, `X-RateLimit-Remaining` a `X-RateLimit-Reset`. Implementujte zpětné odběrání, když se `X-RateLimit-Remaining` blíží nule. ## Řešení problémů | Problém | Příčina | Řešení | | --- | --- | --- | | `401 Unauthorized` | Neplatný API token | Obnovte token v Nastavení Pipedrive > API | | `403 Forbidden` | Oprávnění účtu | Ujistěte se, že účet má administrátorský přístup pro používání API | | Osobám chybí e-mail | Žádný e-mail v záznamu | Před synchronizací filtrujte osoby s platným e-mailem | | Vlastní pole se nemapují | Nesprávný klíč pole | Používejte klíč pole Pipedrive (hash), ne zobrazované jméno | | Webhooky nejsou přijímány | Brána firewall blokuje | Ujistěte se, že URL webhooku je veřejně přístupná přes HTTPS | | Duplicitní osoby | Více e-mailových záznamů | Před synchronizací použijte API sloučení Pipedrive | | `429 Too Many Requests` | Překročen limit rychlosti | Implementujte zpětné odběrání pomocí hlavičky `X-RateLimit-Reset` | ## Osvědčené postupy 1. **Používejte OAuth pro produkci** – Pro produkční aplikace upřednostňujte OAuth 2.0 před API tokeny 2. **Sledujte změny fází obchodů** – Používejte webhooky ke spouštění automatizací Brevo při přechodech fází pipeline 3. **Mapujte vlastní pole** – Používejte klíče vlastních polí Pipedrive (ne názvy) pro spolehlivé mapování 4. **Zpracovávejte stránkování** – Používejte parametry `start` a `limit`; kontrolujte `more_items_in_collection` 5. **Používejte koncový bod Recents** – Pro přírůstkové synchronizace dotazujte `/v1/recents` místo úplných exportů 6. **Deduplikujte před synchronizací** – Před synchronizací do Brevo sloučte duplicitní osoby v Pipedrive 7. **Používejte sandboxové účty** – Vytvořte vývojářský sandboxový účet pro testování integrací ## Zabezpečení - **Ověření API tokenem** – Jednoduché přístupy na základě tokenů pro osobní použití - **OAuth 2.0** – Bezpečný delegovaný přístup pro aplikace třetích stran - **Pouze HTTPS** – Veškerá komunikace API vyžaduje šifrování TLS - **Webhook HTTPS** – Webhooky doručovány pouze na HTTPS koncové body - **Přístup na základě rolí** – Oprávnění Pipedrive respektují role uživatelů - **Certifikace SOC 2** – Pipedrive udržuje soulad s SOC 2 - **Soulad s GDPR** – Podporuje požadavky na export a mazání dat ## Související zdroje - [Konektor Brevo](https://tajo.io/cz/docs/connectors/marketing/brevo) - [Konektor Shopify](https://tajo.io/cz/docs/connectors/ecommerce/shopify) - [Dovednost synchronizace zákazníků](https://tajo.io/cz/docs/skills/data-sync/customer-sync) - [API kontaktů Brevo](https://tajo.io/cz/docs/contact-management)