معلوماتی مرکز

Zinn® Campaigns API اور MCP: ڈویلپر گائیڈ

سائن ان کرنا، اجازتیں، مثالیں، حدود، غلطیاں، ویب ہکس اور Zinn® Campaigns API کا ہر آپریشن، بشمول یہ کہ ایک AI اسسٹنٹ MCP کے ذریعے کون سے آپریشن چلا سکتا ہے۔

ڈیش بورڈ پر Zinn® Campaigns میں جو کچھ بھی آپ کر سکتے ہیں، وہ API کے ذریعے بھی کر سکتے ہیں، اور اس کا زیادہ تر حصہ MCP کے ذریعے اپنے اکاؤنٹ سے منسلک AI اسسٹنٹ کے ذریعے بھی انجام دے سکتے ہیں۔ یہ گائیڈ سائن ان کرنے، اجازتوں، دونوں طریقوں کی ایک عملی مثال، حدود، غلطیوں اور Campaigns کے تمام 89 آپریشنز میں سے ہر ایک کا احاطہ کرتی ہے۔ نیچے دی گئی آپریشنز کی فہرست ہماری API وضاحت سے تیار کی گئی ہے، اس لیے یہ ہمیشہ وہی ظاہر کرتی ہے جو API کرتا ہے۔ ہر آپریشن کا ہر فیلڈ zinndigital.com/developers/api/zinn-campaigns پر موجود API حوالہ میں دستیاب ہے۔

سائن ان کرنا

API کیز۔ ڈیش بورڈ میں ترتیبات ← API کیز کے تحت ایک کلید بنائیں اور اسے Authorization: Bearer zdk_live_… کے طور پر بھیجیں (ایک zdk_test_… کلید سینڈ باکس موڈ میں کام کرتی ہے)۔ کلید کو صرف اتنی Campaigns کی اجازتیں دیں جتنی درکار ہوں، اس سے زیادہ نہیں۔
AI معاونین (MCP)۔ ایپ سے سائن ان کر کے یا کنکشن ٹوکن (zmcp_live_…) کے ذریعے Claude، ChatGPT، Cursor یا کسی بھی MCP کلائنٹ کو https://api.zinndigital.com/v1/mcp سے مربوط کریں۔ Claude، Cursor یا ChatGPT کو اپنے اکاؤنٹ سے مربوط کرنا دیکھیں۔ رضامندی کی اسکرین پر، Zinn® Campaigns کی اجازتوں کو منتخب کریں۔
اجازتیں (Permissions)۔ email_marketing.view مہمات، فہرستوں، روابط، فارمز، بھیجنے والوں، SMS کی ترتیبات اور رپورٹس کو پڑھتا ہے؛ email_marketing.manage انہیں بناتا اور تبدیل کرتا ہے۔ جو مہمات آپ اپنی ای میل سروس کے ذریعے بھیجتے ہیں وہ campaigns.view اور campaigns.manage استعمال کرتی ہیں۔
ری سیلرز۔ اپنے کلائنٹ کی تنظیموں میں سے کسی ایک پر کارروائی کرنے کے لیے org_id پاس کریں۔ جب آپ کی کلید یا کنکشن صرف ایک تنظیم تک رسائی رکھتا ہو تو اسے چھوڑ دیں۔

مثال: API کی مدد سے ایک ڈرافٹ مہم بنائیں

curl -X POST https://api.zinndigital.com/v1/email-marketing/campaigns \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Spring sale",
  "subject": "Our spring sale starts today",
  "list_id": "<list id>",
  "sender_id": "<sender id>",
  "template": "basic"
}'

جواب مسودے کے ساتھ 201 ہے۔ اسے POST /v1/email-marketing/campaigns/{campaign_id}/test کے ذریعے ٹیسٹ کریں، GET /v1/email-marketing/campaigns/{campaign_id}/lint سے اس کی جانچ کریں، اور POST /v1/email-marketing/campaigns/{campaign_id}/send کے ساتھ اسے بھیجیں۔

مثال: AI اسسٹنٹ کی جانب سے وہی مسودہ

اپنے اسسٹنٹ سے سادہ الفاظ میں کہیں، مثال کے طور پر "بہار کی سیل کے عنوان سے ایک Zinn® Campaigns ای میل کا مسودہ تیار کریں جس کا موضوع 'ہماری بہار کی سیل آج سے شروع ہو رہی ہے' ہو"۔ پس منظر میں، یہ api_operations_search کے ذریعے آپریشن تلاش کرتا ہے، api_operation_get سے اس کے پیرامیٹرز پڑھتا ہے، اور اسے api_operation_call کے ساتھ چلاتا ہے:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "api_operation_call",
    "arguments": {
      "operation_id": "createEmailMarketingCampaign",
      "confirm": true,
      "body": {
        "name": "Spring sale",
        "subject": "Our spring sale starts today"
      }
    }
  }
}

معاون کیا نہیں کرے گا۔ کوئی بھی ایسا عمل جو آپ کے وصول کنندگان کو کچھ بھیجے یا پیسے یا الاؤنس خرچ کرے — مہم بھیجنا، SMS یا WhatsApp پیغامات بھیجنا، AI کریڈٹس کے ساتھ لکھنا، US ٹیکسٹنگ کے لیے رجسٹر کرنا — معاون کے لیے ممنوع ہے، تاکہ غلط سمجھی گئی ہدایت آپ کے صارفین تک کبھی نہ پہنچ سکے۔ معاون مسودہ تیار کرتا ہے؛ آپ ڈیش بورڈ میں Send دباتے ہیں یا خود API کو کال کرتے ہیں۔ رازداری کی چیزیں جیسے کہ SMTP پاس ورڈ بھی معاون کے ذریعے کبھی منتقل نہیں کی جاتیں: انہیں ڈیش بورڈ میں درج کریں۔

حدود

