matrix appservice

مصفوفة-appservice-wechaty

Wechat (微信) جسر خدمة تطبيقات Matrix

ما هو [المصفوفة]

Matrix عبارة عن شبكة مفتوحة للاتصالات الآمنة واللامركزية، والتي يمكن استخدامها بشكل مشابه لبرنامج Pidgin على هاتفك.

يحاول Pidgin جمع جميع أصدقائك في مكان واحد في Linux، بغض النظر عن نوع الرسائل الفورية التي يستخدمونها. باستخدام Matrix، يمكنك توصيل عميل هاتفك بخادمك الخاص والذي يمكن تخصيصه بالكامل. لا تستخدم Matrix بروتوكول XMPP، بل تستخدم REST API بحيث يكون من الأسهل توسيعها.

إن عميل [Matrix] هو تطبيق دردشة آمن عالمي تحت سيطرتك بالكامل. وهو يدعم أجهزة الكمبيوتر المكتبية (Windows وMac وLinux) والهواتف المحمولة (Android وiOS)

ما هو matrix-appservice-wechaty

matrix-appservice-wechaty عبارة عن خدمة Matrix AppService من WeChat (微信) لتوصيل مجموعات WeChat الخاصة بك إلى غرف Matrix.

لقد تم إدراجه رسميًا في صفحة [Matrix] Bridge لـ Wechaty.

وفقًا لأنواع التجسير، يقوم Matrix Wechaty Bot بتنفيذ جسر بسيط من الدمى مع غرف البوابة لأننا نريد جلب جميع المحادثات من WeChat إلى Matrix، والسماح لمستخدم Matrix بالتحكم في حسابه على Wechat.

سمات

1. يدعم الاتصال بـ Wechat عبر بروتوكولات Web/iPad/Hostie/Windows/Mac WeChat، بقوة Wechaty
2. يقوم بتعيين جميع مستخدمي/غرفة/حسابات Wechat الرسمية لمستخدمي Matrix الافتراضيين

متطلبات

1. خادم منزلي Matrix يدعم خدمات التطبيقات (مثل Synapse)
2. Node.js مع NPM أو Docker

تثبيت

sudo npm install -g matrix-appservice-wechaty

matrix-appservcie-wechaty هو كل ما تحتاجه.

1 قم بتكوين config.yaml

انسخ config/config.sample.yaml إلى config.yaml وقم بتحديثه ليتوافق مع الإعداد الخاص بك.

1. يحتاج domain إلى التغيير إلى اسم المجال الخاص بك، والذي يجب أن يشير إلى الخادم المنزلي الخاص بك.
2. يحتاج homeserverUrl إلى التغيير إلى عنوان url الخاص بالخادم المنزلي، مع تضمين رقم المنفذ.
3. يحتاج registration إلى التغيير إلى اسم ملف yaml الخاص بالتسجيل (راجع الجزء التالي لمعرفة كيفية إنشائه)

2 قم بإنشاء wechaty-registration.yaml

بعد أن نقوم بإعداد config.yaml ، يمكننا إنشاء ملف wechaty-registration.yaml لتسجيل خدمة التطبيق على الخادم المنزلي:

 export APP_SERVICE_ENDPOINT= ' http://localhost:8788 '

matrix-appservice-wechaty 
  --config  config.yaml 
  --url     " $APP_SERVICE_ENDPOINT " 
  --generate-registration

ملاحظة: يتم استخدام عنوان URL APP_SERVICE_ENDPIOINT بواسطة الخادم المنزلي للتواصل مع خدمة التطبيق، وفي هذا المثال هو: http://localhost:8788 . إذا كانت لديك خدمات تطبيقات أخرى، أو متطلبات أخرى، فاختر اسم المضيف والمنفذ المناسبين.

3 قم بتسجيل خدمة التطبيق

قم بتحرير ملف homeserver.yaml الخاص بك وقم بتحديث إدخال app_service_config_files بالمسار إلى ملف wechaty-registration.yaml .

 app_service_config_files: ["/data/wechaty-registration.yaml"]

4 إعادة تشغيل الخادم المنزلي (المشبك)

ستحتاج بعد ذلك إلى إعادة تشغيل خادم المشبك.

