الحملات من البداية إلى النهاية
أنشئ الحملة، واكتب الرسائل، وأضف قائمة، واختر صناديق البريد وأطلقها. كل خطوة استدعاء واحد، ولا يُرسل شيء قبل الإطلاق.
لا يُرسل شيء حتى تستدعي launch. الخطوات نفسها متوفرة كأوامر في سطر الأوامر وكأدوات MCP، لذا يستطيع الوكيل تشغيل المسار كاملًا وسؤال المستخدم قبل الإطلاق. أرسل ترويسة Idempotency-Key مع كل استدعاء حتى لا تنفّذ إعادة المحاولة العمل مرتين أبدًا.
تحقق من أن صندوق بريد متصل
curl "https://app.argorant.com/api/v1/inboxes" -H "Authorization: Bearer $ARGORANT_API_KEY"لا يوجد صندوق بريد بعد؟ اربط Google Workspace بخطوة واحدة (الدليل)، أو Microsoft 365 في التطبيق، أو صندوق بريد من أي مزوّد آخر بإعدادات الخادم الخاصة به (الدليل).
أنشئ الحملة بإعداداتها
curl -X POST "https://app.argorant.com/api/v1/campaigns" \
-H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
-d '{
"name": "Q4 CFO outreach",
"daily_limit": 40, "per_mailbox_daily_limit": 20,
"timezone": "Europe/Berlin", "timezone_mode": "fixed",
"window_start": "08:00", "window_end": "17:00", "skip_weekends": true,
"gap_minutes_min": 60, "gap_minutes_max": 120,
"planned_start_date": "2026-10-01", "tags": ["q4"]
}'الحقل name وحده مطلوب، ويمكن تغيير كل إعداد لاحقًا باستخدام PATCH /api/v1/campaigns/{id}. مع timezone_mode: "lead" يتم الإرسال في التوقيت المحلي لكل شخص. ترسل الحملات نصًا عاديًا، وهو الأفضل وصولًا إلى صندوق الوارد. لا يوجد سطر إلغاء اشتراك ما لم تعيّن include_unsubscribe على true.
اكتب التسلسل
curl -X POST "https://app.argorant.com/api/v1/campaigns/$ID/emails" \
-H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
-d '{"emails":[
{"subject":"Quick question, {{first_name}}","body":"Hi {{first_name}},\n\nsaw {{company}} is hiring in finance. Worth a 10 minute call?\n\nBest"},
{"body":"Bumping this up in case it got buried.","delay_days":3,"same_thread":true}
]}'تحتاج الرسالة الأولى إلى سطر موضوع. تبقى رسائل المتابعة في السلسلة نفسها افتراضيًا، وتنتظر delay_days بعد الرسالة السابقة. يمكنك استخدام {{first_name}} و{{last_name}} و{{company}} و{{company_normalized}} (الاسم الذي يستخدمه الناس) و{{title}} وأي عمود أرسلته مع الأشخاص، مثل {{plan}}. اكتب {a|b} لتنويع عبارة لكل شخص. أضف variants إلى رسالة لتحصل على نسخ أخرى منها، وتُرسل هذه النسخ بالتناوب. يُعدّ سطر شخصي لكل شخص باستخدام PUT /api/v1/campaigns/{id}/personalization، راجع اعثر على 200 شخص وراسلهم.
أضف القائمة إلى الحملة
curl -X POST "https://app.argorant.com/api/v1/campaigns/$ID/leads" \
-H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
-d '{"list_id": 1240}'
# {"input_rows": 1240, "inserted": 1188, "duplicates_skipped": 12, "skipped_not_valid": 40, "queued_for_verification": 0}أو أرسل rows الخاصة بك مع email وfirst_name وlast_name وcompany وtitle وأي عمود خاص بك. يُفحص كل عنوان قبل أن ينضم. عندما تحتوي القائمة على عناوين لا يمكن تأكيدها، تسأل الإجابة الأولى عن العناوين التي تُؤخذ (needs_choice)، فاستدعِ مرة أخرى مع "grades": ["valid"] (موصى به) أو ["valid", "catch_all"]. يكلّف كل شخص من بيانات Argorant رصيدًا واحدًا في المرة الأولى، وصفوفك الخاصة مجانية. تُضاف العناوين الخاصة (البريد المجاني، والإنترنت المنزلي) مثل أي عنوان آخر، وأرسل "exclude_private_emails": true لعناوين بريد الأعمال فقط.
اربط المرسِلين
curl -X POST "https://app.argorant.com/api/v1/campaigns/$ID/senders" \
-H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
-d '{"all_connected": true}'أو حدّد emails بعينها. تُوزَّع الرسائل على صناديق البريد، كل منها ضمن حده اليومي الخاص.
أطلق الحملة
curl "https://app.argorant.com/api/v1/campaigns/$ID" -H "Authorization: Bearer $ARGORANT_API_KEY" | jq .launch_blockers
curl -X POST "https://app.argorant.com/api/v1/campaigns/$ID/launch" -H "Authorization: Bearer $ARGORANT_API_KEY"تكون launch_blockers فارغة عندما تكون الحملة جاهزة للانطلاق. قبل الإطلاق، يرسل POST /api/v1/campaigns/{id}/test-email إليك نسخة اختبار واحدة من رسالة، معبّأة ببيانات جهة اتصال نموذجية. لا تطلق الحملة إلا بعد أن يوافق المستخدم. يوقف pause الحملة مؤقتًا، وينهيها stop، ويزيل DELETE حملة ليست قيد التشغيل.
راقب سير الحملة
يعطي GET /api/v1/campaigns/{id}/analytics?days=30 الأرقام اليومية (المرسلة، والردود، والردود الإيجابية، وحالات الارتداد، وإلغاءات الاشتراك) مع المجاميع والنسب. ويعرض GET /api/v1/campaigns/{id} الأعداد الحية. ويسرد GET /api/v1/campaigns/{id}/leads?status=replied من ردّوا، ويعطي GET /api/v1/campaigns/{id}/replies رسائلهم. للردود عبر كل الحملات استخدم صندوق الوارد. ويسرد GET /api/v1/campaigns/{id}/senders صناديق البريد التي ترسل الحملة، مع حالتها.
غيّر الأشخاص في حملة قيد التشغيل
يُخرج POST /api/v1/campaigns/{id}/leads/remove كثيرًا من الأشخاص دفعة واحدة، يُختارون حسب الحالة، أو الرد، أو الارتداد، أو نطاق البريد، أو الوسم، أو العناوين، أو قائمة محفوظة. أرسل "preview": true أولًا لترى كم شخصًا سيخرج. يبقى الأشخاص الذين تلقّوا رسالة بالفعل ما لم ترسل "include_contacted": true. تعمل الإضافة أو الإزالة الكبيرة في الخلفية: تكون الإجابة 202 مع مهمة، ويوضح GET /api/v1/campaigns/{id}/lead-jobs/{job_id} مدى تقدّمها.
توضع الأسطر الشخصية لكثير من الأشخاص في ملف واحد: يقبل POST /api/v1/campaigns/{id}/leads/custom-fields/import ملف CSV أو JSON أو NDJSON يضم حتى 200,000 صف (50 MB). تُحفظ الأسطر الموجودة لدى الأشخاص بالفعل، وتُسرد مع صفها. لتصحيحها، ارفع الملف مع ?overwrite=true، ويزيل عمود clear (أو null في JSON) السطر، فيعود الشخص إلى النص البديل. يعود كل سطر مستبدل في الإجابة، القديم والجديد.
المجلدات
يسرد GET /api/v1/folders مجلداتك، وينشئ POST /api/v1/folders مجلدًا، ويعيد PATCH /api/v1/folders/{id} تسميته. يضع POST /api/v1/campaigns/{id}/folder مع folder_id حملةً في مجلد، ويخرجها null منه مرة أخرى. المجلدات لترتيب الحملات فقط، ولا تؤثر في الإرسال.
صناديق البريد وقائمة الحظر
يسرد GET /api/v1/inboxes صناديق البريد الخاصة بك مع فلاتر للنطاق والحالة والوسم والمزوّد. ويعيّن PATCH /api/v1/inboxes/{email} الحد اليومي لصندوق البريد، والإحماء، وما إذا كان مسموحًا له بالإرسال، واسمه أو منطقته الزمنية، ويفصله DELETE. ويطبّق POST /api/v1/inboxes/update التغيير نفسه على كثير من صناديق البريد دفعة واحدة، تُختار حسب النطاق أو الوسم أو الحالة أو العنوان، وهو يعرض معاينة افتراضيًا ولا يغيّر شيئًا حتى ترسل "preview": false. يوقف POST /api/v1/blocklist مع عنوان أو نطاق كل رسالة إليه في مساحة العمل لديك، ويرفع DELETE /api/v1/blocklist/{id} ذلك مرة أخرى.
الخطوات نفسها في الطرفية
argorant campaigns create --name "Q4 CFO outreach" --daily-limit 40 --window 08:00-17:00 --timezone Europe/Berlin
argorant campaigns emails set "Q4 CFO" --step 1 --subject "Quick question, {{first_name}}" --body-file step1.txt
argorant campaigns emails set "Q4 CFO" --step 2 --body "Bumping this up." --delay-days 3
argorant campaigns leads add "Q4 CFO" --list 1240
argorant campaigns senders set "Q4 CFO" --all
argorant campaigns test "Q4 CFO" --step 1
argorant campaigns launch "Q4 CFO"
argorant campaigns leads remove "Q4 CFO" --not-replied --domains competitor.com --preview
argorant campaigns folders create --name "Q4"
argorant campaigns move "Q4 CFO" --folder Q4
argorant inboxes update --domains northgate-advisory.com --daily-limit 30