سایر

9 مقالات C توسط CloudSnap Agent

چطور استفاده از ربات CloudSnap را شروع کنم؟

ربات را در تلگرام باز کنید و /start را بفرستید. بار اول، ربات از شما می‌خواهد قوانین را بپذیرید و گاهی هم در یک کانال عضو شوید؛ بعد از آن منوی اصلی در پایین گفت‌وگو ظاهر می‌شود. قدم‌های بار اول 1. /start را بفرستید. حساب‌های جدید با زبان فارسی شروع می‌شوند. اگر زبان دیگری می‌خواهید، اول /lang را بفرستید؛ این دستور حتی پیش از پذیرفتن قوانین هم کار می‌کند. 2. قوانین را بخوانید و روی ✅ می‌پذیرم بزنید. ربات پاسخ می‌دهد ✅ قوانین پذیرفته شد. و منوی اصلی را نشان می‌دهد. هر زمان خواستید می‌توانید قوانین را دوباره با دکمهٔ قوانین ببینید. 3. اگر ربات نوشت ➕ برای استفاده از ربات، ابتدا در کانال زیر عضو شوید، روی عضویت در کانال بزنید، در تلگرام عضو شوید، سپس برگردید و روی ✅ عضو شدم بزنید. وقتی ربات نوشت ✅ عضویت شما تایید شد.، می‌توانید ادامه دهید. اگر بعداً از کانال خارج شوید، ممکن است ربات دوباره عضویت را بخواهد. 4. هر وقت خواستید پیام خوش‌آمد و منوی اصلی را ببینید، /start را بفرستید. دستورهای کاربردی - /start شما را از هر جایی به منوی اصلی برمی‌گرداند و هر چیزی را که ربات منتظرش بود لغو می‌کند. - /lang زبان ربات را تغییر می‌دهد. - /topup مستقیم به شارژ حساب می‌رود. - /buyservice مستقیم به خرید سرور می‌رود. پیام‌هایی که ممکن است ببینید - ⏳ نشست شما منقضی شده است. لطفاً دوباره شروع کنید. دکمه‌ای که زدید دیگر به جایی نمی‌رسد؛ معمولاً چون مربوط به یک پیام قدیمی است. /start را بفرستید و دوباره وارد همان بخش شوید. - لطفاً از دکمه‌های زیر استفاده کنید، یا برای بازگشت به منوی اصلی /start را بفرستید. ربات منتظر پاسخ مشخصی بود، مثل یک کد یا یک مبلغ. از دکمه‌ها استفاده کنید یا برای لغو، /start را بفرستید. - ⚠️ درخواست‌ها را خیلی سریع می‌فرستید. کمی صبر کنید و بعد دوباره بزنید. اگر ارسال پشت‌سرهم ادامه پیدا کند، ربات مدتی به شما پاسخ نمی‌دهد و می‌گوید چند دقیقه. اگر باز هم درست نشد اگر نمی‌توانید از مرحلهٔ قوانین یا عضویت در کانال عبور کنید، پشتیبانی کلوداسنپ را از ربات کلوداسنپ در تلگرام باز کنید و همان‌جا برای ما بنویسید. زمان و متن دقیق آخرین پیام ربات را هم بنویسید.

هر دکمهٔ منوی اصلی ربات چه کاری انجام می‌دهد؟