ہر فرد یا API کلید کے لیے 1,200 درخواستیں فی منٹ، اور ہر تنظیم کے لیے 6,000 درخواستیں فی منٹ۔ دونوں میں سے جو زیادہ سخت ہو وہ لاگو ہوتی ہے۔
ہر MCP کنکشن کے لیے 600 درخواستیں فی منٹ۔
حد سے تجاوز پر، جواب Retry-After ہیڈر کے ساتھ 429 آتا ہے: اتنے سیکنڈ انتظار کریں۔
فہرست کے اراکین کو شامل کرنے میں زیادہ سے زیادہ فی درخواست 1,000 پتے لیے جاتے ہیں؛ آپ کے پلان کے رابطہ اور ای میل الاؤنسز ہر اس چیز پر لاگو ہوتے ہیں جو آپ API کے ذریعے کرتے ہیں۔

نقائص

ہر خرابی کی بناوٹ ایک جیسی ہوتی ہے:

{"error": {"code": "UNPROCESSABLE_ENTITY", "message": "…", "details": [{"field": "subject", "code": "REQUIRED", "message": "…"}], "request_id": "…"}}

ایک ہی مسئلے کے لیے code کبھی تبدیل نہیں ہوتا، لہٰذا message کے بجائے اس کی جانچ کریں۔ سپورٹ سے رابطہ کرتے وقت request_id کا حوالہ دیں۔ وہ جوابات جن کا آپ کو سامنا ہو سکتا ہے: 401 UNAUTHORIZED، 403 FORBIDDEN، 404 NOT_FOUND، 409 CONFLICT، 422 UNPROCESSABLE_ENTITY، 429 TOO_MANY_REQUESTS۔ 403 کا مطلب ہے کہ کلید یا کنکشن میں نیچے دی گئی فہرست میں درج اجازت کی کمی ہے؛ 404 تنظیم میں ایسی چیز کا بھی احاطہ کرتا ہے جسے آپ نہیں دیکھ سکتے؛ 422 details میں ہر غلط فیلڈ کو درج کرتا ہے؛ 429 کے بعد، Retry-After ہیڈر میں سیکنڈز کی تعداد کا انتظار کریں۔

ویب ہکس

ڈیلیوری کے نتائج آپ کی ای میل بھیجنے والے فراہم کنندہ سے Zinn® Campaigns میں داخل ہوتے ہیں:

اپنے ذاتی فراہم کنندہ (مثال کے طور پر Resend) کے ساتھ، ڈیش بورڈ میں بھیجنے والے کنکشن پر اس کے ویب ہک پر دستخط کرنے کا خفیہ راز محفوظ کریں (مہمات ← بھیجنا)۔ آپ کو ایک webhook_url ملتا ہے؛ فراہم کنندہ کے delivered، bounced اور complained ایونٹس کو اس کی طرف اشارہ کریں۔ کوئی باؤنس یا اسپام کی شکایت فوری طور پر مستقبل کی ترسیل سے اس پتے کو ہٹا دیتی ہے۔
Zinn® بھیجنے کے ساتھ، سیٹ اپ کرنے کے لیے کچھ نہیں ہے۔

نتائج کو رپورٹ کے آپریشنز (getEmailMarketingCampaignReport، getSmsMarketingCampaignReport) کے ذریعے پڑھیں۔

مہمات کا ہر آپریشن

جائزہ

GET /v1/email-marketing — ایک تنظیم کے لیے Zinn® Campaigns کا جائزہ۔ آپریشن getEmailMarketingOverview۔ چیک کی گئی اجازتیں: email_marketing.view۔ ایک AI معاون سے: ہاں، MCP کے ذریعے۔

ای میل مہمات

GET /v1/email-marketing/campaigns — ای میل مہمات، پہلے تازہ ترین، ایک keyset صفحہ۔ آپریشن listEmailMarketingCampaigns۔ چیک کی گئی اجازتیں: email_marketing.view۔ AI اسسٹنٹ کی جانب سے: جی ہاں، MCP کے ذریعے۔
POST /v1/email-marketing/campaigns — ایک ڈرافٹ ای میل مہم بنائیں۔ آپریشن createEmailMarketingCampaign۔ چیک کی گئی اجازتیں: email_marketing.manage, email_marketing.view۔ AI اسسٹنٹ کی جانب سے: جی ہاں، MCP کے ذریعے۔
GET /v1/email-marketing/campaigns/{campaign_id} — ایک ای میل مہم۔ آپریشن getEmailMarketingCampaign۔ چیک کی گئی اجازتیں: email_marketing.view۔ AI اسسٹنٹ کی جانب سے: جی ہاں، MCP کے ذریعے۔
PATCH /v1/email-marketing/campaigns/{campaign_id} — ایک ڈرافٹ (یا مسترد شدہ مہم، جو واپس ڈرافٹ میں بدل جاتی ہے) میں ترمیم کریں۔ آپریشن updateEmailMarketingCampaign۔ چیک کی گئی اجازتیں: email_marketing.manage, email_marketing.view۔ AI اسسٹنٹ کی جانب سے: جی ہاں، MCP کے ذریعے۔
GET /v1/email-marketing/campaigns/{campaign_id}/lint — مہم بھیجنے سے پہلے اس کے متن میں ڈیلیوری کے مسائل کی جانچ کریں۔ آپریشن lintEmailMarketingCampaign۔ چیک کی گئی اجازتیں: email_marketing.view۔ AI اسسٹنٹ کی جانب سے: جی ہاں، MCP کے ذریعے۔
GET /v1/email-marketing/campaigns/{campaign_id}/report — کسی مہم کے اعداد و شمار۔ آپریشن getEmailMarketingCampaignReport۔ چیک کی گئی اجازتیں: email_marketing.view۔ AI اسسٹنٹ کی جانب سے: جی ہاں، MCP کے ذریعے۔
POST /v1/email-marketing/campaigns/{campaign_id}/send — مہم کو اس کی فہرست پر بھیجنا شروع کریں۔ آپریشن sendEmailMarketingCampaign۔ چیک کردہ اجازتیں: email_marketing.manage، email_marketing.view۔ AI اسسٹنٹ کی جانب سے: صرف API اور ڈیش بورڈ: اس سے رقم یا الاؤنس خرچ ہوتا ہے، اس لیے کوئی فرد اسے دباتا ہے (حقیقی وصول کنندگان کو بھیجتا ہے اور الاؤنس خرچ کرتا ہے)۔
POST /v1/email-marketing/campaigns/{campaign_id}/test — اب تنظیم کے کسی رکن کو ایک امتحانی کاپی بھیجیں۔ آپریشن testEmailMarketingCampaign۔ چیک کردہ اجازتیں: email_marketing.manage، email_marketing.view۔ AI اسسٹنٹ کی جانب سے: ہاں، MCP کے ذریعے۔
POST /v1/email-marketing/campaigns/{campaign_id}/translate — مہم کا ترجمہ ہر اس رابطے کی زبان میں کریں جو غائب یا پرانی ہو۔ آپریشن translateEmailMarketingCampaign۔ چیک کردہ اجازتیں: email_marketing.manage، email_marketing.view۔ AI اسسٹنٹ کی جانب سے: ہاں، MCP کے ذریعے۔
GET /v1/email-marketing/campaigns/{campaign_id}/translations — مہم کی فہرست کے ہر رابطے کی زبان اور آیا اس کا ترجمہ تازہ ترین ہے۔ آپریشن listEmailMarketingCampaignTranslations۔ چیک کردہ اجازتیں: email_marketing.view۔ AI اسسٹنٹ کی جانب سے: ہاں، MCP کے ذریعے۔

