البدء السريع مع ويتشات

تربط قناة ويتشات حساب WeChat الرسمي (Official Account) بـ Resool، فتصل الرسائل التي يرسلها العملاء إلى حسابك إلى صندوق الوارد المشترك مع واتساب ولاين والبريد. تربطها بالـ AppID والـ AppSecret للحساب، ثم تلصق الـ Server URL والـ Token اللذين يعطيك إياهما Resool في إعدادات الخادم في ويتشات. ويستطيع فريقك الرد خلال 48 ساعة من آخر رسالة للعميل، وهي القاعدة التي يفرضها ويتشات على الحسابات الرسمية.

#ما الذي يمكنك فعله مع ويتشات

في صندوق الوارد

• استقبل الرسائل المرسلة إلى حساب WeChat الرسمي كمحادثات.
• ردّ خلال 48 ساعة من آخر رسالة للعميل.

في القناة

• اطّلع في أي وقت على الـ Server URL والـ Token اللذين تلصقهما في ويتشات.

#قبل أن تبدأ

• حساب خدمة (Service Account) موثّق في ويتشات (服务号). لا تستطيع حسابات الاشتراك والحسابات غير الموثقة استخدام رسائل خدمة العملاء التي يرد بها Resool.
• صلاحية مسؤول على الحساب في منصة WeChat Official Accounts ‏(mp.weixin.qq.com)، لنسخ الـ AppID والـ AppSecret وتعديل إعدادات الخادم.
• عنوان IP لخادمنا لإضافته إلى قائمة IP المسموح بها في ويتشات. تواصل مع دعم Resool للحصول عليه.
• في Resool، يستطيع المالكون والمسؤولون فقط ربط القنوات. وتُحتسب ويتشات قناةً واحدة ضمن حد خطتك.

#كيفية الحصول على بيانات ويتشات

1. سجّل الدخول إلى منصة WeChat Official Accounts.
2. افتح Settings & Development › Basic configuration.
3. انسخ الـ AppID (يبدأ بـ wx).
4. انسخ الـ AppSecret. إن لم يكن معك، فأعد تعيينه من الصفحة نفسها. إعادة التعيين توقف أي أداة أخرى تستخدم الـ AppSecret القديم.
5. في الصفحة نفسها، أضف عنوان IP لخادم Resool إلى IP allowlist.

#كيفية ربط ويتشات بـ Resool

1. انتقل إلى الإعدادات › القنوات واضغط إضافة قناة.
2. في تبويب المراسلة التجارية، ابحث عن ويتشات واضغط ربط.
3. يعرض مربع ربط ويتشات ثلاث خطوات ورابط فتح WeChat Official Accounts. املأ:
   • اسم القناة: كيف تظهر القناة في Resool. القيمة الافتراضية «ويتشات».
   • AppID: مثل wx1234567890abcdef.
   • AppSecret: 32 حرفًا ورقمًا.

مكان لقطة الشاشة

الإعدادات › القنوات › إضافة قناة › ويتشات › ربط

مربع «ربط ويتشات» بشعار WeChat، والخطوات الثلاث المرقمة، ورابط «فتح WeChat Official Accounts»، وحقول اسم القناة وAppID وAppSecret، وملاحظة حد الرد خلال 48 ساعة، وزر «ربط».

الملف: screenshots/ar/wechat-quick-start-connect-dialog.png

1. اضغط ربط. يتحقق Resool من البيانات ويعرض الحساب اتربط. خطوة أخيرة في ويتشات: مع Server URL وToken.

مكان لقطة الشاشة

الإعدادات › القنوات › إضافة قناة › ويتشات، بعد الضغط على ربط

رسالة التأكيد «الحساب اتربط. خطوة أخيرة في ويتشات:»، وحقلا Server URL وToken مع زرّي النسخ، والنقطتان الخاصتان بوضع Plaintext / Compatible وقائمة IP المسموح بها، وزر «تم».

الملف: screenshots/ar/wechat-quick-start-server-config.png

1. اضغط تم لفتح صفحة القناة. ستجد القيم نفسها هناك لاحقًا.

