Σύνδεσμος Pipedrive

Σύνδεσμος Pipedrive

Συνδέστε το Pipedrive με το Brevo μέσω Tajo για να γεφυρώσετε το pipeline πωλήσεών σας με την αυτοματοποίηση marketing. Συγχρονίστε επαφές, συμφωνίες, οργανισμούς και δραστηριότητες για να τροφοδοτήσετε καμπάνιες κύκλου ζωής που ενεργοποιούνται από αλλαγές σταδίου CRM.

Επισκόπηση

Χαρακτηριστικά

• Συγχρονισμός επαφών - Αμφίδρομος συγχρονισμός ατόμων Pipedrive σε επαφές Brevo
• Παρακολούθηση σταδίου συμφωνίας - Ενεργοποίηση αυτοματισμών Brevo βάσει αλλαγών σταδίου pipeline συμφωνίας
• Συγχρονισμός οργανισμών - Αντιστοίχιση οργανισμών Pipedrive σε χαρακτηριστικά εταιρείας Brevo
• Παρακολούθηση δραστηριοτήτων - Προώθηση δραστηριοτήτων Pipedrive (κλήσεις, email, συναντήσεις) ως εκδηλώσεις Brevo
• Προσαρμοσμένα πεδία - Αντιστοίχιση προσαρμοσμένων πεδίων Pipedrive σε χαρακτηριστικά επαφών Brevo
• Αναφορές pipeline - Ανάκτηση δεδομένων pipeline συμφωνίας για απόδοση marketing
• Συγχρονισμός leads - Εισαγωγή leads Pipedrive στο Brevo για καμπάνιες ανάπτυξης
• Αυτοματοποίηση webhook - Ενημερώσεις σε πραγματικό χρόνο μέσω webhooks Pipedrive

Προαπαιτούμενα

Πριν ξεκινήσετε, βεβαιωθείτε ότι διαθέτετε:

1. Λογαριασμό Pipedrive με πρόσβαση διαχειριστή
2. Το API Token Pipedrive (βρίσκεται στο Settings > Personal preferences > API)
3. Για εφαρμογές OAuth: εγγεγραμμένη εφαρμογή Pipedrive με Client ID και Client Secret
4. Λογαριασμό Brevo με πρόσβαση API
5. Λογαριασμό Tajo με διαπιστευτήρια API

Πιστοποίηση

API Token

Η απλούστερη μέθοδος πιστοποίησης. Βρείτε το API Token στο Pipedrive υπό Settings > Personal preferences > API.

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

OAuth 2.0 (Συνιστάται για Εφαρμογές)

Για εφαρμογές παραγωγής, χρησιμοποιήστε OAuth 2.0:

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

Μετά την απόκτηση του access token:

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

Διαμόρφωση

Βασική Ρύθμιση

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

Αντιστοίχιση Πεδίων Ατόμου

Αντιστοιχίστε πεδία ατόμου Pipedrive σε χαρακτηριστικά επαφών Brevo:

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

Αντιστοίχιση Σταδίου Συμφωνίας

Αντιστοιχίστε στάδια pipeline Pipedrive σε αναθέσεις λίστας Brevo:

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

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"

Endpoints API

Παραδείγματα Κώδικα

Αρχικοποίηση Συνδέσμου Pipedrive

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

Συγχρονισμός Ατόμων στο Brevo

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

Παρακολούθηση Αλλαγών Σταδίου Συμφωνίας

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

Αναζήτηση στο Pipedrive

// Global search across persons, deals, and organizations
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();
// Returns matching persons, deals, and organizations

Όρια Ρυθμού

Πρόσθετα όρια:

Αντιμετώπιση Προβλημάτων

Βέλτιστες Πρακτικές

1. Χρησιμοποιήστε OAuth για παραγωγή - Προτιμήστε OAuth 2.0 αντί API tokens για εφαρμογές παραγωγής
2. Παρακολουθήστε αλλαγές σταδίου συμφωνίας - Χρησιμοποιήστε webhooks για ενεργοποίηση αυτοματισμών Brevo σε μεταβάσεις σταδίου pipeline
3. Αντιστοιχίστε προσαρμοσμένα πεδία - Χρησιμοποιήστε κλειδιά προσαρμοσμένων πεδίων Pipedrive (όχι ονόματα) για αξιόπιστη αντιστοίχιση
4. Χειριστείτε σελιδοποίηση - Χρησιμοποιήστε παραμέτρους start και limit· ελέγξτε more_items_in_collection
5. Χρησιμοποιήστε το endpoint Recents - Ανακτήστε /v1/recents για σταδιακούς συγχρονισμούς αντί πλήρων εξαγωγών
6. Αποκλείστε διπλότυπα πριν τον συγχρονισμό - Συγχωνεύστε διπλά άτομα στο Pipedrive πριν τον συγχρονισμό με το Brevo
7. Χρησιμοποιήστε sandbox λογαριασμούς - Δημιουργήστε sandbox λογαριασμό developer για δοκιμή ενσωματώσεων

Ασφάλεια

• Πιστοποίηση με API token - Απλή πρόσβαση βάσει token για προσωπική χρήση
• OAuth 2.0 - Ασφαλής μεταβιβαζόμενη πρόσβαση για εφαρμογές τρίτων
• Μόνο HTTPS - Όλη η επικοινωνία API απαιτεί κρυπτογράφηση TLS
• Webhook HTTPS - Τα webhooks παραδίδονται μόνο σε endpoints HTTPS
• Πρόσβαση βάσει ρόλου - Τα δικαιώματα Pipedrive σέβονται τους ρόλους χρηστών
• Πιστοποιημένο SOC 2 - Το Pipedrive διατηρεί συμμόρφωση SOC 2
• Συμμόρφωση GDPR - Υποστηρίζει αιτήματα εξαγωγής και διαγραφής δεδομένων

Σχετικοί Πόροι

• Σύνδεσμος Brevo
• Σύνδεσμος Shopify
• Δεξιότητα Συγχρονισμού Πελατών
• API Επαφών Brevo