AI کے ساتھ تحریر

POST /v1/email-marketing/ai/write — Zinn® AI کے ساتھ ایک مختصر خلاصے سے مہم کے لیے ایک مسودہ ای میل لکھیں۔ آپریشن writeEmailMarketingCampaignWithAi۔ جانچے گئے اجازت نامے: email_marketing.manage، email_marketing.view۔ ایک AI معاون کی جانب سے: صرف API اور ڈیش بورڈ: یہ رقم یا الاؤنس خرچ کرتا ہے، لہذا کوئی شخص اسے دبائے (AI سے لکھوانے میں AI کریڈٹس خرچ ہوتے ہیں)۔

برانڈ کٹ

GET /v1/email-marketing/brand-kit — تنظیم کی برانڈ کٹ (نام، لوگو، رنگ، فونٹ، لہجہ)۔ آپریشن getEmailMarketingBrandKit۔ جانچے گئے اجازت نامے: email_marketing.view۔ ایک AI معاون کی جانب سے: ہاں، MCP کے ذریعے۔
PUT /v1/email-marketing/brand-kit — برانڈ کٹ میں ترمیم کریں۔ آپریشن updateEmailMarketingBrandKit۔ جانچے گئے اجازت نامے: email_marketing.manage، email_marketing.view۔ ایک AI معاون کی جانب سے: ہاں، MCP کے ذریعے۔
POST /v1/email-marketing/brand-kit/read — تنظیم کی ویب سائٹ سے برانڈ کٹ پڑھیں۔ آپریشن readEmailMarketingBrandKit۔ جانچے گئے اجازت نامے: email_marketing.manage، email_marketing.view۔ ایک AI معاون کی جانب سے: ہاں، MCP کے ذریعے۔

رابطے اور یک بارگی پیغامات

GET /v1/email-marketing/contacts — تنظیم کے رابطے، ایک وقت میں ایک keyset صفحہ۔ آپریشن listEmailMarketingContacts۔ جانچی گئی اجازتیں: email_marketing.view۔ AI اسسٹنٹ کی جانب سے: ہاں، MCP کے ذریعے۔
POST /v1/email-marketing/contacts/{contact_id}/messages — ایک رابطے کو ایک SMS بھیجیں، جس کی ادائیگی Zinn® کریڈٹ بیلنس سے کی جاتی ہے۔ آپریشن sendEmailMarketingMessage۔ جانچی گئی اجازتیں: email_marketing.manage، email_marketing.view۔ AI اسسٹنٹ کی جانب سے: صرف API اور ڈیش بورڈ: یہ رقم یا الاؤنس خرچ کرتا ہے، اس لیے کوئی شخص اسے دباتا ہے (کسی رابطے کو یک طرفہ پیغام الاؤنس خرچ کرتا ہے)۔
GET /v1/email-marketing/messages — تنظیم کی طرف سے بھیجے گئے SMS اور WhatsApp پیغامات، پہلے نئے پیغامات، ایک keyset صفحہ۔ آپریشن listEmailMarketingMessages۔ جانچی گئی اجازتیں: email_marketing.view۔ AI اسسٹنٹ کی جانب سے: ہاں، MCP کے ذریعے۔

فہرستیں

GET /v1/email-marketing/lists — سبسکرائب کردہ / اَن سبسکرائب کردہ کی تعداد کے ساتھ تنظیم کی میلنگ لسٹس۔ آپریشن listEmailMarketingLists۔ چیک کردہ اجازتیں: email_marketing.view۔ AI اسسٹنٹ کی جانب سے: جی ہاں، MCP کے ذریعے۔
POST /v1/email-marketing/lists — ایک میلنگ لسٹ بنائیں (یا اس نام کی لسٹ واپس حاصل کریں)۔ آپریشن createEmailMarketingList۔ چیک کردہ اجازتیں: email_marketing.manage، email_marketing.view۔ AI اسسٹنٹ کی جانب سے: جی ہاں، MCP کے ذریعے۔
POST /v1/email-marketing/lists/{list_id}/members — ای میل ایڈریس کے ذریعے کسی لسٹ میں رابطے شامل کریں (فی درخواست زیادہ سے زیادہ 1,000)۔ آپریشن addEmailMarketingListMembers۔ چیک کردہ اجازتیں: email_marketing.manage، email_marketing.view۔ AI اسسٹنٹ کی جانب سے: جی ہاں، MCP کے ذریعے۔

امپورٹس