منوی اصلی همان صفحه‌کلیدی است که در پایین گفت‌وگوی شما با ربات قرار دارد. در ادامه می‌بینید هر دکمه چه چیزی را باز می‌کند. اگر صفحه‌کلید ناپدید شد، /start را بفرستید تا دوباره نمایش داده شود. خرید - سرور خارج: سفارش سرور در خارج از ایران. می‌توانید بر اساس ارائه‌دهنده یا 📍 بر اساس لوکیشن انتخاب کنید، یا با سرور خود را پیدا کنید پلن مناسب را جست‌وجو کنید. - سرور ایران: سفارش سروری که در ایران قرار دارد. طبق قانون، این سرورها فقط به کاربران احراز هویت‌شده فروخته می‌شوند؛ بنابراین اگر هنوز احراز هویت نکرده‌اید، ربات اول آن را از شما می‌خواهد. - سایر محصولات: هر چیزی غیر از سرور، مثل 🌐 دامنه‌ها، 🗄 فضای ذخیره‌سازی و پرمیوم و استارز تلگرام. فقط محصولاتی که در حال حاضر عرضه می‌شوند نمایش داده می‌شوند. - تعرفه‌ها: جدول قیمت‌ها به‌صورت ماهانه، از ارزان‌ترین لوکیشن هر ارائه‌دهنده. نشان ♾ یعنی ترافیک نامحدود. حساب و سرویس‌های شما - پروفایل: شناسه، موجودی، سرویس‌های فعال و وضعیت احراز هویت شما. شارژ حساب، کسب درآمد، 🆔 احراز هویت، کد هدیه، اعلان‌ها و امور مالی همه از همین‌جا باز می‌شوند. - سرویس‌های من: همهٔ سرورها و سرویس‌های شما، با امکان مدیریت هرکدام. اگر هنوز سرویسی ندارید، ربات شما را به سرور خارج راهنمایی می‌کند. - 🤝 نمایندگی: فقط برای حساب‌های نمایندگی نمایش داده می‌شود. راهنمایی - پشتیبانی: برای تیم ما پیام بنویسید. پاسخ‌ها همین‌جا در تلگرام به دست شما می‌رسد. - قوانین: قوانین و مقررات استفاده از سرویس. داخل هر بخش، دکمهٔ ↩️ بازگشت شما را به صفحهٔ قبل می‌برد. /topup و /buyservice هم میان‌بر شارژ حساب و خرید سرور هستند. اگر باز هم درست نشد اگر دکمه‌ای واکنش نشان نمی‌دهد، /start را بفرستید و دوباره امتحان کنید. اگر باز هم درست نشد، نام دکمه، زمان و هر پیامی که ربات نشان داد را برای پشتیبانی بنویسید.

چطور با پشتیبانی تماس بگیرم و تیکت‌ها چطور کار می‌کنند؟

در ربات روی پشتیبانی بزنید و پیامتان را بفرستید، یا در سایت پشتیبانی CloudSnap بنویسید. هر دو به گفت‌وگوی پشتیبانی شما می‌رسند. هر تیکت شمارهٔ جداگانه‌ای دارد. نوشتن از داخل ربات 1. در منوی اصلی روی پشتیبانی بزنید. 2. پیامتان را بنویسید و بفرستید. فقط متن پذیرفته می‌شود و عکس، فایل و پیام صوتی ارسال نمی‌شود. به‌جای آن، آنچه می‌بینید را شرح دهید و متن خطا را در پیام کپی کنید. 3. ربات با شمارهٔ تیکت تأیید می‌کند، مثلاً ✅ پیام شما با شمارهٔ تیکت #… در گفت‌وگوی پشتیبانی‌تان ثبت شد.، و دکمهٔ 💬 باز کردن پشتیبانی من را نشان می‌دهد که گفت‌وگوی شما را در سایت پشتیبانی باز می‌کند. گاهی هم ربات به‌جای آن با پیام ✅ پیام شما برای پشتیبانی ارسال شد. و بدون شمارهٔ تیکت تأیید می‌کند. برای نوشتن پیام بعدی، دوباره روی پشتیبانی بزنید. برای لغو پیش از ارسال، روی ↩️ بازگشت بزنید. نوشتن در سایت پشتیبانی 1. در ربات کلوداسنپ روی پشتیبانی بزنید، پیامتان را بفرستید و زیر پاسخ ربات روی 💬 باز کردن پشتیبانی من بزنید. سپس زبانهٔ گفت‌وگو را باز کنید. 2. در کادر بنویسید و روی ارسال بزنید. 3. اگر تیکتی دارید که باز، پاسخ داده شده یا حل شده است، پیامتان به همان تیکت اضافه می‌شود. اگر موضوع پیامتان به آن ربطی ندارد، پیش از ارسال گزینهٔ این یک مشکل جدید و جداست را تیک بزنید تا تیکت جداگانه‌ای بگیرد. پیش از باز شدن تیکت جدید وقتی پیام شما در سایت پشتیبانی قرار است تیکت جدیدی باز کند، ممکن است سایت اول مقاله‌های راهنما را برای پیدا کردن پاسخ بررسی کند. پیامی که به تیکت فعلی‌تان اضافه می‌شود هرگز بررسی نمی‌شود و پیامی هم که از ربات می‌فرستید بررسی نمی‌شود. - اگر بررسی چیزی برای پیشنهاد پیدا نکند، تیکت بلافاصله باز می‌شود. - در غیر این صورت صفحهٔ شاید پاسخ شما همین‌جا باشد را می‌بینید، با حداکثر سه مقاله و گاهی یک راه‌حل پیشنهادی. تا این لحظه چیزی برای تیم فرستاده نشده است. - اگر مشکلتان حل شد، روی پاسخم را پیدا کردم بزنید؛ چیزی برای تیم فرستاده نمی‌شود. اگر نه، روی باز هم تیکت می‌خواهم بزنید. - اگر بررسی نسخهٔ واضح‌تری از پیامتان هم نوشته باشد، باز هم تیکت می‌خواهم اول می‌پرسد کدام نسخه را بفرستیم؟: روی ارسال پیام خودم یا ارسال نسخهٔ واضح‌تر بزنید. در غیر این صورت پیام خودتان همان‌طور که نوشته‌اید فرستاده می‌شود. یک گفت‌وگو، چند تیکت - تیکت‌های شما در یک گفت‌وگو فهرست می‌شوند. سایت پیام‌های اخیر را نشان می‌دهد؛ بسته شدن تیکت، پیام‌های آن را حذف نمی‌کند. - پیام جدید به آخرین تیکت شما که هنوز باز، پاسخ داده شده یا حل شده است اضافه می‌شود. نوشتن روی تیکتی که حل شده، آن را دوباره باز می‌کند. - وقتی تیکتی بسته شد، پیام بعدی شما یک تیکت جدید با شمارهٔ جدید باز می‌کند. پاسخ‌ها پاسخ تیم در سایت پشتیبانی ثبت می‌شود و با عنوان 📩 پاسخ پشتیبانی از طریق ربات هم برایتان فرستاده می‌شود. بیشتر پاسخ‌ها شمارهٔ تیکت و دکمهٔ 💬 باز کردن پشتیبانی من را هم دارند. نکته‌هایی برای پاسخ سریع‌تر - وقتی دربارهٔ یک سرور تیکت جدیدی شروع می‌کنید، در همان پیام اول نام یا آدرس IP سرور را ذکر کنید. این اطلاعات به تیم پشتیبانی کمک می‌کند سرور درست را بررسی کند. - زمان بروز مشکل و متن دقیق خطا را بنویسید. - ربات را مسدود نکنید. در غیر این صورت پاسخ‌ها در تلگرام به شما نمی‌رسد، هرچند همچنان در سایت پشتیبانی ذخیره می‌شوند.

