Chatgram
اپ‌ها و افزونه‌ها

راه‌اندازی Chatgram روی اپلیکیشن / افزونه بومی

Chatgram را در اپلیکیشن موبایل، اپلیکیشن دسکتاپ یا افزونه Chrome خود ادغام کنید. دامنه‌تان را تأیید کنید، Public API Key خود را بگیرید و ظرف چند دقیقه پیام‌های پشتیبانی را از طریق Telegram دریافت کنید.

حدود ۵ دقیقه
زمان راه‌اندازی
رایگان
برای شروع
کلید API
روش احراز هویت
> ChatgramWidget.init({)
publicKey: 'pk_abc123...',
پوسته: { primaryColor: '#EE6055' }
});
✓ ویجت با کلید API راه‌اندازی شد
احراز هویت با کلید عمومی
تأیید ← دریافت کلید ← یکپارچه‌سازی
مرحله ۱: افزودن رکورد DNS

این رکورد TXT را
به دامنه‌تان اضافه کنید

به تنظیمات DNS دامنه‌تان بروید و رکورد نمایش‌داده‌شده را اضافه کنید. این رکورد TXT مالکیت دامنه را تأیید می‌کند، بدون اینکه روی وب‌سایت، ایمیل یا تنظیمات DNS فعلی شما تأثیری بگذارد.

🔒بر وب‌سایت یا ارسال ایمیل شما تأثیری ندارد
⚡در بیشتر ارائه‌دهندگان، طی ۱ تا ۱۰ دقیقه منتشر می‌شود
🌐با هر ارائه‌دهنده DNS در سراسر جهان کار می‌کند
رکورد DNS الزامی
رکورد TXT
نوع
TXT
نام / میزبان
_chatgram-verify
مقدار / محتوا
chatgram-site-verification=true
TTL
۳۰۰ (یا خودکار)
💡
مثال: اگر دامنه شما mysite.com باشد، نام کامل میزبان رکورد _chatgram-verify.mysite.com می‌شود. بعضی ارائه‌دهندگان دامنه را خودکار اضافه می‌کنند؛ در این صورت، فقط _chatgram-verify را وارد کنید.
مرحله ۲: تأیید دامنه

رکورد DNS خود را بررسی کنید
و سایتتان را تأیید کنید

دامنه و ایمیل‌تان را وارد کنید. رکورد TXT را از طرف خودمان تأیید می‌کنیم و سپس یک پیوند ورود یک‌بارمصرف برای پنل مدیریت Chatgram برایتان ایمیل می‌کنیم. برای شروع به Telegram نیازی نیست.

🔒تأییدشده از سمت سرور
✉️تحویل ایمیل
⏱حدود ۶۰ ثانیه
مرحله ۳: بررسی ایمیل

بعدی: ایمیلتان را بررسی کنید

بعد از موفقیت مرحله ۲، پیوندی یک‌بارمصرف برایتان ایمیل می‌کنیم که با آن به‌عنوان مالک سایتتان وارد پنل مدیریت Chatgram می‌شوید.

در انتظار مرحلهٔ 2
مرحله ۳

برای دریافت ایمیل ورود، مرحله ۲ را کامل کنید

ابتدا دامنه‌تان را تأیید کنید؛ سپس پیوند ورود به این نشانی ایمیل می‌شود.

مرحله ۴: ویژه توسعه‌دهندگان

ادغام با کلید عمومی

برای اپلیکیشن‌های بومی و افزونه‌های Chrome، تشخیص خودکار دامنه کاربرد ندارد. در عوض، با استفاده از کلید عمومی API احراز هویت می‌کنید تا ویجت مستقیماً به حساب Chatgram شما متصل شود.

چطور کلید عمومی‌تان را دریافت کنید
  1. در ربات Chatgram، از پایین صفحه تنظیمات را باز کنید، سپس روی کلیدهای توسعه بزنید.
  2. دامنهتان را انتخاب کنید. Chatgram پیامی حاوی کلیدهایتان برایتان می‌فرستد؛ آن را به توسعه‌دهنده‌تان فوروارد کنید تا کلید عمومی را استخراج کند (معمولاً با pk_ شروع می‌شود) و آن را در کد زیر قرار دهد.