GET /v1/email-marketing/imports — سابقہ رابطہ امپورٹس، سب سے نئے پہلے، ایک وقت میں ایک keyset صفحہ۔ آپریشن listEmailMarketingImports۔ چیک کردہ اجازتیں: email_marketing.view۔ AI اسسٹنٹ کی جانب سے: جی ہاں، MCP کے ذریعے۔
POST /v1/email-marketing/imports — رضامندی کی تصدیق کے ساتھ رابطوں کا ایک حصہ امپورٹ کریں۔ آپریشن createEmailMarketingImport۔ چیک کردہ اجازتیں: email_marketing.manage، email_marketing.view۔ AI اسسٹنٹ کی جانب سے: جی ہاں، MCP کے ذریعے۔

سائن اپ فارمز

GET /v1/email-marketing/forms — سائن اپ فارمز (ڈبل آپٹ ان)، تازہ ترین پہلے، ایک کی سیٹ صفحہ۔ آپریشن listEmailMarketingForms۔ چیک کردہ اجازتیں: email_marketing.view۔ AI اسسٹنٹ کی طرف سے: جی ہاں، MCP کے ذریعے۔
POST /v1/email-marketing/forms — ایک سائن اپ فارم بنائیں جو تصدیق شدہ افراد کو ایک فہرست میں شامل کرے۔ آپریشن createEmailMarketingForm۔ چیک کردہ اجازتیں: email_marketing.manage، email_marketing.view۔ AI اسسٹنٹ کی طرف سے: جی ہاں، MCP کے ذریعے۔
DELETE /v1/email-marketing/forms/{form_id} — سائن اپ فارم حذف کریں (پہلے سے تصدیق شدہ افراد فہرست میں ہی رہتے ہیں)۔ آپریشن deleteEmailMarketingForm۔ چیک کردہ اجازتیں: email_marketing.manage، email_marketing.view۔ AI اسسٹنٹ کی طرف سے: جی ہاں، MCP کے ذریعے۔
PATCH /v1/email-marketing/forms/{form_id} — سائن اپ فارم تبدیل کریں (الفاظ، فہرست، ری ڈائریکٹ، آن یا آف)۔ آپریشن updateEmailMarketingForm۔ چیک کردہ اجازتیں: email_marketing.manage، email_marketing.view۔ AI اسسٹنٹ کی طرف سے: جی ہاں، MCP کے ذریعے۔

کنکشنز بھیجنا

GET /v1/email-marketing/senders — تنظیم کے ترسیلی رابطے۔ آپریشن listEmailMarketingSenders۔ چیک کی گئی اجازتیں: email_marketing.view۔ AI اسسٹنٹ کی جانب سے: جی ہاں، MCP کے ذریعے۔
POST /v1/email-marketing/senders — مہم کا بھیجنے والا مربوط کریں (Zinn® ترسیل، یا صارف کا اپنا SMTP سرور)۔ آپریشن createEmailMarketingSender۔ چیک کی گئی اجازتیں: email_marketing.manage، email_marketing.view۔ AI اسسٹنٹ کی جانب سے: صرف API اور ڈیش بورڈ: اس میں ایک ایسا راز ہوتا ہے جو کبھی بھی کسی AI ماڈل تک نہیں پہنچنا چاہیے (باڈی اصل میں SMTP پاس ورڈ ہے)۔
DELETE /v1/email-marketing/senders/{sender_id} — ترسیلی رابطہ اور اس کا محفوظ شدہ پاس ورڈ حذف کریں۔ آپریشن deleteEmailMarketingSender۔ چیک کی گئی اجازتیں: email_marketing.manage، email_marketing.view۔ AI اسسٹنٹ کی جانب سے: جی ہاں، MCP کے ذریعے۔
POST /v1/email-marketing/senders/{sender_id}/verify — کچھ بھی بھیجے بغیر ثابت کریں کہ ترسیلی رابطہ کام کر رہا ہے۔ آپریشن verifyEmailMarketingSender۔ چیک کی گئی اجازتیں: email_marketing.manage، email_marketing.view۔ AI اسسٹنٹ کی جانب سے: جی ہاں، MCP کے ذریعے۔
PUT /v1/email-marketing/senders/{sender_id}/webhook — اس رابطے کے لیے اپنے ای میل فراہم کنندہ کا ویب ہک سائننگ سیکرٹ محفوظ کریں۔ آپریشن setEmailMarketingSenderWebhook۔ چیک کی گئی اجازتیں: email_marketing.manage، email_marketing.view۔ AI اسسٹنٹ کی جانب سے: کسی دوسرے سسٹم (فراہم کنندہ یا وزیٹر) کی طرف سے کال کیا جاتا ہے، آپ کی طرف سے نہیں (فراہم کنندہ کا ویب ہک سیکرٹ محفوظ کرتا ہے)۔

SMS اور WhatsApp