لمستخدمي عامل ميناء:

 export SYNAPSE_CONTAINER_ID= $( docker ps | grep synapse | awk ' {print $1} ' )
docker restart $SYNAPSE_CONTAINER_ID

أو إذا كنت لا تستخدم عامل الإرساء:

synctl restart

تذكر إعادة تشغيله في كل مرة يتم فيها تحديث ملف التسجيل.

قم بتشغيل Wechaty AppService Bridge

لنبدأ جسر matrix-appservice-wechaty ، بالمنفذ المحدد في wechaty-registration.yaml ( 8788 في المثال أعلاه)

 export WECHATY_PUPPET=wechaty-puppet-padplus
export WECHATY_PUPPET_PADPLUS_TOKEN=xxxxxxxxxxxxxxxxxxxxx

matrix-appservice-wechaty 
  --config  config.yaml 
  --file    wechaty-registration.yaml

ملاحظة: Wechaty هو إطار عمل قوي جدًا يدعم بروتوكولات WeChat على الويب، وiPad، وWin32، وMac، وiOS. تعرف على المزيد حول بروتوكولات WeChaty في دليل Wechaty Puppet، ويمكنك التقدم بطلب للحصول على رمز مميز لاستخدام wechaty-puppet-padplus في برنامج مطوري الدعم الخاص بنا.

ومن المفترض أن يبدأ الجسر العمل بعد ذلك بوقت قصير.

يجب أن يحتوي المسار الحالي ( $(pwd) ) على ملف wechaty-registration.yaml وملف config.yaml . سيتم تخزين البيانات الإضافية المتعلقة بالجسر هنا.

أمثلة

مثال wechaty-registration.yaml

 id : wechaty
hs_token : 4f2763d5cc6e931967ec89efdde1123772945184b4cbe99e8fa9538122015e92
as_token : c27815bdd699d2eaefb499c83f99ce1a7983a9688811269fbcc17b632b0b250e
namespaces :
  users :
    - exclusive : true
      regex : ' @wechaty_.* '
  aliases :
    - exclusive : true
      regex : ' #wechaty_.* '
  rooms : []
url : matrix.chatie.io:8788
sender_localpart : wechaty
rate_limited : false
protocols :
  - wechaty

مثال config.yaml

 domain : chatie.io
homeserverUrl : https://matrix.chatie.io
registration : wechaty-registration.yaml

مثال على ملف إنشاء Docker

لقد قمنا بنشر خدمة wechaty/matrix-appservice لصورة عامل الإرساء من أجل راحتك.

يمكنك استخدام عامل الإرساء لتشغيل جسر Matrix-appservice-wechaty عن طريق إضافة التكوينات التالية إلى docker-compose.yml الخاص بك

 matrix-appservice-wechaty :
  container_name : matrix-appservice-wechaty
  image : wechaty/matrix-appservice
  volumes :
  - ./bridges/matrix-appservice-wechaty:/data
  networks :
  - default
  environment :
  - WECHATY_PUPPET_PADPLUS_TOKEN=puppet_padplus_<token>
  - WECHATY_PUPPET=wechaty-puppet-padplus
  command : ["--config", "/data/config.yaml", "--file", "/data/wechaty-registration.yaml", "--port", "8788"] 

استخدام الجسر

1. بوت Wechaty للرسائل المباشرة ( @wechaty:your.domain.ltd )
2. أرسل الرسالة !login (ثلاث مرات...مسح...)
3. سيرسل لك روبوت خدمة تطبيق wechaty رمز QR لمسحه ضوئيًا على WeChat.

بعد قيامك بمسح رمز الاستجابة السريعة ضوئيًا وتأكيده على هاتفك، سيتم إعداد كل شيء تلقائيًا بواسطة روبوت wechaty.

المصادقة

تسجيل الدخول