#كيفية إكمال الإعداد في ويتشات

1. في mp.weixin.qq.com، انتقل إلى Settings & Development › Basic configuration › Server configuration واضغط لتعديلها.
2. الصق الـ Server URL في حقل URL، والـ Token في حقل Token.
3. في حقل EncodingAESKey، دع ويتشات ينشئ قيمة عشوائية.
4. في تشفير الرسائل، اختر Plaintext ‏(明文模式) أو Compatible mode.
5. احفظ، ثم فعّل إعدادات الخادم.

أرسل رسالة إلى حسابك الرسمي من ويتشات وتأكد من ظهورها في صندوق الوارد.

#كيفية إعداد ويتشات

افتح الإعدادات › القنوات واضغط إدارة على قناة ويتشات. يعرض تبويب الإعدادات:

• اسم القناة: غيّر اسم القناة واحفظ من شريط الحفظ.
• بطاقة الحساب: اسم الحساب وحالته (مربوط، أو محتاج مراجعة مع السبب).
• الـ Webhook: الـ Server URL والـ Token للصقهما في ويتشات، مع تذكير التشفير وقائمة IP المسموح بها.

مكان لقطة الشاشة

الإعدادات › القنوات › ويتشات › الإعدادات

تبويب الإعدادات وفيه حقل اسم القناة، وبطاقة الحساب بشارة «مربوط»، وبطاقة «الـ Webhook» بالـ Server URL والـ Token والتذكيرين وملاحظة الـ 48 ساعة.

الملف: screenshots/ar/wechat-quick-start-configuration.png

يُضبط التوجيه والإسناد التلقائي واستبيانات الرضا من إعدادات القناة. ولإزالة القناة، اضغط حذف القناة تحت منطقة الخطر وأكّد. تبقى المحادثات السابقة. ولا تنسَ إيقاف إعدادات الخادم في ويتشات أيضًا.

#ملاحظات وقيود

• يسمح ويتشات بالرد فقط خلال 48 ساعة من آخر رسالة للعميل. بعد ذلك انتظر حتى يكتب العميل من جديد.
• يمكن ربط حسابات الخدمة الموثقة فقط.
• الوضع الآمن (التشفير الكامل للرسائل) غير مدعوم؛ استخدم Plaintext أو Compatible mode.
• يمكن ربط كل حساب رسمي بمساحة عمل واحدة في Resool.

#الأسئلة الشائعة وحل المشكلات

#تظهر رسالة «الـ AppID بيبدأ بـ wx وطوله 18 حرف.»

لصقت قيمة أخرى، مثل المعرّف الأصلي (gh_…). انسخ الـ AppID من Basic configuration.

#تظهر رسالة «المنصة رفضت البيانات دي. راجعها وجرب تاني.»

لم يقبل ويتشات الـ AppID والـ AppSecret.

ما يمكنك فعله:

• تأكد أن الـ AppSecret حالي، وإن أُعيد تعيينه فانسخ القيمة الجديدة.
• تأكد أن عنوان IP لخادم Resool موجود في IP allowlist، فويتشات يرفض الطلبات من العناوين الأخرى.

#يفشل حفظ إعدادات الخادم في ويتشات

ما يمكنك فعله:

• الصق الـ Server URL والـ Token كما يظهران في Resool تمامًا، دون مسافات.
• تأكد أنك أنشأت القناة في Resool أولًا، فالرابط لا يعمل قبل وجود القناة.
• اختر Plaintext أو Compatible mode، وليس الوضع الآمن.

#الرسائل تصل لكن ردودي تفشل

ما يمكنك فعله:

• تأكد أنه لم تمر أكثر من 48 ساعة على آخر رسالة للعميل.
• تأكد أن عنوان IP لخادم Resool موجود في قائمة IP المسموح بها.
• تأكد أن حسابك حساب خدمة موثّق.

#ما التالي؟

• إعدادات القناة: التوجيه والإسناد التلقائي واستبيانات الرضا
• نوافذ المراسلة والقوالب
• البدء السريع مع لاين
• الرد على المحادثات