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."
}