انتقل للمحتوى

    عربي أو إنجليزي · ↑↓ للتنقل · Enter للفتح · Esc للقفل

    English
    في الصفحة دي

    أول حملة بأمان

    ابعت رسالة لناس كتير من غير ما تأذي رقمك: جرّب، نوّع النص، اختار السرعة، وتابع بالويب هوك.

    الحملة هي الطريقة الآمنة إنك تكلم ناس كتير: حماية الرقم بتنظم سرعتها، وبتحترم ساعات الهدوء، وبتتخطى الأرقام الغلط واللي لغت اشتراكها، وبتقف لو فيه إشارات وحشة. إنك تبعت لنفس الناس POST /v2/messages واحدة واحدة بيتنظم برضه — وغلطه أسهل.

    قبل ما تبعت

    • كلّم بس الناس اللي وافقوا يستقبلوا منك. optInConfirmed: true هو تأكيدك المكتوب وإجباري.
    • شوف صحة الرقم ومرحلة التسخين بـ GET /v2/numbers/{numberId}/health. الرقم الجديد حدوده اليومية للأرقام الجديدة قليلة (20 في اليوم في أول أيامه).
    • نوّع النص: أكتر من 50 رقم جديد في 24 ساعة محتاجين {متغير} أو [[صيغة|تانية]] — النص المتطابق لأرقام جديدة كتير بيترفض (IDENTICAL_MESSAGE_TEXT).
    • مفيش روابط مختصرة، ومفيش روابط لأرقام جديدة من رقم عمره أقل من 7 أيام.

    1. اعملها مسودة وجرّبها على نفسك

    اعمل الحملة بـ start: false وحط اتنين أو تلاتة من أرقامك كمستلمين. شوف إيه اللي وصل على الموبايلات، وبعدين اعمل الحقيقية.

    curl -X POST "https://mursilat.com/api/v2/campaigns" \
      -H "Authorization: Bearer $WASLA_API_KEY" \
      -H "Idempotency-Key: order-1042-confirm" \
      -H "Content-Type: application/json" \
      -d '{
      "numberId": "cm1abcd2345efgh6789ijkl",
      "name": "عرض الجمعة",
      "content": {
        "type": "cta_url",
        "body": {
          "text": "أهلاً {name|عميلنا} 👋 خصم 20% لحد الجمعة"
        },
        "cta": {
          "title": "شوف العرض",
          "url": "https://example.com/offer?ref={name}"
        }
      },
      "recipients": [
        {
          "phone": "201001234567",
          "variables": {
            "name": "منى"
          }
        },
        {
          "phone": "966501234567"
        }
      ],
      "optInConfirmed": true,
      "speed": "SAFE"
    }'

    2. اختار السرعة

    speedإمتى
    SAFEإمتىالأرقام الجديدة، القوايم الباردة، أول حملات. الأبطأ.
    NORMALإمتىالافتراضي. أرقام ثابتة وصحتها كويسة.
    FASTإمتىجمهور دافي يعرفك. برضه جوه حدود الحماية.

    ساعات الهدوء بتتطبق على الحملات (الافتراضي 10 بالليل لـ 9 الصبح بتوقيتك): الإرسال بيستنى ويكمّل الصبح. رسايل الحملات الباردة بيتضاف لها سطر الإلغاء بتاعك (الافتراضي «للإلغاء أرسل: إلغاء»).

    3. تابعها

    اشترك في campaign.status واقرا التقدم بـ GET /v2/campaigns/{campaignId} (الأعداد، سبب الإيقاف، الوقت المتوقع). الحماية بتوقف الحملة لوحدها لو التسليم نزل تحت 80% في آخر ساعة، أو لو أكتر من 3 من كل 100 لغوا اشتراكهم، أو لو واتساب حد من سرعة الرقم — أول مرة ساعة، وبعدها 24 ساعة. صلّح السبب قبل ما تكمّل.

    4. بعد ما تخلص

    خلال 24 ساعة من نهايتها، نص الحملة ورابط الميديا والأزرار وكل صفوف المستلمين بيتمسحوا. الإجماليات بتفضل (purged: true)؛ والمستلمين بيردوا 410 CAMPAIGN_PURGED. صدّر اللي محتاجه قبلها.