ربط الصفقات بالتذكرة

POST https://app.alaaqat.com/api/tickets/{ticket_id}/attach-deals

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

ترويسة الطلب

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

محتوى الطلب

{
    deal_ids: string[]
}
الحقل مطلوب التحققات الوصف
deal_ids مطلوب مصفوفة من معرّفات صفقات في حسابك الصفقات التي تُربط بالتذكرة.
{
    "deal_ids": [
        "6651a0b1c2d3e4f5a6b7c801",
        "6651a0b1c2d3e4f5a6b7c802"
    ]
}

الإستجابة

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

{
    "data": [
        {
            "properties": {
                "_id": "6651a0b1c2d3e4f5a6b7c801",
                "deal_name": "Annual support contract",
                "deal_stage": "appointment_scheduled",
                "amount": 1200,
                "created_at": "2026-10-20T10:05:00.000000Z"
            }
        },
        {
            "properties": {
                "_id": "6651a0b1c2d3e4f5a6b7c802",
                "deal_name": "Website redesign",
                "deal_stage": "contract_sent",
                "amount": 4500,
                "created_at": "2026-10-18T13:40:00.000000Z"
            }
        }
    ]
}


إلغاء ربط صفقة بالتذكرة

POST https://app.alaaqat.com/api/tickets/{ticket_id}/detach-deal

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

ترويسة الطلب

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

محتوى الطلب

{
    deal_id: string
}
الحقل مطلوب التحققات الوصف
deal_id مطلوب معرّف إحدى صفقاتك الصفقة التي يُلغى ربطها بالتذكرة.
{
    "deal_id": "6651a0b1c2d3e4f5a6b7c802"
}

الإستجابة

200 OK، وتأتي التذكرة ضمن data.

{
    "data": {
        "properties": {
            "_id": "6652b0c1d2e3f4a5b6c7d901",
            "ticket_name": "Order not delivered",
            "desc": "The client ordered five days ago and the parcel has not arrived.",
            "category": "general_inquiry",
            "priority": "high",
            "created_by": 12,
            "updated_at": "2026-10-21T10:02:00.000000Z",
            "created_at": "2026-10-20T11:20:00.000000Z"
        }
    },
    "message": "Entity was modified successfully."
}