چطور وارد سایت پشتیبانی شوم؟

سایت پشتیبانی رمز عبور جداگانه‌ای ندارد. آن را از داخل ربات کلوداسنپ در تلگرام باز می‌کنید و تلگرام شما را وارد می‌کند. ورود 1. در ربات کلوداسنپ روی پشتیبانی بزنید و پیامتان را برای ما بفرستید. 2. زیر پاسخ ربات (و زیر هر پاسخ تیم ما) روی دکمهٔ 💬 باز کردن پشتیبانی من بزنید. 3. سایت پشتیبانی داخل تلگرام و به‌صورت Mini App ربات ما باز می‌شود و شما را خودکار وارد می‌کند؛ لازم نیست چیزی تایپ کنید. 4. به صفحه‌ای که می‌خواستید باز کنید، یا به مرکز راهنما می‌روید. اگر سایت را مستقیم در مرورگر باز کنید، صفحهٔ ورود فقط از شما می‌خواهد پشتیبانی را از ربات کلوداسنپ در تلگرام باز کنید. هر وقت خواستید می‌توانید خارج شوید: دکمه‌ای را که حرف اول نامتان روی آن است در بالای صفحه بزنید، سپس خروج را بزنید. پس از ورود چه چیزهایی می‌بینید برای کل سایت، از جمله مرکز راهنما، همین ورود لازم است. سایت دو بخش دارد: مرکز راهنما، با مقاله‌های راهنما بر اساس موضوع، کادر جست‌وجو و فهرست کوتاهی از سرورهایتان با وضعیت آن‌ها، و گفت‌وگو، یعنی گفت‌وگوی پشتیبانی خودتان با همهٔ تیکت‌هایش. مدیریت سرورها، پرداخت‌ها و تنظیمات در ربات یا پنل وب انجام می‌شود، نه اینجا. ورود به سایت پشتیبانی فقط گفت‌وگوی پشتیبانی خود شما را باز می‌کند و به چت‌های تلگرام شما دسترسی نمی‌دهد. اگر حساب شما شناخته نشد اگر سایت می‌گوید حسابی برای شما پیدا نشد، روی باز کردن ربات بزنید، یک بار /start را بفرستید، سپس پشتیبانی را دوباره از ربات باز کنید. مطمئن شوید همان حساب تلگرامی را استفاده می‌کنید که با ربات کار می‌کند. اگر باز هم درست نشد - اگر ورود تأیید نشد، پشتیبانی را دوباره از ربات کلوداسنپ باز کنید و از اول شروع کنید. - اگر سایت را در مرورگر باز کرده‌اید و وارد نمی‌شوید، به ربات برگردید و روی دکمهٔ 💬 باز کردن پشتیبانی من زیر آخرین پاسخ ربات بزنید. اگر مشکل ادامه داشت، در ربات روی پشتیبانی بزنید و بنویسید چه پیامی دیدید و از چه دستگاه یا اپی استفاده کردید.