🔑publicKey جایگزین تشخیص خودکار دامنه می‌شود
📱برای اپلیکیشن‌ها و افزونه‌های بومی الزامی است
🔒افشای آن امن است — این یک کلید عمومی است، نه یک رمز محرمانه
⚡همان ویجت، همان قابلیت‌ها، همان API
جایگزین کنید pk_YOUR_PUBLIC_KEY با کلید موجود در داشبورد Telegram خود
افزودن از طریق CDN
<script src="https://cdn.jsdelivr.net/npm/chatgram-widget"></script>
یا
<script src="https://unpkg.com/chatgram-widget"></script>
Vanilla JS با کلید عمومی
<script src="https://cdn.jsdelivr.net/npm/chatgram-widget"></script>
<script>
  window.addEventListener('load', function () {
    ChatgramWidget.init({
      publicKey: 'pk_YOUR_PUBLIC_KEY',
      showTriggerButton: true,
      triggerPosition: 'bottom-right',
      theme: {
        primaryColor: '#EE6055',
        secondaryColor: '#D94F44',
      },
    });
  });
</script>
💡
وقتی publicKey ارائه شود، ویجت تشخیص خودکار دامنه را کاملاً نادیده می‌گیرد. این روش برای اپلیکیشن‌های بومی، افزونه‌های Chrome، اپلیکیشن‌های Electron و هر محیطی که دامنهٔ وب استاندارد ندارد، درست است. مستندات کامل در npm.
مرحله ۵: ارسال افزونهٔ جدید

انتشار نسخهٔ نهایی در فروشگاه وب Chrome

وقتی ویجت Chatgram را با publicKey راه‌اندازی کردید و محلی آزمایش کردید، یک نسخهٔ نهایی بسازید و آن را به‌عنوان افزونه‌ای جدید یا به‌روزرسانیِ یک فهرست موجود ارسال کنید. در فرایند بررسی فروشگاه، مانیفست، مجوزها و توضیحات حریم خصوصی شما با عملکرد واقعی افزونه مقایسه می‌شود.

  • داشبورد توسعه‌دهندگان فروشگاه وب Chrome را باز کنید و مورد جدید را انتخاب کنید (برای انتشار نخست) یا بستهٔ جدیدی برای افزونه‌ای که از قبل مدیریت می‌کنید بارگذاری کنید.
  • مجوزهای مانیفست را با کاربرد Chatgram هماهنگ کنید (برای مثال، فقط مجوزهای میزبان یا APIهایی را که واقعاً نیاز دارید نگه دارید) و اگر داده‌های کاربران را جمع‌آوری می‌کنید، از به‌روز بودن نشانی سیاست حریم خصوصی مطمئن شوید.
  • اطلاعات فهرست را تکمیل کنید (توضیحات، تصویرهای صفحه و دسته‌بندی)، سپس برای بررسی ارسال کنید. پس از تأیید، کاربران می‌توانند افزونه‌تان را نصب کنند و از همان کانال Chatgram که پیش‌تر پیکربندی کرده‌اید با شما گفتگو کنند.

نکته: برای رفع اشکال پس از انتشار، از همان داشبورد استفاده کنید—فایل ZIP جدیدی بارگذاری کنید، نسخه را در manifest.json افزایش دهید و در صورت نیاز دوباره برای بررسی ارسال کنید.

نحوه کار

راه‌اندازی در ۴ مرحله ساده

تأیید دامنه ثابت می‌کند مالک دامنه‌ای هستید که می‌خواهید به Chatgram وصل کنید. این کار فقط چند دقیقه طول می‌کشد و به هیچ دانش فنی نیاز ندارد.

01
مرحله 01

وارد حساب ارائه‌دهنده DNS خود شوید

به ثبت‌کنندهٔ دامنه یا ارائه‌دهندهٔ DNS خود بروید؛ جایی که رکوردهای دامنه‌تان را مدیریت می‌کنید. این سرویس ممکن است Cloudflare، GoDaddy، Namecheap یا هر ارائه‌دهندهٔ دیگری باشد.

02
مرحله 02

رفتن به رکوردهای DNS

بخش مدیریت DNS را پیدا کنید. گزینه‌هایی مانند «DNS Records»، «DNS Settings»، «Zone Editor» یا «Manage DNS» را ببینید. نام‌گذاری هر ارائه‌دهنده کمی متفاوت است.

03
مرحله 03

افزودن رکورد TXT جدید

یک رکورد DNS جدید با تنظیمات دقیق نمایش‌داده‌شده در بخش DNS Record این صفحه ایجاد کنید. نوع رکورد باید TXT باشد و مقادیر باید دقیقاً مطابقت داشته باشند.

04
مرحله 04

تأیید و فعال‌سازی

