Konektor Pipedrive

Konektor Pipedrive

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

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.

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:

# 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:

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

Konfigurace

Základní nastavení

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:

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:

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ů

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

Příklady kódu

Inicializace konektoru Pipedrive

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

// 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ů

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

// Globální vyhledávání napříč osobami, obchody a organizacemi
const query = encodeURIComponent('[email protected]');
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

Další limity:

Řešení problémů

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
• Konektor Shopify
• Dovednost synchronizace zákazníků
• API kontaktů Brevo