Pipedrive کنیکٹر

Pipedrive کنیکٹر

اپنی سیلز پائپ لائن کو مارکیٹنگ آٹومیشن سے جوڑنے کے لیے Tajo کے ذریعے Pipedrive کو Brevo سے منسلک کریں۔ CRM مرحلے کی تبدیلیوں سے ٹرگر ہونے والی لائف سائیکل مہمات کو طاقت دینے کے لیے رابطوں، ڈیلز، اداروں، اور سرگرمیوں کو سنک کریں۔

جائزہ

خصوصیات

• رابطہ سنک - Pipedrive افراد کو Brevo رابطوں میں دو طرفہ سنک
• ڈیل مرحلہ ٹریکنگ - ڈیل پائپ لائن مرحلے کی تبدیلیوں پر Brevo آٹومیشن ٹرگر کریں
• ادارہ سنک - Pipedrive اداروں کو Brevo کمپنی خصوصیات پر میپ کریں
• سرگرمی ٹریکنگ - Pipedrive سرگرمیوں (کالز، ای میلز، میٹنگز) کو Brevo ایونٹس کے طور پر آگے بڑھائیں
• کسٹم فیلڈز - Pipedrive کسٹم فیلڈز کو Brevo رابطہ خصوصیات پر میپ کریں
• پائپ لائن رپورٹنگ - مارکیٹنگ انتساب کے لیے ڈیل پائپ لائن ڈیٹا حاصل کریں
• لیڈ سنک - نرچر مہمات کے لیے Pipedrive لیڈز کو Brevo میں درآمد کریں
• Webhook آٹومیشن - Pipedrive webhooks کے ذریعے ریئل ٹائم اپ ڈیٹس

شرائط

شروع کرنے سے پہلے، یقینی بنائیں کہ آپ کے پاس ہے:

1. ایڈمن رسائی کے ساتھ Pipedrive اکاؤنٹ
2. آپ کا Pipedrive API Token (Settings > Personal preferences > API میں پایا جاتا ہے)
3. OAuth ایپس کے لیے: Client ID اور Client Secret کے ساتھ رجسٹرڈ Pipedrive ایپ
4. API رسائی کے ساتھ Brevo اکاؤنٹ
5. API اسناد کے ساتھ Tajo اکاؤنٹ

تصدیق

API ٹوکن

سب سے آسان تصدیق کا طریقہ۔ Pipedrive میں Settings > Personal preferences > API کے تحت اپنا API Token تلاش کریں۔

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"

ایکسیس ٹوکن حاصل کرنے کے بعد:

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

ڈیل مرحلہ میپنگ

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"

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 استعمال کریں - پروڈکشن ایپلیکیشنز کے لیے API ٹوکنز پر OAuth 2.0 کو ترجیح دیں
2. ڈیل مرحلے کی تبدیلیاں ٹریک کریں - پائپ لائن مرحلے کی تبدیلیوں پر Brevo آٹومیشن ٹرگر کرنے کے لیے webhooks استعمال کریں
3. کسٹم فیلڈز میپ کریں - قابل اعتماد فیلڈ میپنگ کے لیے Pipedrive کسٹم فیلڈ کیز (نہ کہ نام) استعمال کریں
4. Pagination سنبھالیں - start اور limit پیرامیٹرز استعمال کریں؛ more_items_in_collection چیک کریں
5. Recents اینڈ پوائنٹ استعمال کریں - مکمل برآمد کی بجائے انکریمنٹل سنک کے لیے /v1/recents کو poll کریں
6. سنک سے پہلے ڈی ڈپلیکیٹ کریں - Brevo میں سنک کرنے سے پہلے Pipedrive میں ڈپلیکیٹ افراد کو ضم کریں
7. سینڈ باکس اکاؤنٹس استعمال کریں - انٹیگریشنز کی جانچ کے لیے ڈویلپر سینڈ باکس اکاؤنٹ بنائیں

سیکیورٹی

• API ٹوکن تصدیق - ذاتی استعمال کے لیے سادہ ٹوکن پر مبنی رسائی
• OAuth 2.0 - تیسری پارٹی ایپلیکیشنز کے لیے محفوظ تفویض کردہ رسائی
• صرف HTTPS - تمام API مواصلات کو TLS انکرپشن درکار ہے
• Webhook HTTPS - Webhooks صرف HTTPS اینڈ پوائنٹس پر پہنچائے جاتے ہیں
• کردار پر مبنی رسائی - Pipedrive اجازتیں صارف کے کرداروں کا احترام کرتی ہیں
• SOC 2 سرٹیفائیڈ - Pipedrive SOC 2 کمپلائنس برقرار رکھتا ہے
• GDPR کمپلائنس - ڈیٹا برآمد اور حذف کی درخواستوں کی حمایت کرتا ہے

متعلقہ وسائل

• Brevo کنیکٹر
• Shopify کنیکٹر
• گاہک سنک اسکل
• Brevo Contacts API