وثائق المطورين

البدء السريع

أرسل أول حدث تحويل إلى Campify في ثلاث خطوات.

• من صفحة التكاملات في مساحة العمل، أنشئ مفتاح API بصلاحية events:write. يظهر المفتاح مرة واحدة فقط؛ احفظه في مكان آمن.
• انسخ معرّف مساحة العمل (workspaceId) من العنوان نفسه.
• أرسل حدثاً كما في المثال. رد 201 يعني أنه سُجّل، ورد 200 يعني أنه وصل من قبل بالمعرّف externalId نفسه.

curl -X POST https://campify.ai/v1/workspaces/$WORKSPACE_ID/events \
  -H "Authorization: Bearer $CAMPIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "order_paid",
    "occurredAt": "2026-09-26T10:00:00Z",
    "contactId": "<contact id>",
    "campaignId": "<campaign id>",
    "valueMinor": 25000,
    "currency": "SAR",
    "externalId": "order-10045"
  }'

للتحقق من وصوله، افتح تقرير الحملة: لوحة «اختبار حدث التحويل» تعرض آخر ما استُلم وسبب احتسابه أو عدمه.