Chatgram
التطبيقات والإضافات

إعداد Chatgram على التطبيق الأصلي / الإضافة

ادمج Chatgram في تطبيقك للهواتف أو الكمبيوتر أو إضافة Chrome. تحقّق من نطاقك، واحصل على مفتاح API العام، وابدأ باستقبال رسائل الدعم عبر Telegram خلال دقائق.

حوالي 5 دقائق
مدة الإعداد
مجانًا
للبدء
مفتاح API
طريقة المصادقة
> ChatgramWidget.init({)
publicKey: 'pk_abc123...',
السمة: { primaryColor: '#EE6055' }
});
✓ تم تهيئة الأداة باستخدام مفتاح API
المصادقة باستخدام مفتاح عام
تحقّق ← احصل على مفتاح ← ادمج
الخطوة 1: أضف سجل DNS

أضف سجل TXT
إلى نطاقك

انتقل إلى إعدادات DNS لنطاقك وأضف السجل الموضّح هنا. يثبت سجل TXT هذا ملكيتك للنطاق من دون التأثير في موقعك الإلكتروني أو بريدك الإلكتروني أو أي إعدادات DNS موجودة.

🔒لا يؤثر في موقعك الإلكتروني أو تسليم رسائل البريد الإلكتروني
⚡يُفعَّل خلال 1–10 دقائق لدى معظم مزوّدي الخدمة
🌐يعمل مع أي مزوّد DNS حول العالم
سجل DNS مطلوب
سجل TXT
النوع
TXT
الاسم / المضيف
_chatgram-verify
القيمة / المحتوى
chatgram-site-verification=true
TTL
300 (أو تلقائي)
💡
مثال: إذا كان نطاقك هو mysite.com، فسيصبح اسم المضيف الكامل للسجل _chatgram-verify.mysite.com. تضيف بعض الخدمات النطاق تلقائيًا — وإذا كانت خدمتك تفعل ذلك، فأدخل _chatgram-verify فقط.
الخطوة 2: تحقّق من النطاق

تحقّق من سجل DNS
وطالِب بملكية موقعك

أدخل نطاقك وبريدك الإلكتروني. سنتحقق من سجل TXT من جانبنا، ثم نرسل إليك رابط تسجيل دخول لمرة واحدة إلى لوحة إدارة Chatgram. لا تحتاج إلى Telegram للبدء.

🔒تم التحقق من الخادم
✉️تسليم البريد الإلكتروني
⏱حوالي 60 ثانية
الخطوة 3: تحقّق من بريدك الإلكتروني

التالي: تحقق من بريدك الإلكتروني

بعد نجاح الخطوة 2، سنرسل إليك رابطًا لمرة واحدة لتسجيل الدخول إلى لوحة إدارة Chatgram بصفتك مالك موقعك.

بانتظار الخطوة 2
الخطوة 3

أكمل الخطوة 2 لتصلك رسالة البريد الإلكتروني لتسجيل الدخول

تحقّق من نطاقك أولًا، ثم سيُرسل رابط تسجيل الدخول إلى هذا البريد الإلكتروني.

الخطوة 4: للمطوّرين

التكامل باستخدام المفتاح العام

بالنسبة إلى التطبيقات الأصلية وإضافات 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.
الخطوة 5: أرسل الإضافة الجديدة

انشر إصدارك في متجر Chrome الإلكتروني

بعد ربط أداة Chatgram برمز publicKey واختبارها محليًا، أنشئ حزمة إنتاجية وقدّمها كـإضافة جديدة أو كتحديث لقائمة إضافة موجودة. تراجع المتجر ملف البيان والأذونات وإفصاحات الخصوصية، وتقارنها بما تفعله الإضافة فعليًا.

  • افتح لوحة مطوّري متجر Chrome الإلكتروني واختر عنصر جديد (للنشر لأول مرة)، أو حمّل حزمة جديدة لإضافة تديرها بالفعل.
  • اضبط أذونات ملف البيان بما يتوافق مع استخدام Chatgram (مثل أذونات المضيفين أو واجهات API التي تحتاج إليها فعلًا فقط)، واحرص على دقة رابط سياسة الخصوصية إذا كنت تجمع بيانات المستخدمين.
  • أكمل بيانات القائمة (الوصف ولقطات الشاشة والفئة)، ثم أرسلها للمراجعة. بعد الموافقة، سيتمكن المستخدمون من تثبيت إضافتك والتواصل معك عبر قناة Chatgram نفسها التي أعددتها سابقًا.

نصيحة: لإجراء تعديلات بعد الإطلاق، استخدم لوحة التحكم نفسها — حمّل ملف ZIP جديدًا، وزِد رقم الإصدار في manifest.json، ثم أرسله للمراجعة مجددًا عند الحاجة.

طريقة العمل

الإعداد خلال 4 خطوات بسيطة

يثبت التحقق من النطاق أنك تملكه وتريد ربطه بـ Chatgram. لا تستغرق العملية سوى بضع دقائق ولا تتطلب خبرة تقنية.

01
الخطوة 01

سجّل الدخول إلى مزوّد DNS

انتقل إلى مسجّل نطاقك أو مزوّد DNS حيث تدير سجلات نطاقك. قد يكون Cloudflare أو GoDaddy أو Namecheap أو أي مزوّد آخر.

02
الخطوة 02

انتقل إلى سجلات DNS

ابحث عن قسم إدارة DNS. تحقّق من وجود خيارات مثل «سجلات DNS» أو «إعدادات DNS» أو «محرر المنطقة» أو «إدارة DNS». تختلف التسميات قليلًا من مزوّد إلى آخر.

03
الخطوة 03

أضف سجل TXT جديدًا

أنشئ سجل DNS جديدًا بالإعدادات نفسها المعروضة في قسم سجل DNS في هذه الصفحة. تأكد من أن نوع السجل TXT وأن القيم مطابقة تمامًا.

04
الخطوة 04

تحقّق وفعّل

انتظر بضع دقائق حتى تنتشر تغييرات DNS، ثم أدخل نطاقك في قسم التحقق من النطاق وانقر على «تحقق الآن» للتحقق من Chatgram وتفعيله.

مزودو DNS

روابط سريعة إلى مزودي الخدمة الشائعين

انتقل مباشرةً إلى لوحة تحكم مزوّد DNS وأضف سجل التحقّق الخاص بـ Chatgram. ألا تجده هنا؟ الخطوات نفسها لدى أي مزوّد.

Cloudflare
DNS → اختر النطاق → أضف سجلًا
GoDaddy
منتجاتي → DNS → إضافة سجل
Namecheap
النطاق ← الإدارة ← DNS المتقدم
Google Domains
نطاقاتي → DNS → سجلات مخصصة
AWS Route 53
المناطق المستضافة ← اختر ← إنشاء سجل
DigitalOcean
الشبكات → النطاقات → إضافة سجل
الأسئلة الشائعة

الأسئلة الشائعة

كل ما تحتاج إلى معرفته عن التحقق من DNS وتسجيل النطاقات في Chatgram.

هل لديك أسئلة أخرى؟ تواصل معنا عبر الدردشة المباشرة من Chatgram أو راسلنا عبر البريد الإلكتروني على [email protected]

تنشر معظم مزوّدات DNS سجلات TXT خلال 1–10 دقائق. وفي حالات نادرة، قد يستغرق الأمر حتى 48 ساعة، بحسب مزوّد 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.

🔒تحقّق وفق المعايير المعتمدة في المجال
⚡إعداد في 5 دقائق
💬دعم مدعوم بـ Telegram