---
title: "موصل Pipedrive"
description: "دليل التكامل الكامل لـ Pipedrive لمزامنة الصفقات وجهات الاتصال والمؤسسات وبيانات خط السير مع Brevo عبر Tajo."
url: https://tajo.io/ar/docs/connectors/crm/pipedrive/
markdown: https://tajo.io/ar/docs/connectors/crm/pipedrive.md
lang: ar-SA
robots: noindex
---

اطلب الوصول المبكر

أدخل اسمك الأول وعنوان بريدك الإلكتروني للعمل. سنرسل إليك رابطًا لتأكيد طلب الوصول إلى Tajo.

# موصل Pipedrive

حالة الموصل: مخطط له لم يُبنَ بعد. لا يشغّل Tajo هذا الموصل اليوم.

| حقل المصدر | حقل الوجهة | قيمة نموذجية |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

اربط Pipedrive بـ Brevo عبر Tajo لجسر خط مبيعاتك مع أتمتة التسويق. زامن جهات الاتصال والصفقات والمؤسسات والأنشطة لتشغيل حملات دورة الحياة المُشَغَّلة بتغييرات مراحل CRM.

## نظرة عامة

| الخاصية | القيمة |
| --- | --- |
| **المنصة** | Pipedrive |
| **الفئة** | CRM |
| **تعقيد الإعداد** | سهل |
| **تكامل رسمي** | لا |
| **البيانات المتزامنة** | الأشخاص، الصفقات، المؤسسات، الأنشطة |
| **المهارات المتاحة** | 8 |

## الميزات

- **مزامنة جهات الاتصال** - مزامنة ثنائية الاتجاه لأشخاص Pipedrive مع جهات اتصال Brevo
- **تتبع مرحلة الصفقة** - شغّل أتمتة Brevo بناءً على تغييرات مراحل خط الصفقات
- **مزامنة المؤسسات** - اربط مؤسسات Pipedrive بسمات شركات Brevo
- **تتبع النشاط** - أعد توجيه أنشطة Pipedrive (المكالمات، البريد الإلكتروني، الاجتماعات) كأحداث Brevo
- **الحقول المخصصة** - اربط الحقول المخصصة في Pipedrive بسمات جهات اتصال Brevo
- **تقارير خط السير** - اسحب بيانات خط الصفقات لإسناد التسويق
- **مزامنة العملاء المحتملين** - استورد عملاء Pipedrive المحتملين إلى Brevo لحملات التنشئة
- **أتمتة Webhook** - تحديثات فورية عبر webhooks في Pipedrive

## المتطلبات المسبقة

قبل أن تبدأ، تأكد من توفر ما يلي:

1. حساب Pipedrive بصلاحيات مسؤول
2. رمز Pipedrive API الخاص بك (موجود في Settings > Personal preferences > API)
3. لتطبيقات OAuth: تطبيق Pipedrive مسجل بـ Client ID و Client Secret
4. حساب Brevo مع وصول API
5. حساب Tajo مع بيانات اعتماد API

## المصادقة

### رمز API

أبسط طريقة مصادقة. ابحث عن رمز API الخاص بك في Pipedrive ضمن Settings > Personal preferences > API.

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

### OAuth 2.0 (موصى به للتطبيقات)

لتطبيقات الإنتاج، استخدم 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"
```

بعد الحصول على رمز الوصول:

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

## الإعداد

### الإعداد الأساسي

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

### ربط حقول الأشخاص

اربط حقول الأشخاص في Pipedrive بسمات جهات اتصال 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
```

### ربط مرحلة الصفقة

اربط مراحل خط Pipedrive بتعيينات قوائم 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
```

### إعداد 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"
```

## نقاط نهاية API

| الطريقة | نقطة النهاية | الوصف |
| --- | --- | --- |
| `GET` | `/v1/persons` | قائمة الأشخاص |
| `POST` | `/v1/persons` | إنشاء شخص |
| `PUT` | `/v1/persons/{id}` | تحديث شخص |
| `DELETE` | `/v1/persons/{id}` | حذف شخص |
| `GET` | `/v1/deals` | قائمة الصفقات |
| `POST` | `/v1/deals` | إنشاء صفقة |
| `PUT` | `/v1/deals/{id}` | تحديث صفقة |
| `GET` | `/v1/organizations` | قائمة المؤسسات |
| `POST` | `/v1/organizations` | إنشاء مؤسسة |
| `GET` | `/v1/activities` | قائمة الأنشطة |
| `POST` | `/v1/activities` | إنشاء نشاط |
| `GET` | `/v1/leads` | قائمة العملاء المحتملين |
| `GET` | `/v1/pipelines` | قائمة خطوط السير |
| `GET` | `/v1/stages` | قائمة مراحل خط السير |
| `GET` | `/v1/itemSearch` | البحث عبر جميع العناصر |
| `POST` | `/v1/webhooks` | إنشاء webhook |
| `GET` | `/v1/recents` | الحصول على العناصر المعدلة مؤخرًا |

