الحملات المتكاملة

أنشئ النص الإعلاني ومسودة واتساب وصورة وتعليقاً صوتياً اختياريين في طلب واحد آمن لإعادة المحاولة دون خصم الرصيد مرتين.

POST/campaigns

حملة عربية مع صورة وصوت

ينشئ ثلاث نسخ ومسودة واتساب وصورة وصوتاً في عملية واحدة. تكلف هذه الحملة 12 عملة مع صورة بدقة 1K، أو 15 عملة مع صورة بدقة 2K.

curl --request POST \
  --url https://www.lahjty.com/api/v1/campaigns \
  --header "Authorization: Bearer $LAHJTY_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: campaign-merchant91-1849" \
  --data '{
  "external_id": "campaign-1849",
  "external_customer_id": "merchant-91",
  "brief": {
    "description": "Weekend offer for a specialty coffee subscription",
    "product": "Monthly specialty coffee subscription",
    "offer": "20% off through Saturday",
    "objective": "Drive WhatsApp orders",
    "output_language": "ar",
    "market": "SA",
    "dialect": "saudi",
    "platform": "whatsapp",
    "tone": "warm",
    "audience": "specific",
    "specific_audience": "Young professionals in Riyadh",
    "required_keywords": [
      "قهوة مختصة"
    ],
    "excluded_keywords": [
      "مجاني"
    ],
    "call_to_action": "اطلب الآن"
  },
  "deliverables": {
    "copy": {
      "type": "ad_copy",
      "framework": "aida"
    },
    "image": {
      "enabled": true,
      "type": "product_showcase",
      "style": "photorealistic",
      "aspect_ratio": "1:1",
      "resolution": "1K",
      "visual_keywords": [
        "specialty coffee",
        "Riyadh morning"
      ],
      "excluded_visuals": [
        "people",
        "logos"
      ],
      "include_text": false
    },
    "speech": {
      "enabled": true,
      "voice_profile": "confident_announcer",
      "delivery": "natural",
      "content_type": "marketing"
    }
  },
  "metadata": {
    "experiment": "repeat-use-pilot"
  }
}'

Example response

response.json

{
  "id": "cmp_01jexample",
  "object": "campaign",
  "request_id": "req_01jexample",
  "status": "completed",
  "external_id": "campaign-1849",
  "output_language": "ar",
  "market": "SA",
  "dialect": "saudi",
  "copy": {
    "variants": [
      {
        "index": 1,
        "content": "..."
      }
    ]
  },
  "whatsapp_template": {
    "status": "draft",
    "header": "خصم 20٪ حتى السبت",
    "body": "...",
    "footer": null,
    "buttons": [
      {
        "type": "quick_reply",
        "text": "اطلب الآن"
      }
    ],
    "warnings": [
      "This convenience draft is not a Meta submission payload."
    ]
  },
  "image": {
    "url": "https://example.convex.cloud/api/storage/image"
  },
  "speech": {
    "url": "https://example.convex.cloud/api/storage/audio"
  },
  "usage": {
    "credits_used": 12,
    "balance_after": 476
  }
}

POST/campaigns

حملة نص فقط

عطّل الصورة والصوت لتجربة منخفضة المخاطر بتكلفة عملتين.

curl --request POST \
  --url https://www.lahjty.com/api/v1/campaigns \
  --header "Authorization: Bearer $LAHJTY_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: campaign-copy-only-1850" \
  --data '{
  "external_id": "campaign-1850",
  "external_customer_id": "merchant-93",
  "brief": {
    "description": "Back-to-school stationery sale",
    "output_language": "en",
    "market": "AE",
    "platform": "whatsapp",
    "tone": "friendly",
    "call_to_action": "Shop the collection"
  },
  "deliverables": {
    "copy": {
      "type": "ad_copy",
      "framework": "aida"
    },
    "image": {
      "enabled": false
    },
    "speech": {
      "enabled": false
    }
  }
}'

سلوك الفشل الجزئي

تُحسب تكلفة الحملة حسب المخرجات المطلوبة وتُسترد عند فشل التوليد وفق عقد الواجهة. احتفظ بالنص السابق للتاجر حتى تُخزّن الاستجابة المكتملة.