وضعیت‌های باز، پاسخ داده شده، حل شده و بسته یعنی چه و چطور به تیکت امتیاز بدهم؟

هر تیکت در گفت‌وگوی پشتیبانی شما یک وضعیت دارد که نشان می‌دهد کار آن به کجا رسیده است. بعد از اینکه تیم ما به تیکتی پاسخ داد، می‌توانید با یک تا پنج ستاره به آن امتیاز هم بدهید. وضعیت تیکت‌ها - باز: تیکت منتظر پاسخ تازهٔ تیم پشتیبانی است. هر پیام جدیدی که بفرستید، تیکت را دوباره به حالت باز برمی‌گرداند. - پاسخ داده شد: تیم ما پاسخ داده است. اگر هنوز کمک لازم دارید، کافی است در همان گفت‌وگو دوباره بنویسید. - حل‌شده: تیم ما مشکل را حل‌شده علامت زده و پیامی در تلگرام دریافت می‌کنید که تیکت حل‌شده علامت خورده است. اگر هنوز مشکلی هست، دوباره بنویسید تا همان تیکت دوباره باز شود. - بسته‌شده: این تیکت برای پیام تازه بسته شده است. پیام بعدی شما یک تیکت جدید با شمارهٔ جدید باز می‌کند که زیر تیکت‌های قبلی نمایش داده می‌شود. بسته شدن خودکار وقتی تیم ما پاسخ داده و شما مدتی دوباره ننوشته‌اید، تیکتی که پاسخ داده شده یا حل شده است به‌طور خودکار بسته می‌شود. در این حالت پیامی در تلگرام فرستاده نمی‌شود. بسته شدن، تیکت یا پیام‌های آن را حذف نمی‌کند. تیکت در فهرست می‌ماند و پیام‌های اخیرش را در سایت می‌بینید. هر وقت لازم بود دوباره بنویسید. امتیاز دادن به تیکت 1. در سایت پشتیبانی زبانهٔ گفت‌وگو را باز کنید. دکمهٔ 💬 باز کردن پشتیبانی من در ربات شما را به آنجا می‌برد. 2. زیر تیکتی که پاسخ داده شده، حل شده یا بسته است، عبارت از رسیدگی به تیکت شمارهٔ … چقدر رضایت داشتید؟ را با پنج ستاره پیدا کنید. 3. یک ستاره را بزنید: ستارهٔ اول کمترین امتیاز و ستارهٔ پنجم بهترین است. سایت پیام از امتیازتان ممنونیم. را نشان می‌دهد و پس از آن به‌جای ستاره‌ها امتیاز شما: … از ۵ کنار تیکت نمایش داده می‌شود. به هر تیکت یک بار امتیاز می‌دهید، و فقط وقتی پاسخ داده شده، حل شده یا بسته است. اگر پیش از امتیاز دادن دوباره روی آن بنویسید، به حالت باز برمی‌گردد و ستاره‌ها با پاسخ بعدی دوباره نمایش داده می‌شوند. اگر پیام هنوز نمی‌شود به این تیکت امتیاز داد را دیدید، اول منتظر پاسخ بمانید. تیکت‌های قدیمی‌تری که حل یا بسته شده‌اند در سابقهٔ شما جمع می‌شوند و ستاره‌ها را نشان نمی‌دهند. اگر باز هم درست نشد اگر تیکتی بسته شد ولی مشکل شما حل نشده، کافی است دوباره بنویسید تا تیکت جدیدی باز شود. شمارهٔ تیکت قبلی را هم ذکر کنید تا تیم بتواند این دو را به هم ربط دهد.

برنامهٔ نمایندگی چیست و چطور عضو آن شوم؟