GET /v1/email-marketing/sms — SMS اسکرین کی درکار معلومات — کھلا ہے؟، موقوف ہے؟، کریڈٹ بیلنس اور قیمتیں۔ آپریشن getEmailMarketingSms۔ جانچی گئی اجازتیں: email_marketing.view۔ AI اسسٹنٹ کی جانب سے: ہاں، MCP کے ذریعے۔
GET /v1/email-marketing/sms/campaigns — بلک SMS مہمات، جدید ترین پہلے، ایک keyset صفحہ۔ آپریشن listSmsMarketingCampaigns۔ جانچی گئی اجازتیں: email_marketing.view۔ AI اسسٹنٹ کی جانب سے: ہاں، MCP کے ذریعے۔
POST /v1/email-marketing/sms/campaigns — فہرست کے لیے ڈرافٹ SMS بنائیں۔ آپریشن createSmsMarketingCampaign۔ جانچی گئی اجازتیں: email_marketing.manage، email_marketing.view۔ AI اسسٹنٹ کی جانب سے: ہاں، MCP کے ذریعے۔
GET /v1/email-marketing/sms/campaigns/{campaign_id} — ایک بلک SMS مہم۔ آپریشن getSmsMarketingCampaign۔ جانچی گئی اجازتیں: email_marketing.view۔ AI اسسٹنٹ کی جانب سے: ہاں، MCP کے ذریعے۔
PATCH /v1/email-marketing/sms/campaigns/{campaign_id} — ڈرافٹ (یا مسترد شدہ مہم جو واپس ڈرافٹ میں چلی جاتی ہے) میں ترمیم کریں۔ آپریشن updateSmsMarketingCampaign۔ جانچی گئی اجازتیں: email_marketing.manage، email_marketing.view۔ AI اسسٹنٹ کی جانب سے: ہاں، MCP کے ذریعے۔
GET /v1/email-marketing/sms/campaigns/{campaign_id}/report — بلک SMS مہم کے اعداد و شمار۔ آپریشن getSmsMarketingCampaignReport۔ جانچی گئی اجازتیں: email_marketing.view۔ AI اسسٹنٹ کی جانب سے: ہاں، MCP کے ذریعے۔
POST /v1/email-marketing/sms/campaigns/{campaign_id}/send — اپنی فہرست میں موجود ہر اس شخص کو SMS بھیجنا شروع کریں جس نے SMS کی رضامندی دی ہو — یا کریڈٹ کی وجہ سے رکی ہوئی مہم کو دوبارہ شروع کریں۔ آپریشن sendSmsMarketingCampaign۔ چیک کی گئی اجازتیں: email_marketing.manage, email_marketing.view۔ AI اسسٹنٹ کی جانب سے: صرف API اور ڈیش بورڈ: اس پر رقم یا الاؤنس خرچ ہوتا ہے، اس لیے کوئی شخص خود اسے دبائے (یہ بامعاوضہ SMS/WhatsApp پیغامات بھیجتا ہے)۔
GET /v1/email-marketing/sms/registrations/us — اس تنظیم کی US 10DLC رجسٹریشن، اور اس کی قیمت۔ آپریشن getEmailMarketingUsRegistration۔ چیک کی گئی اجازتیں: email_marketing.view۔ AI اسسٹنٹ کی جانب سے: جی ہاں، MCP کے ذریعے۔
POST /v1/email-marketing/sms/registrations/us — اس تنظیم کا برانڈ اور مہم US 10DLC کے لیے جمع کرائیں (جمع کرانے پر فیس لاگو ہوگی)۔ آپریشن submitEmailMarketingUsRegistration۔ چیک کی گئی اجازتیں: email_marketing.manage, email_marketing.view۔ AI اسسٹنٹ کی جانب سے: صرف API اور ڈیش بورڈ: اس پر رقم یا الاؤنس خرچ ہوتا ہے، اس لیے کوئی شخص خود اسے دبائے (US 10DLC رجسٹریشن پر کیریئر فیس لاگو ہوتی ہے)۔

آپ کی اپنی ای میل سروس کے ذریعے مہمات (ٹیمپلیٹس، سیگمنٹس، اخراجات)

