ربط جهات الاتصال بالصفقة

POST https://app.alaaqat.com/api/deals/{deal_id}/attach-contacts

حيث deal_id هو قيمة _id للصفقة. تربط هذه النقطة جهة اتصال واحدة أو أكثر بالصفقة، وتبقى جهات الاتصال المرتبطة مسبقاً مرتبطة. يحتاج مفتاح واجهة التطبيق البرمجية إلى الإمكانية deal-update.

لربط جهات الاتصال أثناء إنشاء الصفقة، أرسل contact_ids إلى إنشاء صفقة بدلاً من ذلك.

ترويسة الطلب

{
    "Accept": "application/json",
    "Content-Type": "application/json"
}

محتوى الطلب

{
    contact_ids: string[]
}
الحقل مطلوب التحققات الوصف
contact_ids مطلوب مصفوفة من معرّفات جهات اتصال في حسابك جهات الاتصال التي تُربط بالصفقة.
{
    "contact_ids": [
        "6650f1a2b3c4d5e6f7a8b901",
        "6650f1a2b3c4d5e6f7a8b902"
    ]
}

الإستجابة

200 OK، وتأتي ضمن data جميع جهات الاتصال المرتبطة بالصفقة بعد الربط.

{
    "data": [
        {
            "properties": {
                "_id": "6650f1a2b3c4d5e6f7a8b901",
                "account_id": 1024,
                "firstname": "Layla",
                "lastname": "Nasser",
                "email": "layla.nasser@example.com",
                "created_at": "2026-10-20T09:30:00.000000Z",
                "fullname": "Layla Nasser",
                "image": null
            },
            "channels": []
        },
        {
            "properties": {
                "_id": "6650f1a2b3c4d5e6f7a8b902",
                "account_id": 1024,
                "firstname": "Omar",
                "lastname": "Khalil",
                "email": "omar.khalil@example.com",
                "created_at": "2026-10-15T16:10:00.000000Z",
                "fullname": "Omar Khalil",
                "image": null
            },
            "channels": []
        }
    ]
}


إلغاء ربط جهة اتصال بالصفقة

POST https://app.alaaqat.com/api/deals/{deal_id}/detach-contact

حيث deal_id هو قيمة _id للصفقة. تزيل هذه النقطة الربط بين الصفقة وجهة اتصال واحدة، دون حذف أي منهما. يحتاج مفتاح واجهة التطبيق البرمجية إلى الإمكانية deal-update.

ترويسة الطلب

{
    "Accept": "application/json",
    "Content-Type": "application/json"
}

محتوى الطلب

{
    contact_id: string
}
الحقل مطلوب التحققات الوصف
contact_id مطلوب معرّف إحدى جهات اتصالك جهة الاتصال التي يُلغى ربطها بالصفقة.
{
    "contact_id": "6650f1a2b3c4d5e6f7a8b902"
}

الإستجابة

200 OK، وتأتي الصفقة ضمن data.

{
    "data": {
        "properties": {
            "_id": "6651a0b1c2d3e4f5a6b7c801",
            "deal_name": "Annual support contract",
            "amount": 1200,
            "deal_stage": "appointment_scheduled",
            "created_by": 12,
            "updated_at": "2026-10-21T10:15:00.000000Z",
            "created_at": "2026-10-20T10:05:00.000000Z"
        }
    },
    "message": "Entity was modified successfully."
}