برنامهٔ نمایندگی یک حساب دوم و جداگانه در کلوداسنپ به شما می‌دهد تا به مشتریان خودتان سرور بفروشید؛ با کیف پول دلاری مخصوص خودش، تخفیف حجمی، API برای نرم‌افزارتان و یک پنل وب. در ربات دکمه‌ای برای ثبت‌نام وجود ندارد؛ تیم کلوداسنپ این امکان را برای حساب تلگرام شما فعال می‌کند. چطور عضو شوم 1. در ربات روی پشتیبانی بزنید و دربارهٔ عضویت در برنامهٔ نمایندگی بپرسید. 2. پس از فعال شدن حساب، /start را بفرستید تا منو به‌روز شود. دکمهٔ 🤝 نمایندگی بین پروفایل و سرویس‌های من ظاهر می‌شود. چه چیزهایی دریافت می‌کنید - حساب نمایندگی جداگانه. کیف پول، سرورها، دامنه‌ها و فضاهای ذخیره‌سازی آن از حساب شخصی شما جداست. سرورهای نمایندگی در سرویس‌های من نمایش داده نمی‌شوند؛ سفارش و مدیریت آن‌ها از پنل نمایندگی یا از طریق API انجام می‌شود. - کیف پول دلاری. پول بین این کیف پول و کیف پول شخصی شما جابه‌جا نمی‌شود. - تخفیف حجمی که با تعداد سرورهای فعال حساب نمایندگی بیشتر می‌شود. - کلیدهای API که هرکدام به یک آدرس IP بسته می‌شوند، و آدرس کال‌بک برای دریافت رویدادها. - پنل نمایندگی و مستندات API. بخش 🤝 نمایندگی صفحهٔ اول موجودی کیف پول نمایندگی، تخفیف و سرویس‌های فعال شما را نشان می‌دهد، همراه با دکمه‌های 🔑 کلیدهای API، 🔔 آدرس کال‌بک، 💰 کیف پول و 📊 مالی، و در صورت در دسترس بودن، 🖥 ورود به پنل و 📚 مستندات API. پیام‌های مربوط به حساب نمایندگی در همین گفتگوی تلگرام می‌رسند و با 🤝 حساب نمایندگی شروع می‌شوند تا از پیام‌های حساب شخصی‌تان قابل تشخیص باشند. چه چیزهایی شامل نمی‌شود سرورهای داخل ایران جزو برنامهٔ نمایندگی نیستند. همچنان می‌توانید مثل هر مشتری دیگری آن‌ها را برای خودتان با دکمهٔ سرور ایران در منوی اصلی بخرید. اگر مشکل حل نشد اگر ربات پیام «حساب نمایندگی شما فعال نیست» را نشان داد، حساب نمایندگی در حال حاضر قابل استفاده نیست؛ مثلاً تعلیق یا بسته شده، یا برنامه فعلاً در دسترس نیست. سرورهایی که از قبل دارید روشن می‌مانند و هزینه‌شان همچنان از کیف پول نمایندگی کسر می‌شود. به پشتیبانی پیام دهید و شناسهٔ تلگرام خود (همان شناسه در صفحهٔ پروفایل) و متن پیامی که دیدید را بنویسید.

چرا API نمایندگی کلید من را رد می‌کند؟