GET /v1/campaigns — تنظیم کی مہمات۔ آپریشن listCampaigns۔ AI اسسٹنٹ کی جانب سے: جی ہاں، MCP کے ذریعے۔
POST /v1/campaigns — کسی ٹیمپلیٹ اور سامعین سے مہم بنائیں۔ آپریشن createCampaign۔ AI اسسٹنٹ کی جانب سے: جی ہاں، MCP کے ذریعے۔
DELETE /v1/campaigns/esp — فراہم کنندہ کا اکاؤنٹ منقطع کریں اور اس کی محفوظ شدہ کلید کو ہٹا دیں۔ آپریشن disconnectEsp۔ AI معاون کی جانب سے: صرف API اور ڈیش بورڈ: اس میں ایک خفیہ راز ہوتا ہے جو کبھی بھی AI ماڈل تک نہیں پہنچنا چاہیے (محفوظ کردہ ESP کلید کو تباہ کرتا ہے)۔
GET /v1/campaigns/esp — تنظیم کا اپنا ای میل فراہم کنندہ کا اکاؤنٹ۔ آپریشن getEspConnection۔ AI معاون کی جانب سے: جی ہاں، MCP کے ذریعے۔
POST /v1/campaigns/esp — ای میل فراہم کنندہ کا اکاؤنٹ منسلک کریں۔ آپریشن connectEsp۔ AI معاون کی جانب سے: صرف API اور ڈیش بورڈ: اس میں ایک خفیہ راز ہوتا ہے جو کبھی بھی AI ماڈل تک نہیں پہنچنا چاہیے (باڈی اصل میں ESP API کی کلید ہے)۔
POST /v1/campaigns/esp/verify — تصدیق کریں کہ فراہم کنندہ کا اکاؤنٹ فعال ہے اور اس کے تصدیق شدہ ڈومینز پڑھیں۔ آپریشن verifyEspConnection۔ AI معاون کی جانب سے: صرف API اور ڈیش بورڈ: اس میں ایک خفیہ راز ہوتا ہے جو کبھی بھی AI ماڈل تک نہیں پہنچنا چاہیے (محفوظ کردہ ESP کلید کی دوبارہ جانچ کرتا ہے)۔
POST /v1/campaigns/preview — نمونہ اقدار کے ساتھ ٹیمپلیٹ کو Render کریں۔ آپریشن previewCampaignTemplate۔ AI معاون کی جانب سے: جی ہاں، MCP کے ذریعے۔
GET /v1/campaigns/segments — آپ کے محفوظ کردہ سامعین کے حصے۔ آپریشن listCampaignSegments۔ جانچے گئے اختیارات: campaigns.view۔ AI معاون کی جانب سے: جی ہاں، MCP کے ذریعے۔
POST /v1/campaigns/segments — سامعین کا ایک نیا حصہ محفوظ کریں۔ آپریشن createCampaignSegment۔ جانچے گئے اختیارات: campaigns.manage۔ AI معاون کی جانب سے: جی ہاں، MCP کے ذریعے۔
GET /v1/campaigns/segments/fields — فلٹر کی لغت، اس کی اقدار کی فہرستیں اور جادوئی ٹیگز۔ آپریشن getCampaignSegmentFields۔ جانچی گئی اجازتیں: campaigns.view۔ AI اسسٹنٹ کی جانب سے: جی ہاں، MCP کے ذریعے۔
POST /v1/campaigns/segments/preview — یہ کتنے لوگوں تک پہنچتا ہے، وہ کون ہیں، اور یہ کن لوگوں کو خارج کرتا ہے۔ آپریشن previewCampaignSegment۔ جانچی گئی اجازتیں: campaigns.view۔ AI اسسٹنٹ کی جانب سے: جی ہاں، MCP کے ذریعے۔
DELETE /v1/campaigns/segments/{segmentId} — کسی سیگمنٹ کو آرکائیو کریں۔ آپریشن archiveCampaignSegment۔ جانچی گئی اجازتیں: campaigns.manage۔ AI اسسٹنٹ کی جانب سے: جی ہاں، MCP کے ذریعے۔
GET /v1/campaigns/segments/{segmentId} — ایک محفوظ شدہ سیگمنٹ۔ آپریشن getCampaignSegment۔ جانچی گئی اجازتیں: campaigns.view۔ AI اسسٹنٹ کی جانب سے: جی ہاں، MCP کے ذریعے۔
PATCH /v1/campaigns/segments/{segmentId} — کسی سیگمنٹ کا نام تبدیل کریں یا اس کے فلٹرز بدلیں۔ آپریشن updateCampaignSegment۔ جانچی گئی اجازتیں: campaigns.manage۔ AI اسسٹنٹ کی جانب سے: جی ہاں، MCP کے ذریعے۔
GET /v1/campaigns/suppressions — وہ پتے جنہیں مارکیٹنگ موصول نہیں ہونی چاہیے۔ آپریشن listCampaignSuppressions۔ جانچی گئی اجازتیں: campaigns.view۔ AI اسسٹنٹ کی جانب سے: جی ہاں، MCP کے ذریعے۔
POST /v1/campaigns/suppressions — اخراج کی فہرست میں کوئی پتہ شامل کریں۔ آپریشن createCampaignSuppression۔ جانچی گئی اجازتیں: campaigns.manage۔ AI اسسٹنٹ کی جانب سے: جی ہاں، MCP کے ذریعے۔
GET /v1/campaigns/tags — مہم کا کمپوزر جو میجک ٹیگ پیلیٹ پیش کرتا ہے۔ آپریشن listCampaignTags۔ AI اسسٹنٹ سے: جی ہاں، MCP کے ذریعے۔
GET /v1/campaigns/templates — تنظیم کے مہم کے ٹیمپلیٹس۔ آپریشن listCampaignTemplates۔ AI اسسٹنٹ سے: جی ہاں، MCP کے ذریعے۔
POST /v1/campaigns/templates — مہم کا ٹیمپلیٹ تیار کریں۔ آپریشن createCampaignTemplate۔ AI اسسٹنٹ سے: جی ہاں، MCP کے ذریعے۔
DELETE /v1/campaigns/templates/{templateId} — ٹیمپلیٹ کو آرکائیو کریں اور اس کے ترجمے کے ذرائع کو ریٹائر کریں۔ آپریشن archiveCampaignTemplate۔ AI اسسٹنٹ سے: جی ہاں، MCP کے ذریعے۔
GET /v1/campaigns/templates/{templateId} — مہم کا ایک ٹیمپلیٹ۔ آپریشن getCampaignTemplate۔ AI اسسٹنٹ سے: جی ہاں، MCP کے ذریعے۔
PUT /v1/campaigns/templates/{templateId} — مہم کے ٹیمپلیٹ میں ترمیم کریں۔ آپریشن updateCampaignTemplate۔ AI اسسٹنٹ سے: جی ہاں، MCP کے ذریعے۔
POST /v1/campaigns/unsubscribe — مارکیٹنگ لسٹ چھوڑیں۔ اکاؤنٹ کی ضرورت نہیں۔ آپریشن unsubscribeFromCampaigns۔ AI اسسٹنٹ سے: صرف API اور ڈیش بورڈ: یہ ایک خفیہ معلومات رکھتا ہے جو کبھی بھی AI ماڈل تک نہیں پہنچنی چاہیے (وصول کنندہ کا دستخط شدہ ان سبسکرائب ٹوکن لیتا ہے)۔
DELETE /v1/campaigns/{campaignId} — مہم کو حذف کریں اور اس کی ڈیلیوری کی قطاروں کو ریٹائر کریں۔ آپریشن deleteCampaign۔ AI اسسٹنٹ سے: صرف API اور ڈیش بورڈ: اسے ایسی اجازت کی ضرورت ہے جو AI کنکشنز کو نہیں دی جاتی ہے (ESP مہم کو حذف کرنے کے لیے campaigns.send کی ضرورت ہوتی ہے)۔
GET /v1/campaigns/{campaignId} — ایک مہم اور اس کی ترسیل کی رپورٹ۔ آپریشن getCampaign۔ AI اسسٹنٹ کی جانب سے: ہاں، MCP کے ذریعے۔
POST /v1/campaigns/{campaignId}/control — جاری ترسیل کو روکیں، دوبارہ شروع کریں یا منسوخ کریں۔ آپریشن controlCampaign۔ AI اسسٹنٹ کی جانب سے: صرف API اور ڈیش بورڈ: اس سے رقم یا الاؤنس خرچ ہوتا ہے، اس لیے اسے کوئی فرد دباتا ہے (لائیو بھیجنے کے عمل کو روکتا/دوبارہ شروع کرتا ہے)۔
POST /v1/campaigns/{campaignId}/send — پائیدار ترسیل شروع کریں۔ آپریشن sendCampaign۔ AI اسسٹنٹ کی جانب سے: صرف API اور ڈیش بورڈ: اس سے رقم یا الاؤنس خرچ ہوتا ہے، اس لیے اسے کوئی فرد دباتا ہے (اصلی وصول کنندگان کو ایک ESP مہم بھیجتا ہے)۔
POST /v1/campaigns/{campaignId}/test — اس چینل پر ایک اصل پیغام بھیجیں جسے مہم حقیقت میں استعمال کرے گی۔ آپریشن testSendCampaign۔ AI اسسٹنٹ کی جانب سے: صرف API اور ڈیش بورڈ: اس کے لیے ایسی اجازت درکار ہوتی ہے جو AI کنکشنز کو فراہم نہیں کی جاتی ہے (ایک ESP ٹیسٹ بھیجنے کے لیے campaigns.send درکار ہے)۔

