أول حملة بأمان
ابعت رسالة لناس كتير من غير ما تأذي رقمك: جرّب، نوّع النص، اختار السرعة، وتابع بالويب هوك.
الحملة هي الطريقة الآمنة إنك تكلم ناس كتير: حماية الرقم بتنظم سرعتها، وبتحترم ساعات الهدوء، وبتتخطى الأرقام الغلط واللي لغت اشتراكها، وبتقف لو فيه إشارات وحشة. إنك تبعت لنفس الناس 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"
}'const res = await fetch('https://mursilat.com/api/v2/campaigns', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.WASLA_API_KEY}`,
'Idempotency-Key': 'order-1042-confirm',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"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"
}),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error.code}: ${data.error.message}`);
console.log(data);import os
import requests
headers = {"Authorization": f"Bearer {os.environ['WASLA_API_KEY']}", "Idempotency-Key": "order-1042-confirm"}
res = requests.post(
"https://mursilat.com/api/v2/campaigns",
headers=headers,
json={
"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"
},
timeout=30,
)
data = res.json()
if not res.ok:
raise RuntimeError(f"{data['error']['code']}: {data['error']['message']}")
print(data)<?php
$ch = curl_init('https://mursilat.com/api/v2/campaigns');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('WASLA_API_KEY'),
'Idempotency-Key: order-1042-confirm',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'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'
], JSON_UNESCAPED_UNICODE),
]);
$data = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($status >= 400) { throw new Exception($data['error']['code'] . ': ' . $data['error']['message']); }
print_r($data);2. اختار السرعة
speed | إمتى |
|---|---|
SAFE | إمتىالأرقام الجديدة، القوايم الباردة، أول حملات. الأبطأ. |
NORMAL | إمتىالافتراضي. أرقام ثابتة وصحتها كويسة. |
FAST | إمتىجمهور دافي يعرفك. برضه جوه حدود الحماية. |
ساعات الهدوء بتتطبق على الحملات (الافتراضي 10 بالليل لـ 9 الصبح بتوقيتك): الإرسال بيستنى ويكمّل الصبح. رسايل الحملات الباردة بيتضاف لها سطر الإلغاء بتاعك (الافتراضي «للإلغاء أرسل: إلغاء»).
3. تابعها
اشترك في campaign.status واقرا التقدم بـ GET /v2/campaigns/{campaignId} (الأعداد، سبب الإيقاف، الوقت المتوقع). الحماية بتوقف الحملة لوحدها لو التسليم نزل تحت 80% في آخر ساعة، أو لو أكتر من 3 من كل 100 لغوا اشتراكهم، أو لو واتساب حد من سرعة الرقم — أول مرة ساعة، وبعدها 24 ساعة. صلّح السبب قبل ما تكمّل.
- GETالتقدم وسبب الإيقاف والوقت المتوقع
/v2/campaigns/{campaignId} - GETالمستلمين وردود الأزرار
/v2/campaigns/{campaignId}/recipients - POSTإيقاف مؤقت
/v2/campaigns/{campaignId}/pause - POSTاستكمال
/v2/campaigns/{campaignId}/resume
4. بعد ما تخلص
خلال 24 ساعة من نهايتها، نص الحملة ورابط الميديا والأزرار وكل صفوف المستلمين بيتمسحوا. الإجماليات بتفضل (purged: true)؛ والمستلمين بيردوا 410 CAMPAIGN_PURGED. صدّر اللي محتاجه قبلها.