1. ابدأ محادثة مع Bridge bot. يجب أن يقول الروبوت "تم تسجيل هذه الغرفة كغرفة إدارة/حالة الجسر الخاص بك." إذا بدأت الدردشة بشكل صحيح.
2. تشغيل !login
3. قم بتسجيل الدخول عن طريق مسح رمز الاستجابة السريعة. إذا انتهت صلاحية الرمز قبل مسحه ضوئيًا، فسيرسل الجسر رسالة خطأ لإعلامك.
   1. افتح Wechat على هاتفك.
   2. اضغط على القائمة أو الإعدادات وحدد المسح الضوئي.
   3. قم بتوجيه هاتفك نحو الصورة التي أرسلها الروبوت لالتقاط الرمز.
4. أخيرًا، يجب أن يعلمك الروبوت بنجاح تسجيل الدخول ويجب أن يبدأ الجسر في إنشاء غرف بوابة لجميع مجموعات Wechat والمحادثات الخاصة.

تسجيل الخروج

ما عليك سوى تشغيل أمر إدارة !logout .

قم بإعداد خادم المصفوفة الخاص بك

باتباع الدليل من @spantaleev، يمكنك إعداد خادم المصفوفة الخاص بك في عشرات الدقائق فقط.

• إعداد خادم Matrix (شبكة مفتوحة للاتصالات الآمنة واللامركزية) باستخدام Ansible وDocker

المهام

الخطوات التفصيلية لإعداد خادم Matrix من https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/master/docs/README.md

انظر أيضا

• خدمات تطبيق ماتريكس
• مصفوفة جافا سكريبت SDK v2.0
• البنية التحتية لجسر خدمات التطبيقات - HOWTO
• مصفوفة خدمة تطبيق جسر Node.js SDK
• واجهة برمجة تطبيقات خدمة تطبيقات ماتريكس
• واجهة برمجة تطبيقات خادم العميل ماتريكس
• مواصفات المصفوفة

مصفوفة AppService الجسور في TypeScript

• جسر بين ماتريكس وديسكورد

ماتريكس AppService الجسور في جافا سكريبت

• مصفوفة<->بوابة الدمى الخاصة بمستخدم Skype
• مصفوفة الاتصال مع سكايب عبر الدمية
• مصفوفة AppService جسر Gitter
• جسر Node.js Telegram للماتريكس
• خطافات الويب المتوافقة مع Slack للمصفوفة
• جسر مصفوفي للرسائل النصية القصيرة، مدعوم من Twilio
• Node.js جسر IRC للماتريكس

خلفية

• دمج Wechat مع Matrix بقوة Wechaty #1737

لقد أجريت هذا الأسبوع محادثة رائعة مع شريك YC، ​​إريك @ericmigi، وهو رجل أعمال متسلسل ومهووس بالتكنولوجيا أيضًا. إنه يستخدم Matrix كثيرًا ويكاد يدمج كل مثيلات المراسلة في Matrix الخاص به.

لكن المصفوفة لا تدعم Wechat حتى الآن. لذلك نود تقديم جسر مصفوفة-wechat لتنفيذ بروتوكول Wechat، وملء الفجوة بين Matrix وWechat.

يقدم @ericmigi بعض الروابط التي ستساعدنا في البدء، ونأمل أن نتمكن من إعداد إثبات مفهوم عملي قريبًا، وسنرحب بأي مساهمة.

1. تثبيت خادم المنزل في 1 ساعة
2. أمثلة على الجسور الدمية

– هوان، أبريل 2019

---

لدى @tulir تجارب غنية جدًا في بناء الجسور المصفوفية مثل:

1. جسر دمى/روبوت هجين من Matrix-Telegram
2. جسر الدمى ماتريكس-واتساب

– هوان، مايو 2019

قائمة المهام/الأسئلة

• كيفية الحصول على قائمة الغرف من خادم المصفوفة المنزلي من مصفوفة appservice-bridge؟
• كيفية الحصول على أعضاء من غرفة من هومسيرفر مصفوفة-تطبيق-خدمة-جسر؟
• استخدم Matrix Remote Room لربط WeChat Room مع Matrix Room.

تاريخ

يتقن

1. دعم وحدات ES

الإصدار 0.9، 1 أغسطس 2021

تم الانتهاء من عرض لقب المستخدم والصورة الرمزية في المجموعة رقم 66 ودعم رسائل الصور والملفات رقم 86.

1. دعم عرض اللقب واسم جهة الاتصال.
2. دعم الصور ورسائل الملف.
3. إصلاح تحذير وظيفة مهملة.
4. تجنب دعوة حساب wechaty الخاص بك إلى غرفة المصفوفة.