عوامی صفحات اور آنے والے ویب ہکس

GET /v1/public/email-marketing/c/{token} — کلک کاؤنٹر۔ فی وصول کنندہ ایک کلک ریکارڈ کرتا ہے اور اصل لنک پر ری ڈائریکٹ کرتا ہے۔ آپریشن emailMarketingClick۔ AI اسسٹنٹ کی جانب سے: ایک ایسا صفحہ جسے آپ کے وصول کنندگان ای میل سے کھولتے ہیں (کلک ٹریکنگ ری ڈائریکٹ)۔
GET /v1/public/email-marketing/f/{public_id} — سائن اپ فارم کا ہوسٹ کردہ صفحہ (بغیر لاگ ان)۔ آپریشن emailMarketingFormPage۔ AI اسسٹنٹ کی جانب سے: ایک ایسا صفحہ جسے آپ کے وصول کنندگان ای میل سے کھولتے ہیں (عوامی سائن اپ فارم کا صفحہ)۔
POST /v1/public/email-marketing/f/{public_id} — سائن اپ فارم جمع کروائیں (ہوسٹ شدہ صفحہ، ایمبیڈ یا JSON)۔ آپریشن emailMarketingFormSubmit۔ ایک AI معاون کی جانب سے: کسی دوسرے سسٹم (ایک فراہم کنندہ یا وزیٹر) کی طرف سے کال کیا گیا، آپ کی طرف سے نہیں (ایک وزیٹر سائن اپ فارم جمع کرواتا ہے)۔
GET /v1/public/email-marketing/fc — ڈبل آپٹ ان کی توثیق کا صفحہ (لاگ ان کی ضرورت نہیں)۔ آپریشن emailMarketingFormConfirmPage۔ ایک AI معاون کی جانب سے: ایک ایسا صفحہ جسے آپ کے وصول کنندگان ای میل سے کھولتے ہیں (ڈبل آپٹ ان کی توثیق کا صفحہ)۔
POST /v1/public/email-marketing/fc — سائن اپ کی توثیق کریں (رضامندی کے ریکارڈ کے ساتھ فرد کو فہرست میں شامل کرتا ہے)۔ آپریشن emailMarketingFormConfirm۔ ایک AI معاون کی جانب سے: کسی دوسرے سسٹم (ایک فراہم کنندہ یا وزیٹر) کی طرف سے کال کیا گیا، آپ کی طرف سے نہیں (ایک وزیٹر ڈبل آپٹ ان کی توثیق کرتا ہے)۔
GET /v1/public/email-marketing/o/{token} — اوپن ٹریکنگ امیج (ایک 1x1 GIF)۔ فی وصول کنندہ ایک اوپن شمار کرتا ہے۔ آپریشن emailMarketingOpenPixel۔ ایک AI معاون کی جانب سے: ایک ایسا صفحہ جسے آپ کے وصول کنندگان ای میل سے کھولتے ہیں (اوپن ٹریکنگ پکسل)۔
GET /v1/public/email-marketing/u/{token} — فوٹر ان سبسکرائب لنک (لاگ ان کی ضرورت نہیں)۔ آپریشن emailMarketingUnsubscribePage۔ ایک AI معاون کی جانب سے: ایک ایسا صفحہ جسے آپ کے وصول کنندگان ای میل سے کھولتے ہیں (ان سبسکرائب صفحہ)۔
POST /v1/public/email-marketing/u/{token} — RFC 8058 ون کلک ان سبسکرائب (اور صفحے کا "سب کچھ روک دیں" بٹن)۔ آپریشن emailMarketingUnsubscribeOneClick۔ ایک AI معاون کی طرف سے: کسی دوسرے سسٹم (ایک فراہم کنندہ یا ایک وزیٹر) کے ذریعے کال کیا گیا، آپ کے ذریعے نہیں (RFC 8058 ون کلک ان سبسکرائب)۔
GET /v1/public/email-marketing/warmup-u/{token} — مارکیٹنگ پول وارم اپ میل کا ان سبسکرائب لنک (بغیر لاگ ان)۔ آپریشن emailMarketingWarmupUnsubscribePage۔ ایک AI معاون کی طرف سے: ایک صفحہ جو آپ کے وصول کنندگان ای میل سے کھولتے ہیں (وارم اپ ان سبسکرائب کا صفحہ)۔
POST /v1/public/email-marketing/warmup-u/{token} — وارم اپ میل سے RFC 8058 ون کلک ان سبسکرائب۔ آپریشن emailMarketingWarmupUnsubscribeOneClick۔ ایک AI معاون کی طرف سے: کسی دوسرے سسٹم (ایک فراہم کنندہ یا ایک وزیٹر) کے ذریعے کال کیا گیا، آپ کے ذریعے نہیں (وارم اپ ون کلک ان سبسکرائب)۔
POST /v1/webhooks/campaign-events — ای میل فراہم کنندہ کی طرف سے دستخط شدہ ڈیلیوری ایونٹ وصول کریں۔ آپریشن receiveCampaignDeliveryWebhook۔ ایک AI معاون کی طرف سے: کسی دوسرے سسٹم (ایک فراہم کنندہ یا ایک وزیٹر) کے ذریعے کال کیا گیا، آپ کے ذریعے نہیں (دستخط شدہ ESP ڈیلیوری ویب ہک)۔
POST /v1/webhooks/campaigns/telnyx — ہمارے SMS وینڈر کی طرف سے آنے والے SMS جوابات (STOP / START)۔ آپریشن receiveCampaignsTelnyxInbound۔ ایک AI معاون کی طرف سے: کسی دوسرے سسٹم (ایک فراہم کنندہ یا ایک وزیٹر) کے ذریعے کال کیا گیا، آپ کے ذریعے نہیں (دستخط شدہ Telnyx ان باؤنڈ ویب ہک)۔
POST /v1/webhooks/email-marketing/{connection_id} — بھیجنے والے ایک کنکشن کے لیے صارف کے اپنے ای میل فراہم کنندہ کے ترسیلی واقعات۔ آپریشن receiveEmailMarketingProviderWebhook۔ AI معاون کی طرف سے: کسی دوسرے سسٹم (ایک فراہم کنندہ یا وزیٹر) کے ذریعے کال کیا گیا، آپ کی طرف سے نہیں (دستخط شدہ بھیجنے والا-فراہم کنندہ ویب ہُک)۔

