---
title: "إنشاء جهة اتصال | Tajo"
description: "أنشئ جهات اتصال جديدة مع بيانات برنامج الولاء وسمات العملاء"
url: https://tajo.io/ar/docs/contact-management/contacts/create-contact/
markdown: https://tajo.io/ar/docs/contact-management/contacts/create-contact.md
lang: ar-SA
author: "Set Noa"
author_url: https://tajo.io/ar/set-noa/
robots: noindex
---

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

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

# إنشاء جهة اتصال

[Set Noa](https://tajo.io/ar/set-noa/)

أضف عملاء جدداً إلى قاعدة بيانات جهات الاتصال في Brevo مع معلومات برنامج الولاء وسمات مخصّصة لتفاعل شخصي.

## البداية السريعة

### إنشاء جهة اتصال أساسية

```http
POST https://api.brevo.com/v3/contacts
Content-Type: application/json
api-key: YOUR_API_KEY

{
  "email": "customer@example.com",
  "attributes": {
    "FIRSTNAME": "John",
    "LASTNAME": "Doe",
    "LOYALTY_POINTS": 1500,
    "LOYALTY_TIER": "Gold",
    "SIGNUP_DATE": "2024-01-15",
    "LAST_PURCHASE": "2024-01-20",
    "TOTAL_SPENT": 299.99
  },
  "listIds": [1, 2],
  "updateEnabled": true
}
```

### الاستجابة

```json
{
  "id": 123456
}
```

## التكامل مع برنامج الولاء

### عميل جديد مع سمات الولاء

```json
{
  "email": "newcustomer@example.com",
  "attributes": {
    "FIRSTNAME": "Sarah",
    "LASTNAME": "Johnson",
    "PHONE": "+1234567890",
    "LOYALTY_ID": "LYL-2024-001",
    "LOYALTY_POINTS": 0,
    "LOYALTY_TIER": "Bronze",
    "PREFERRED_REWARDS": "Discounts",
    "BIRTHDAY": "1990-05-15",
    "SIGNUP_SOURCE": "Website",
    "REFERRAL_CODE": "REF-12345",
    "COMMUNICATION_PREFERENCES": "Email,SMS",
    "PURCHASE_CATEGORIES": ["Electronics", "Fashion"],
    "AVERAGE_ORDER_VALUE": 0
  },
  "listIds": [1], // New customers list
  "emailBlacklisted": false,
  "smsBlacklisted": false,
  "updateEnabled": true
}
```

### تحديث عميل موجود

```json
{
  "email": "existing@example.com",
  "attributes": {
    "LOYALTY_POINTS": 2500,
    "LOYALTY_TIER": "Platinum",
    "LAST_PURCHASE": "2024-01-25",
    "TOTAL_SPENT": 1299.99,
    "RECENT_PURCHASES": ["Product A", "Product B"],
    "ENGAGEMENT_SCORE": 8.5,
    "LAST_EMAIL_OPENED": "2024-01-24",
    "PREFERRED_CONTACT_TIME": "Evening"
  },
  "listIds": [1, 3], // Add to platinum customers list
  "updateEnabled": true
}
```

## السمات الخاصّة بـ Tajo

### بيانات ولاء العميل

| اسم السمة | النوع | الوصف |
| --- | --- | --- |
| `LOYALTY_ID` | نص | معرّف فريد لبرنامج الولاء |
| `LOYALTY_POINTS` | رقم | رصيد النقاط الحالي |
| `LOYALTY_TIER` | نص | المستوى الحالي (Bronze، Silver، Gold، Platinum) |
| `POINTS_EARNED_YTD` | رقم | النقاط المكتسبة هذا العام |
| `POINTS_REDEEMED_YTD` | رقم | النقاط المستبدلة هذا العام |
| `TIER_PROGRESS` | رقم | التقدّم نحو المستوى التالي (%) |
| `NEXT_TIER_POINTS` | رقم | النقاط اللازمة للمستوى التالي |

### سلوك الشراء

| اسم السمة | النوع | الوصف |
| --- | --- | --- |
| `TOTAL_SPENT` | رقم | القيمة مدى الحياة |
| `AVERAGE_ORDER_VALUE` | رقم | متوسّط قيمة الشراء |
| `PURCHASE_FREQUENCY` | نص | مدى تكرار الشراء |
| `LAST_PURCHASE` | تاريخ | تاريخ آخر عملية شراء |
| `FAVORITE_CATEGORIES` | مصفوفة | فئات المنتجات المفضّلة |
| `SEASONAL_BUYER` | قيمة منطقية | يتسوّق موسمياً |

### مقاييس التفاعل

| اسم السمة | النوع | الوصف |
| --- | --- | --- |
| `ENGAGEMENT_SCORE` | رقم | تقييم التفاعل من 1 إلى 10 |
| `EMAIL_OPEN_RATE` | رقم | نسبة الفتح الشخصية % |
| `CLICK_THROUGH_RATE` | رقم | نسبة CTR الشخصية % |
| `LAST_EMAIL_OPENED` | تاريخ | آخر تفاعل مع البريد الإلكتروني |
| `PREFERRED_CHANNEL` | نص | البريد الإلكتروني، SMS، واتساب |

## إنشاء جهات اتصال دفعةً واحدة

أنشئ عدّة جهات اتصال في وقت واحد:

```json
{
  "contacts": [
    {
      "email": "customer1@example.com",
      "attributes": {
        "FIRSTNAME": "Alice",
        "LOYALTY_POINTS": 500,
        "LOYALTY_TIER": "Bronze"
      }
    },
    {
      "email": "customer2@example.com",
      "attributes": {
        "FIRSTNAME": "Bob",
        "LOYALTY_POINTS": 1200,
        "LOYALTY_TIER": "Silver"
      }
    }
  ],
  "listIds": [1],
  "updateEnabled": true
}
```

## معالجة الأخطاء

الأخطاء الشائعة وحلولها:

```json
{
  "code": "duplicate_parameter",
  "message": "Contact already exists",
  "details": {
    "email": "customer@example.com",
    "existingId": 123456
  }
}
```

```json
{
  "code": "invalid_parameter",
  "message": "Invalid list ID",
  "details": {
    "listIds": [999]
  }
}
```

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

1. **ضمِّن دائماً حقول الولاء الأساسية**: LOYALTY\_POINTS وLOYALTY\_TIER وLOYALTY\_ID
2. **فعِّل التحديث**: اسمح بتحديث جهات الاتصال الموجودة
3. **استخدم قوائم التقسيم**: نظِّم حسب المستوى والسلوك والتفضيلات
4. **تتبّع التفاعل**: راقب معدّلات التفاعل مع البريد الإلكتروني وSMS
5. **مزامنة منتظمة للبيانات**: أبقِ بيانات الولاء محدَّثة مع نظامك

## الخطوات التالية

- تحديث سمات جهة الاتصال
- إدارة قوائم جهات الاتصال
- إعداد سمات مخصّصة
- استيراد جهات اتصال بالجملة