چند دقیقه صبر کنید تا DNS منتشر شود، سپس دامنه‌تان را در بخش «تأیید دامنه» وارد کنید و برای تأیید و فعال‌سازی Chatgram روی «بررسی اکنون» کلیک کنید.

ارائه‌دهندگان DNS

پیوندهای سریع به ارائه‌دهندگان محبوب

مستقیم به پیشخوان ارائه‌دهنده DNS خود بروید و رکورد تأیید Chatgram را اضافه کنید. ارائه‌دهنده‌تان در این فهرست نیست؟ فرایند در همه ارائه‌دهندگان یکسان است.

Cloudflare
DNS → انتخاب دامنه → افزودن رکورد
GoDaddy
محصولات من → DNS → افزودن رکورد
Namecheap
دامنه ← مدیریت ← DNS پیشرفته
Google Domains
دامنه‌های من → DNS → رکوردهای سفارشی
AWS Route 53
Hosted Zones → انتخاب → ایجاد رکورد
DigitalOcean
Networking → Domains → Add Record
سؤالات متداول

پرسش‌های متداول

هرآنچه باید دربارهٔ تأیید DNS و ثبت دامنه برای Chatgram بدانید.

هنوز سؤالی دارید؟ از طریق گفت‌وگوی زنده Chatgram یا ایمیل [email protected] با ما در ارتباط باشید.

بیشتر ارائه‌دهندگان DNS رکوردهای TXT را ظرف ۱ تا ۱۰ دقیقه منتشر می‌کنند. در موارد نادر، بسته به ارائه‌دهنده DNS و تنظیمات TTL ممکن است تا ۴۸ ساعت طول بکشد. انتشار رکوردها در Cloudflare معمولاً کمتر از ۲ دقیقه زمان می‌برد.

خیر. رکوردهای TXT فقط فراداده‌هایی در ناحیهٔ DNS شما هستند. افزودن رکورد تأیید Chatgram هیچ تأثیری بر وب‌سایت، تحویل ایمیل یا هیچ‌یک از رکوردهای DNS فعلی شما ندارد.

توصیه می‌کنیم رکورد TXT را نگه دارید. Chatgram برای اطمینان از امنیت، مالکیت دامنه را به‌طور دوره‌ای دوباره بررسی می‌کند. اگر این رکورد حذف شود، ممکن است دامنه‌تان پس از چرخه بررسی بعدی تأییدنشده شود.

Chatgram از زیردامنه‌ها پشتیبانی می‌کند. برای تأیید support.mysite.com، رکورد TXT را با نام _chatgram-verify.support.mysite.com اضافه کنید. در فیلد تأیید، «support.mysite.com» را وارد کنید.

ابتدا دوباره بررسی کنید که نام رکورد دقیقاً _chatgram-verify باشد (بعضی ارائه‌دهندگان دامنه‌تان را خودکار اضافه می‌کنند؛ بنابراین شاید کافی باشد فقط _chatgram-verify را وارد کنید). مطمئن شوید مقدار دقیقاً chatgram-site-verification=true است و فاصلهٔ اضافی ندارد. اگر همه‌چیز درست به نظر می‌رسد، چند دقیقهٔ دیگر برای انتشار تغییرات صبر کنید و دوباره امتحان کنید.

بله. تأیید از طریق رکورد DNS TXT روشی استاندارد در صنعت است که Google، Microsoft، Stripe و دیگر پلتفرم‌های بزرگ برای اثبات مالکیت دامنه به کار می‌برند. ما رکوردهای عمومی DNS را بررسی می‌کنیم و هیچ اطلاعات محرمانه‌ای درگیر نیست.

بله، حتماً. این فرایند را برای هر دامنه‌ای که می‌خواهید به Chatgram متصل کنید، تکرار کنید. هر دامنه به رکورد TXT جداگانه‌ای با نام _chatgram-verify نیاز دارد. داشبورد Chatgram همه دامنه‌های تأییدشده را در یک جا مدیریت می‌کند.

برای شروع آماده‌اید؟

رکورد را اضافه کنید.
تأیید کنید. فعال کنید.

مشتریانتان منتظرند. رکورد DNS را تنظیم کنید، دامنه‌تان را تأیید کنید و دریافت پیام‌های پشتیبانی را مستقیماً در Telegram شروع کنید.

🔒تأیید هویت مطابق با استانداردهای صنعت
⚡راه‌اندازی در ۵ دقیقه
💬پشتیبانی با قدرت Telegram