بہاؤ

GET /v1/email-marketing/flows — ای میل کے بہاؤ (خوش آمدید، ڈرپ، ایک سالانہ تاریخ)، ایک keyset صفحہ۔ آپریشن listEmailMarketingFlows۔ چیک کردہ اجازتیں: email_marketing.view۔ AI معاون کی طرف سے: ہاں، MCP کے ذریعے۔
POST /v1/email-marketing/flows — ایک بہاؤ بنائیں (یہ ایک مسودے کے طور پر شروع ہوتا ہے)۔ آپریشن createEmailMarketingFlow۔ چیک کردہ اجازتیں: email_marketing.manage، email_marketing.view۔ AI معاون کی طرف سے: ہاں، MCP کے ذریعے۔
DELETE /v1/email-marketing/flows/{flow_id} — ایک بہاؤ اور اس کے اندراجات کو حذف کریں (اس کے بھیجے گئے رنز، مہمات کے طور پر باقی رہتے ہیں)۔ آپریشن deleteEmailMarketingFlow۔ چیک کردہ اجازتیں: email_marketing.manage، email_marketing.view۔ AI معاون کی طرف سے: ہاں، MCP کے ذریعے۔
GET /v1/email-marketing/flows/{flow_id} — ایک بہاؤ اپنے مراحل اور اپنی رپورٹ کے ساتھ (اندراج شدہ، زیرِ عمل، رنز اور فی مرحلہ وصول کنندگان)۔ آپریشن getEmailMarketingFlow۔ چیک کردہ اجازتیں: email_marketing.view۔ AI معاون کی طرف سے: ہاں، MCP کے ذریعے۔
PATCH /v1/email-marketing/flows/{flow_id} — فلو تبدیل کریں؛ steps، اگر فراہم کیا جائے، تو پوری ترتیب کی جگہ لے لیتا ہے۔ آپریشن updateEmailMarketingFlow۔ چیک کی گئی اجازتیں: email_marketing.manage، email_marketing.view۔ AI اسسٹنٹ کے ذریعے: جی ہاں، MCP کے ذریعے۔
POST /v1/email-marketing/flows/{flow_id}/activate — فلو کو چالو کریں؛ صرف وہی افراد شامل کیے جاتے ہیں جو اب سے فہرست میں شامل ہوتے ہیں۔ آپریشن activateEmailMarketingFlow۔ چیک کی گئی اجازتیں: email_marketing.manage، email_marketing.view۔ AI اسسٹنٹ کے ذریعے: جی ہاں، MCP کے ذریعے۔
POST /v1/email-marketing/flows/{flow_id}/pause — فلو کو موقوف کریں؛ مقررہ مراحل انتظار کرتے ہیں اور دوبارہ چالو ہونے تک کسی نئے فرد کو ای میل نہیں بھیجی جاتی۔ آپریشن pauseEmailMarketingFlow۔ چیک کی گئی اجازتیں: email_marketing.manage، email_marketing.view۔ AI اسسٹنٹ کے ذریعے: جی ہاں، MCP کے ذریعے۔

بلاگ کی تازہ ترین تحریریں

ہم ہوسٹنگ، SEO اور بڑے پیمانے پر سائٹس چلانے کے بارے میں کیا لکھتے رہے ہیں۔

ہوسٹنگ لیئر سے SEO اور لنک بلڈنگ: 2026 کے آپریٹر کا نقطہ نظر

2026 میں ہوسٹنگ کس طرح انڈیکسنگ اور لنک ایکویٹی کو تشکیل دیتی ہے: صفحات کو انڈیکس میں رکھنا، پرانے ڈومینز پر کام شروع کرنے سے پہلے ان کی جانچ پڑتال، بنا کسی فٹ پرنٹ کے لنک بلڈنگ، اور اس بارے میں ایک ایماندارانہ مؤقف کہ بنیادی ڈھانچہ SEO کے لیے کیا کر سکتا ہے اور کیا نہیں۔

21 جولائی، 2026

پوسٹ پڑھیں ←

WordPress کو تیز رفتار اور محفوظ بنانا: کارکردگی اور پلگ ان کی چیک لسٹ

تیز رفتار اور محفوظ WordPress کے لیے ایک عملی چیک لسٹ: سرور لیول کیشنگ، ہر سائٹ کے لیے آبجیکٹ کیش، چند مفید پلگ انز، اسٹیک کو اپ ٹو ڈیٹ رکھنا، اور WooCommerce کے وہ صفحات جنہیں آپ کو کبھی بھی کیش نہیں کرنا چاہیے۔

20 جولائی، 2026

پوسٹ پڑھیں ←

2026 میں مینیجڈ ویب ہوسٹنگ کا انتخاب کیسے کریں: خریدار کی رہنمائی

ایک اچھے مینیجڈ ہوسٹنگ اور کنٹرول پینل والے سستے سرور کے درمیان اصل فرق کیا ہے — منتقلی، بیک اپس، تنہائی، حقیقی کیشنگ اور دیانت دارانہ اسکیلنگ — اور اس کا انتخاب کرنے سے پہلے اس کا اندازہ کیسے لگائیں۔

19 جولائی، 2026

پوسٹ پڑھیں ←

بلاگ پڑھیں ←

کیا اب بھی دشواری پیش آ رہی ہے؟

ہر پلان میں سپورٹ شامل ہے، ہیلپ ڈیسک دن کے 24 گھنٹے کھلا رہتا ہے، اور آپ ہماری کسی بھی 58 زبانوں میں ہمیں لکھ سکتے ہیں—ہم آپ کی اپنی زبان میں جواب دیتے ہیں۔

سپورٹ سے رابطہ کریں تمام مضامین