چطور رویدادهای حساب نمایندگی را روی آدرس کال‌بک دریافت کنم؟

C

CloudSnap Agent

آخرین به‌روزرسانی در تاریخ Nov 18, 2026

در 🤝 نمایندگی و سپس 🔔 آدرس کال‌بک یک آدرس تنظیم کنید. پس از ثبت رویدادهای پشتیبانی‌شدهٔ حساب نمایندگی، ارسال آن‌ها به آدرس شما در صف قرار می‌گیرد. هر درخواست POST امضا دارد تا بتوانید فرستنده را بررسی کنید؛ تحویل ممکن است کمی زمان ببرد.

تنظیم

  1. روی 🤝 نمایندگی و سپس 🔔 آدرس کال‌بک بزنید.
  2. روی ✏️ تنظیم آدرس بزنید و آدرس را بفرستید. باید با https:// شروع شود و به یک میزبان عمومی اشاره کند؛ در غیر این صورت هنگام ذخیره پذیرفته نمی‌شود.
  3. روی 📤 ارسال آزمایشی بزنید. یک رویداد آزمایشی ارسال می‌شود که هیچ چیزی را در حساب شما تغییر نمی‌دهد؛ وضعیت ارسال آن را در پنل ببینید.
  4. برای توقف ارسال‌ها روی 🚫 حذف بزنید.

این آدرس را از صفحهٔ API & webhooks در پنل هم می‌توانید تنظیم کنید.

بررسی امضای هر ارسال

هر ارسال با Signing secret شما امضا می‌شود که در صفحهٔ API & webhooks پنل نمایش داده می‌شود. پیش از اعتماد به محتوا، امضا را بررسی کنید؛ راهنمای Webhooks در مستندات API روش کار را با نمونه‌کد توضیح می‌دهد. اگر این کلید مخفی را عوض کنید (Rotate)، کلید قبلی فوراً از کار می‌افتد؛ پس کلید جدید را بی‌درنگ در گیرندهٔ خود قرار دهید.

چه رویدادهایی دریافت می‌کنید

رویدادها شامل سرورها (پذیرش سفارش، آماده شدن، ناموفق بودن ساخت و بازگشت وجه، هشدار ترافیک، خاموش شدن به‌خاطر ترافیک یا بدهی، برگشتن، روشن و خاموش شدن، حذف)، کیف پول (نشستن شارژ، کم شدن موجودی)، تغییر تخفیف حجمی، نزدیک شدن انقضای کلیدهای API و ارسال‌های آزمایشی است. رمز root هرگز در رویدادها ارسال نمی‌شود؛ آن را از طریق API بخوانید.

اگر ارسال‌ها ناموفق باشند

به‌محض ذخیرهٔ رویداد، با یک وضعیت 2xx پاسخ دهید. ارسال ناموفق در ساعت‌های بعد به‌طور خودکار دوباره انجام می‌شود. اگر ارسال‌ها پشت‌سرهم ناموفق باشند، متوقف می‌شوند و صفحهٔ 🔔 آدرس کال‌بک این را اعلام می‌کند؛ گیرندهٔ خود را درست کنید و سپس آدرس را دوباره ذخیره کنید تا ارسال‌ها دوباره فعال شوند. بخش Event log در پنل همهٔ رویدادها را همراه با پاسخ گیرندهٔ شما نشان می‌دهد و با Redeliver می‌توانید یکی را دوباره بفرستید.

اینکه ربات هنگام تحویل سرورهایی که سفارش می‌دهید به شما هم پیام بدهد یا نه، برای حساب شما توسط تیم کلوداسنپ تنظیم می‌شود؛ پنل آن را در Settings و سپس Preferences نشان می‌دهد. اگر می‌خواهید تغییر کند، از پشتیبانی بخواهید.

اگر مشکل حل نشد

به پشتیبانی پیام دهید و شناسهٔ تلگرام، آدرس کال‌بک، نوع و زمان رویداد و پاسخی که گیرندهٔ شما داده (همان‌طور که در Event log پنل آمده) را بنویسید.