## أمثلة البرمجة

### تهيئة موصل 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'
});
```

### مزامنة الأشخاص إلى 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 }
```

### تتبع تغييرات مرحلة الصفقة

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

### البحث عبر 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
```

## حدود المعدل

| الخطة | الحد | التفاصيل |
| --- | --- | --- |
| **Essential** | 80 طلب/10 ثوانٍ | لكل رمز API |
| **Advanced** | 100 طلب/10 ثوانٍ | لكل رمز API |
| **Professional** | 200 طلب/10 ثوانٍ | لكل رمز API |
| **Power** | 200 طلب/10 ثوانٍ | لكل رمز API |
| **Enterprise** | 400 طلب/10 ثوانٍ | لكل رمز API |
| **تطبيقات OAuth** | 80 طلب/2 ثانية | لكل رمز وصول |

حدود إضافية:

| المورد | الحد |
| --- | --- |
| **لكل صفحة** | 500 سجل كحد أقصى |
| **Webhooks** | 40 لكل حساب |
| **الحذف المجمع** | 100 عنصر/طلب |
| **البحث** | حدود المعدل القياسية |

رؤوس حد المعدل

يُرجع Pipedrive الرؤوس `X-RateLimit-Limit` و `X-RateLimit-Remaining` و `X-RateLimit-Reset`. طبّق التراجع عندما يقترب `X-RateLimit-Remaining` من الصفر.

## استكشاف الأخطاء

| المشكلة | السبب | الحل |
| --- | --- | --- |
| `401 Unauthorized` | رمز API غير صالح | أعد توليد الرمز في Pipedrive Settings > API |
| `403 Forbidden` | أذونات الحساب | تأكد من أن الحساب لديه وصول مسؤول لاستخدام API |
| أشخاص بلا بريد إلكتروني | لا يوجد بريد إلكتروني في السجل | صفِّ الأشخاص بوجود بريد إلكتروني صالح قبل المزامنة |
| الحقول المخصصة لا تُربط | مفتاح حقل خاطئ | استخدم مفتاح الحقل في Pipedrive (hash) وليس اسم العرض |
| Webhooks لا تُستلم | جدار حماية يمنع | تأكد من إمكانية الوصول العام لعنوان webhook عبر HTTPS |
| أشخاص مكررون | سجلات بريد إلكتروني متعددة | استخدم API الدمج في Pipedrive قبل المزامنة |
| `429 Too Many Requests` | تجاوز حد المعدل | نفّذ التراجع باستخدام رأس `X-RateLimit-Reset` |

## أفضل الممارسات

1. **استخدم OAuth للإنتاج** - فضّل OAuth 2.0 على رموز API لتطبيقات الإنتاج
2. **تتبع تغييرات مرحلة الصفقة** - استخدم webhooks لتشغيل أتمتة Brevo عند انتقالات مراحل خط السير
3. **اربط الحقول المخصصة** - استخدم مفاتيح الحقول المخصصة في Pipedrive (وليس الأسماء) لربط حقول موثوق
4. **تعامل مع الترقيم** - استخدم معلمات `start` و `limit`؛ تحقق من `more_items_in_collection`
5. **استخدم نقطة النهاية Recents** - استعلم `/v1/recents` للمزامنة التدريجية بدلاً من التصدير الكامل
6. **أزل التكرار قبل المزامنة** - ادمج الأشخاص المكررين في Pipedrive قبل المزامنة إلى Brevo
7. **استخدم حسابات بيئة التجربة** - أنشئ حساب بيئة تجربة للمطور لاختبار عمليات التكامل

## الأمان

- **مصادقة رمز API** - وصول بسيط قائم على الرمز للاستخدام الشخصي
- **OAuth 2.0** - وصول مُفوَّض آمن لتطبيقات الطرف الثالث
- **HTTPS فقط** - جميع اتصالات API تتطلب تشفير TLS
- **Webhook HTTPS** - تُسلَّم webhooks فقط إلى نقاط نهاية HTTPS
- **وصول قائم على الدور** - أذونات Pipedrive تحترم أدوار المستخدمين
- **شهادة SOC 2** - يحافظ Pipedrive على امتثال SOC 2
- **امتثال GDPR** - يدعم طلبات تصدير وحذف البيانات

## موارد ذات صلة

- [موصل Brevo](https://tajo.io/ar/docs/connectors/marketing/brevo)
- [موصل Shopify](https://tajo.io/ar/docs/connectors/ecommerce/shopify)
- [مهارة مزامنة العملاء](https://tajo.io/ar/docs/skills/data-sync/customer-sync)
- [Brevo Contacts API](https://tajo.io/ar/docs/contact-management)