الإصدار 0.8 1 مارس 2020

انتهى رقم 13: [TypeScript] إضافة نظام الكتابة إلى matrix-js-sdk و matrix-appservice-bridge .

1. إعادة هيكلة الكود
2. قم بإضافة أمر !login و !logout مع رسالة المساعدة
3. تم اختباره باستخدام iPad API (wechaty-puppet-padplus)

الإصدار 0.6 (بيتا) 25 فبراير 2020

1. تمت إضافة مثال docker-compose.yaml. (شكرًا @ericmigi)
2. تمت إضافة وثائق التثبيت

الإصدار 0.4 (ألفا) 14 يوليو 2019

1. دعم تلقي/إرسال رسالة Wechat في Matrix. (أفراد وغرف)
2. تم اختباره باستخدام Web API (wechaty-puppet-puppeteer) وiPad API (wechaty-puppet-padpro)

القضايا المعروفة

1. لم يتم تعيين الأسماء/الصور الرمزية لمستخدمي/مجموعات Wechat بشكل صحيح على Matrix.
2. دعم الرسائل النصية فقط، ورسائل الصور/الصوت/الفيديو غير مدعومة حتى الآن. (سيتم دعمه في الإصدار المستقبلي)
3. ستقوم Appservice بإنشاء أكثر من غرفة مصفوفة لغرفة Wechat عند تلقي الرسائل منها لأول مرة. (سيتوقف عن إنشاء غرف جديدة بعد قبول الدعوة)
4. يجب ألا يستخدم رمز الاستجابة السريعة لتسجيل الدخول واجهة برمجة تطبيقات الطرف الثالث لاعتبارات أمنية. الطريقة الأفضل هي تحميل صورة رمز الاستجابة السريعة إلى خادم المصفوفة بدلاً من ذلك.

الإصدار 0.2 6 يوليو 2019

1. قم بتمكين حساب المصفوفة الخاص بك لبدء استخدام matrix-appservice-wechaty من خلال التحدث إلى الروبوت @wechaty:your.domain
2. بعد أن تتحدث إلى @wechaty ، سوف يرسل لك رمز الاستجابة السريعة لتسجيل الدخول إلى Wechat. قم بمسحه ضوئيًا لتسجيل الدخول إلى Wechat
3. سيتم نقل جميع رسائل Wechat إلى نظام Matrix، في الغرفة التي تتحدث فيها مع الروبوت في المرة الأولى.

الإصدار 0.0.1 مايو 2019

1. الرد التلقائي على الرسالة في غرفة المصفوفة.

تنصل

لا أتحمل أي مسؤولية إذا قامت Tencent بحظر عنوان IP الخاص بك أو حسابك أو حتى التفاصيل الخاصة بك على نظامها. لم يقدموا أبدًا دعمًا رسميًا للعملاء المخصصين.

- إخلاء المسؤولية المستند إلى: الخلاف في خدمة تطبيق المصفوفة

شكر خاص

قام مجتمع Wechaty بإعداد خدمة Matrix (#94) والتي يرعاها الخادم @ericmigi، وهو مؤسس Beeper، شريك Y Combinator. كما قام بتأسيس شركة Pebble Technology (YC W11)، والتي استحوذت عليها شركة Fitbit في عام 2016.

تعرف على المزيد حول Beeper من Beeper يجلب iMessage إلى Android - لا مزيد من الفقاعات الخضراء وخروج LG وAndroid 12 وOneplus وOppo

المشرفون

• @huan (李卓桓) Tencent TVP من Chatbot، [email protected]
• @ تشانغتشونشينغ بيتر زانغ
• @yswtrue روي
• @lprintf يوجينج لين (انظر: wechaty/summer#59)

[المصفوفة] مسؤول الخادم:

• @lprintf يوجينج لين

حقوق الطبع والنشر والترخيص

• الكود والمستندات © 2019 - الآن Huan وWechaty المساهمين https://wechaty.js.org
• تم إصدار الكود بموجب ترخيص Apache-2.0
• تم إصدار المستندات تحت المشاع الإبداعي