---
title: "موصل Twilio Segment"
description: "دليل تكامل Twilio Segment الشامل لمزامنة بيانات العملاء، والأحداث، وشرائح الجمهور مع Brevo عبر Tajo."
url: https://tajo.io/ar/docs/connectors/custom/segment/
markdown: https://tajo.io/ar/docs/connectors/custom/segment.md
lang: ar-SA
robots: noindex
---

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

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

# موصل Twilio Segment

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

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

اربط Twilio Segment بـ Brevo من خلال Tajo لتوحيد خط أنابيب بيانات العملاء، وتوجيه الأحداث من أي مصدر إلى Brevo، والاستفادة من حلّ هوية Segment لأتمتة تسويقية أكثر ثراءً.

## نظرة عامة

| الخاصية | القيمة |
| --- | --- |
| **المنصة** | Twilio Segment |
| **الفئة** | منصة بيانات (مخصص) |
| **تعقيد الإعداد** | متوسط |
| **تكامل رسمي** | لا |
| **البيانات المُزامَنة** | أحداث، عملاء، سمات، جماهير |
| **المهارات المتاحة** | 8 |

## الميزات

- **تجميع البيانات الشامل** - جمع الأحداث من المواقع والتطبيقات المحمولة والخوادم عبر SDKs الخاصة بـ Segment
- **توجيه المصادر** - توجيه البيانات من أكثر من 400 مصدر إلى Brevo عبر Tajo
- **حلّ الهوية** - دمج ملفات المستخدمين المجهولين والمعروفين تلقائيًا
- **مزامنة الجماهير** - إرسال السمات المحسوبة والجماهير في Segment إلى قوائم Brevo
- **بث الأحداث** - إعادة توجيه الأحداث في الوقت الفعلي عبر إطار عمل Connections في Segment
- **ETL العكسي** - مزامنة بيانات المستودع مرة أخرى إلى Brevo باستخدام Segment Reverse ETL
- **فرض المخطط** - التحقق من مخططات الأحداث باستخدام Segment Protocols قبل المزامنة

## المتطلبات الأساسية

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

1. مساحة عمل Twilio Segment مع مصدر مُعَد
2. مفتاح الكتابة الخاص بك في Segment للمصدر
3. حساب Brevo مع وصول إلى API
4. حساب Tajo مع بيانات اعتماد API

## المصادقة

### مفتاح كتابة Segment

يصادق Segment على المصادر باستخدام مفتاح كتابة، وهو معرّف فريد مرتبط بكل مصدر.

```javascript
// Analytics.js initialization with Write Key
analytics.load("YOUR_SEGMENT_WRITE_KEY");
```

### رمز Tajo API

اضبط موصل Tajo باستخدام بيانات الاعتماد الخاصة بك:

```bash
tajo connectors install segment \
  --write-key $SEGMENT_WRITE_KEY \
  --workspace-slug your-workspace \
  --brevo-api-key $BREVO_API_KEY
```

## الإعداد

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

```yaml
connectors:
  segment:
    enabled: true
    write_key: "your-segment-write-key"
    data_region: "us"  # or "eu" for EU workspace

    # Data sync options
    sync:
      identify: true
      track: true
      page: true
      group: false

    # Brevo list assignment
    lists:
      all_contacts: 5
      active_users: 6
      high_value: 7
```

### تعيين الأحداث

ربط أحداث تتبع Segment بأنواع أحداث Brevo:

```yaml
event_mapping:
  # Segment event -> Brevo event
  "Order Completed": "order_completed"
  "Product Viewed": "product_viewed"
  "Cart Updated": "cart_updated"
  "Signed Up": "customer_created"
  "Checkout Started": "checkout_started"

  # Custom events
  "Feature Used": "feature_used"
  "Plan Upgraded": "plan_upgraded"
```

### تعيين السمات

ربط سمات تعريف Segment بسمات جهات اتصال Brevo:

```yaml
trait_mapping:
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  phone: SMS
  plan: PLAN_TYPE
  company: COMPANY
  createdAt: SIGNUP_DATE
  lifetimeValue: LTV
```

## نقاط نهاية واجهة البرمجة

| الطريقة | نقطة النهاية | الوصف |
| --- | --- | --- |
| `POST` | `/v1/identify` | تعريف مستخدم بالسمات |
| `POST` | `/v1/track` | تتبع حدث |
| `POST` | `/v1/page` | تسجيل مشاهدة صفحة |
| `POST` | `/v1/screen` | تسجيل مشاهدة شاشة |
| `POST` | `/v1/group` | ربط مستخدم بمجموعة |
| `POST` | `/v1/alias` | دمج هويتي مستخدم |
| `POST` | `/v1/batch` | إرسال رسائل متعددة في دفعة |
| `POST` | `/v1/import` | استيراد البيانات التاريخية بالجملة |

## أمثلة على الكود

### تهيئة Segment مع وجهة Tajo