هر پاسخ ردی یک کد خطا دارد. فیلد code در پاسخ را بخوانید: مشخص می‌کند با کدام‌یک از حالت‌های زیر روبه‌رو هستید. ip_not_allowed (403) کلید معتبر است، اما درخواست از آدرسی که کلید به آن بسته شده نیامده است. - IP کنار کلید را در 🤝 نمایندگی و سپس 🔑 کلیدهای API بررسی کنید. باید آدرس عمومی‌ای باشد که نرم‌افزار شما از آن به بیرون وصل می‌شود، نه آدرس خانه یا دفترتان. - اگر آدرس سرورتان تغییر کرده، روی همان کلید 📍 تغییر آی‌پی را بزنید. - اگر متن خطا می‌گوید درخواست از راه IPv6 رسیده، آدرسی که به کلوداسنپ رسیده آدرس واقعی شما نبوده و هیچ کلیدی با آن تطبیق پیدا نمی‌کند. کلاینت HTTP خود را روی IPv4 تنظیم کنید (مثلاً curl -4) و مطمئن شوید کلید به آدرس IPv4 شما بسته شده است. راهنمای Authentication در مستندات API این تنظیم را برای زبان‌های رایج نشان می‌دهد. key_expired یا key_revoked (401) مدت اعتبار کلید تمام شده یا کلید باطل شده است. کلید جدیدی بسازید و نرم‌افزارتان را روی آن ببرید. invalid_key یا unauthorized (401) کلید شناخته نشد یا اصلاً کلیدی ارسال نشده است. بررسی کنید که آن را کامل کپی کرده‌اید و به‌صورت Authorization: Bearer و سپس خود کلید ارسال می‌کنید. اگر کلید کامل را دیگر ندارید، آن را باطل کنید و کلید جدید بسازید؛ کلید دوباره نمایش داده نمی‌شود. suspended (403) حساب نمایندگی شما در حال حاضر فعال نیست و به همین دلیل همهٔ کلیدها رد می‌شوند. در ربات پیام «حساب نمایندگی شما فعال نیست» را می‌بینید. سرورهایی که از قبل دارید روشن می‌مانند. با پشتیبانی تماس بگیرید. throttled (429) نرم‌افزار شما سریع‌تر از سقف مجاز حسابتان درخواست می‌فرستد. پیش از تلاش دوباره، به اندازهٔ زمانی که در هدر Retry-After آمده صبر کنید. اگر مشکل حل نشد به پشتیبانی پیام دهید و شناسهٔ تلگرام، چند نویسهٔ اول کلید همان‌طور که در فهرست کلیدها نمایش داده می‌شود (هرگز کلید کامل را نفرستید)، آدرس IP‌ای که سرورتان از آن درخواست می‌فرستد، زمان درخواست و پاسخ کامل خطا را بنویسید.

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

در 🤝 نمایندگی و سپس 🔔 آدرس کال‌بک یک آدرس تنظیم کنید. پس از ثبت رویدادهای پشتیبانی‌شدهٔ حساب نمایندگی، ارسال آن‌ها به آدرس شما در صف قرار می‌گیرد. هر درخواست 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 پنل آمده) را بنویسید.

مستندات API نمایندگی کجاست؟

در بخش 🤝 نمایندگی روی 📚 مستندات API بزنید. مستندات روی سایت خود پنل نمایندگی، در مسیر /docs قرار دارد و عمومی است: برای خواندن آن لازم نیست وارد شوید. زبان مستندات انگلیسی است. راه‌های دیگر - در مرورگر، /docs را به انتهای نشانی پنل نمایندگی اضافه کنید. - روی صفحه‌نمایش بزرگ، مثل کامپیوتر، صفحهٔ ورود پنل هم پیوند Read the API reference → را به مستندات دارد. - اگر در ربات نه 📚 مستندات API را می‌بینید و نه 🖥 ورود به پنل را، نشانی را از پشتیبانی بپرسید. چه چیزهایی در آن هست - راهنماها: Authentication (کلیدها، بستن کلید به IP و اینکه چرا کلاینت شما باید از IPv4 استفاده کند، مدت اعتبار)، Idempotency، Pagination، Errors، Rate limits و Webhooks (بررسی امضا، تلاش‌های دوباره، فهرست رویدادها). - مرجع API: همهٔ مسیرها، فیلدهای درخواست و پاسخ و کدهای خطایی که هر مسیر ممکن است برگرداند. پیش از شروع بدانید - پنل و API روی یک حساب نمایندگی کار می‌کنند، با همان قیمت‌ها و همان سقف‌ها. سروری که از طریق API سفارش دهید در پنل هم دیده می‌شود. - سفارش به‌صورت ناهمگام انجام می‌شود: هزینه هنگام پذیرش سفارش از کیف پول کسر می‌شود و سرور کمی بعد آماده می‌شود. به‌جای پرس‌وجوی پشت‌سرهم، منتظر رویداد server.active بمانید. - مسیرهایی که سفارش، خرید، تغییر پلن، نصب مجدد یا حذف انجام می‌دهند به Idempotency-Key نیاز دارند. تلاش دوباره با همان کلید، پاسخ اول را برمی‌گرداند و سفارش دومی ثبت نمی‌شود. - تصمیم‌گیری را بر اساس code خطا انجام دهید، نه متن پیام: متن ممکن است تغییر کند، اما کد تغییر نمی‌کند. - به‌مرور فیلدها و رویدادهای جدید اضافه می‌شوند، پس نرم‌افزار شما باید هر چیزی را که نمی‌شناسد نادیده بگیرد. اگر مشکل حل نشد اگر مستندات باز نمی‌شود، به پشتیبانی پیام دهید و نشانی‌ای که باز کردید و آنچه دیدید را بنویسید.