```javascript
import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Connect Segment source
await tajo.connectors.connect('segment', {
  writeKey: process.env.SEGMENT_WRITE_KEY,
  workspaceSlug: 'your-workspace'
});
```

### تتبع الأحداث عبر Segment

```javascript
// Identify a user - syncs to Brevo contacts
analytics.identify("user_123", {
  email: "jane@example.com",
  firstName: "Jane",
  lastName: "Kim",
  plan: "premium",
  lifetimeValue: 450.00
});

// Track an event - forwards to Brevo
analytics.track("Order Completed", {
  orderId: "ORD-1234",
  revenue: 89.99,
  currency: "USD",
  products: [
    { id: "SKU-001", name: "Widget", price: 89.99 }
  ]
});

// Page view tracking
analytics.page("Pricing", {
  title: "Pricing - Tajo",
  url: "https://tajo.io/pricing"
});
```

### إعادة توجيه الأحداث من جانب الخادم (Node.js)

```javascript
const Analytics = require('analytics-node');
const analytics = new Analytics(process.env.SEGMENT_WRITE_KEY);

// تعريف مجمع للمستخدمين من قاعدة البيانات
const users = await db.query('SELECT * FROM users WHERE updated_at > $1', [lastSync]);

for (const user of users) {
  analytics.identify({
    userId: user.id,
    traits: {
      email: user.email,
      firstName: user.first_name,
      lastName: user.last_name,
      totalOrders: user.order_count,
      lifetimeValue: user.ltv
    }
  });
}

// تفريغ قائمة الانتظار
await analytics.flush();
```

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

| الفئة | الحد | النافذة |
| --- | --- | --- |
| **مجاني** | 1,000 حدث/ثانية | لكل مصدر |
| **فريق** | 10,000 حدث/ثانية | لكل مصدر |
| **أعمال** | مخصص | لكل مساحة عمل |
| **Batch API** | 500 كيلوبايت كحد أقصى | لكل طلب |
| **الحد الأقصى لحجم الدفعة** | 100 حدث | لكل استدعاء دفعة |

حدود حجم الدفعة

يمكن أن يحتوي كل طلب دفعة على 100 حدث كحد أقصى ويجب ألا يتجاوز 500 كيلوبايت. للاستيراد التاريخي الكبير، استخدم Segment Bulk Import API.

## استكشاف الأخطاء وإصلاحها

| المشكلة | السبب | الحل |
| --- | --- | --- |
| الأحداث لا تظهر في Brevo | الوجهة غير مفعّلة | فعّل وجهة Tajo في Segment |
| سمات المستخدم لا تتزامن | معرّف بريد إلكتروني مفقود | تأكد من تضمين سمة `email` في استدعاءات identify |
| جهات اتصال مكررة | معرّفات مجهولة متعددة | طبّق استدعاءات `alias` مناسبة لدمج الهوية |
| تأخر الأحداث | قائمة انتظار بحجم كبير | تحقق من لوحة تسليم الأحداث في Segment |
| انتهاك المخطط | أحداث غير مخططة | راجع خطة تتبع Segment Protocols |
| أخطاء حد المعدل 429 | طلبات كثيرة جدًا | طبّق التجميع أو قلل تكرار الأحداث |

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

1. **استخدم identify قبل track** - استدعِ `identify` دائمًا قبل `track` لضمان نسب الأحداث إلى المستخدم الصحيح
2. **طبّق خطة تتبع** - استخدم Segment Protocols لفرض مخططات الأحداث
3. **اجمع الاستدعاءات من جانب الخادم** - استخدم Batch API للتكاملات من جانب الخادم لتقليل عبء HTTP
4. **عيّن السمات بشكل صريح** - عرّف تعيينات السمات إلى السمات بدلاً من الاعتماد على الافتراضيات
5. **استخدم Segment Functions** - حوّل الأحداث أثناء النقل قبل وصولها إلى Brevo
6. **راقب تسليم الأحداث** - تحقق من لوحة تسليم الأحداث في Segment للأحداث الفاشلة
7. **إعداد Replay** - فعّل Segment Replay لإعادة معالجة الأحداث التاريخية

## الأمان

- **تشفير TLS** - جميع البيانات تُنقل عبر HTTPS/TLS 1.2+
- **عزل مفتاح الكتابة** - كل مصدر له مفتاح كتابة خاص به
- **الامتثال لـ GDPR** - يدعم Segment طلبات حذف البيانات والقمع
- **SOC 2 Type II** - Segment معتمد من SOC 2 Type II
- **استضافة البيانات الإقليمية** - خيار مساحة عمل EU للامتثال لإقامة البيانات

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

- [موصل Amplitude](https://tajo.io/ar/docs/connectors/custom/amplitude)
- [موصل Mixpanel](https://tajo.io/ar/docs/connectors/custom/mixpanel)
- [مهارة مزامنة العملاء](https://tajo.io/ar/docs/skills/data-sync/customer-sync)
- [واجهة أحداث Brevo](https://tajo.io/ar/docs/events-engagement/create-event)