الصفحة الرئيسية>المتعلقة بالبرمجة>كود الذكاء الاصطناعي
تنزيل

البدء في Wechaty

حول ويتشاتي

Wechaty عبارة عن حزمة تطوير برامج (RPA) للمحادثة (أتمتة العمليات الروبوتية) لصانعي Chatbot. إنه مصمم بشكل جيد مع واجهة برمجة التطبيقات (API) سهلة الاستخدام. وهو يدعم جميع أنظمة التشغيل بما في ذلك Linux وOSX وWin32 وDocker والكثير من IMs (خدمات المراسلة الفورية) بما في ذلك WeChat وWeCom وWhatsApp وLark وGitter وما إلى ذلك.

كمطور، يمكنك استخدام Wechaty لبناء الروبوت الخاص بك بسهولة، وإدارة إرسال الرسائل واستلامها بشكل فعال، وإنشاء الغرفة وإرسال الدعوات، والاتصال بالأصدقاء، وإضافة الذكاء الاصطناعي بشكل مبهج بين المستخدمين والروبوت الخاص بك.

حول مشروع البدء في Wechaty

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

إذا واجهت صعوبات أو كانت لديك أي أسئلة، فنحن نرحب بك لطلب المساعدة في مجتمع Discord الخاص بنا على https://discord.gg/7q8NBZbQzt.

ملاحظة: الإصدار النشط الحالي من Wechaty هو v1.x وهو غير متوافق مع معظم وحدات v0.x.

  • [email protected] - لاستخدام Wechaty v0.x، يرجى زيارة فرع Wechaty Getting Started v0.x.

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

  1. إنه يعمل خارج الصندوق على Linux أو Mac أو Windows.
  2. يدعم جميع الدمى مثل الويب، والوسادة، وويندوز، وماك.
  3. يرد برسالة dong عندما يتلقى رسالة ding .

فيديو تعليمي للبدء باستخدام Wechaty

فيما يلي عرض قصير لنشر ding-dong-bot باستخدام WeChat وWhatsApp وWeCom.

تشغيل مشروع Wechaty Getting Started على بيئة تطوير متكاملة سحابية

أسرع طريقة لبدء استخدام Wechaty هي استخدام بيئة تطوير متكاملة (IDE) قائمة على السحابة لتشغيل مشروع Wechaty Getting Started Project. يمكنك إما استخدام Gitpod أو Google Cloud Shell.

إذا كنت مبتدئًا تمامًا، فنحن نوصيك بـ Gitpod.

باستخدام Gitpod ❤️ Wechaty

Gitpod عبارة عن منصة عبر الإنترنت ومفتوحة المصدر لبيئات التطوير الآلية والجاهزة للبرمجة. يمكنك النقر فوق الزر أدناه للوصول إلى الإعداد الكامل لمشروع Wechaty Getting Started ding-dong BOT على gitpod. إذا لم تستخدم gitpod من قبل، فستتم مطالبتك بتسجيل الدخول باستخدام حساب gitHub الخاص بك.

يمكنك معرفة المزيد عن Gitpod ❤️ Wechaty من مدونتنا: البدء دون مغادرة متصفحك: Wechaty ❤️ Gitpod، @huan، 06 فبراير 2021

باستخدام جوجل كلاود شل

Google Cloud Shell عبارة عن بيئة للتطوير والعمليات عبر الإنترنت يمكن الوصول إليها من أي مكان باستخدام متصفحك. يمكنك تشغيل هذا المشروع على Google Cloud Shell بالنقر فوق الزر أدناه.

تم إنشاؤها عبر Open-in-cloud-Shell

بعد فتح محرر Google Cloud Shell، يجب أن يكون هناك برنامج تعليمي مفتوح في اللوحة اليمنى يمكنك متابعته لمعرفة المزيد حول Wechaty.

تعرف على المزيد حول تشغيل هذا المشروع على Google Cloud Shell من مدونتنا: Google Cloud Shell Tutorials for Wechaty، @huan، 20 فبراير 2021

تشغيل مشروع Wechaty Getting Started على جهازك المحلي

المتطلبات الأساسية

لكي تتمكن من تشغيل هذا المشروع على جهازك المحلي، تحتاج إلى ما يلي:

  1. قم بتثبيت Node.js v16+ على جهازك. يمكنك تشغيل الأمر node -v على الجهاز للتحقق مما إذا كان Node.js مثبتًا لديك أم لا. إذا كان لديك، فيجب أن تكون قادرًا على رؤية الإصدار المطبوع على الجهاز مثل v16.13.0 . قد يكون الإصدار الخاص بك مختلفًا عن v16.13.0 . إذا لم يتم تثبيته أو كان الإصدار الخاص بك أقل من 16، فأنت بحاجة إلى تثبيت الإصدار الأحدث باتباع الروابط أدناه:

    • ويندوز
    • لينكس (ديبيان/أوبونتو)
    • ماك

    يمكن العثور على Node.js للأنظمة الأساسية الأخرى على https://nodejs.org/en/download/package-manager/

  2. احصل على Wechaty Puppet Service TOKEN إذا كنت تريد استخدام بروتوكولات RPA بخلاف الويب

الخطوة 1: استنساخ هذا المستودع

تحتاج إلى استنساخ هذا المستودع على جهازك المحلي ثم التبديل إلى دليل wechaty-getting-started عن طريق تشغيل الأوامر أدناه. 

git clone https://github.com/wechaty/getting-started.git
cd getting-started

الخطوة 2: تثبيت التبعيات

تحتاج إلى تثبيت التبعيات عن طريق تشغيل الأمر أدناه. 

npm install

الخطوة 3: تشغيل البوت

يمكنك استخدام export لتعيين متغيرات البيئة في Linux، واستخدام set في Windows. إذا واجهت أخطاء أثناء تشغيل هذا الأمر، فتحقق من تلميحات استكشاف الأخطاء وإصلاحها في الخطوة 4.

لينكس 
 export WECHATY_LOG=verbose
export WECHATY_PUPPET=wechaty-puppet-wechat
npm start
# the above is equals to the below command:
# npx ts-node examples/ding-dong-bot.ts
ويندوز 
 set WECHATY_LOG=verbose
set WECHATY_PUPPET=wechaty-puppet-wechat
npm start
# the above is equals to the below command:
# npx ts-node examples/ding-dong-bot.ts

أنت جاهز تمامًا!

الخطوة 4: استكشاف الأخطاء وإصلاحها

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

  1. قد تحتاج أيضًا إلى أداة windows-build-tool إذا كنت تستخدم windows: 

    npm install windows-build-tools

العمل مع الدمى المختلفة

في مثالنا للبدء، يستخدم ding-dong BOT wechaty-puppet-wechat4u عندما لا يتم تعيين WECHATY_PUPPET ، وذلك فقط لراحة الوافد الجديد.

افتراضيًا، سوف يستخدم Wechaty خدمة Puppet Service لتسجيل الدخول إلى الروبوت الخاص بك. يمكنك استخدام موفر Puppet آخر مثل بروتوكول Whatsapp Web (wechaty-puppet-whatsapp).

إذا كنت تريد استخدام Wechaty Puppet Provider لبروتوكول مختلف، فأنت بحاجة إلى تحديد اسم موفر خدمة الدمى (نفس اسم NPM الخاص به) عن طريق تعيين متغير البيئة WECHATY_PUPPET .

بفضل المساهمات الكبيرة من مجتمعنا، هناك العديد من Wechaty Puppets التي يمكن لـ Wechaty استخدامها. لقد ساعدونا في استخدام بروتوكولات مثل Web وPad وMac وWindows.

الدمى ويتشاتي

بروتوكول الآلية الوقائية الوطنية
خدمة الدمى wechaty-puppet-service
واتس اب ويب wechaty-puppet-whatsapp
ويب ويتشات wechaty-puppet-wechat
لوحة وي تشات wechaty-puppet-padlocal

قم بزيارة موقعنا على الإنترنت لمعرفة المزيد عن مقدمي خدمة Wechaty Puppet

على سبيل المثال، إذا كنت تريد استخدام دمية padlocal ، فيجب عليك تعيين WECHATY_PUPPET=wechaty-puppet-padlocal قبل تشغيل npm start . تحتاج أيضًا إلى رمز مميز لـ wechaty-puppet-padlocal والذي تحتاج إلى تعيينه على متغير البيئة WECHATY_PUPPET_PADLOCAL_TOKEN . يمكنك التقدم بطلب للحصول على PadLocal TOKEN من هنا. توضح مقتطفات التعليمات البرمجية أدناه ما تم وصفه أعلاه على Linux/MacOS وعلى Windows.

على لينكس / ماك 

 export WECHATY_PUPPET=wechaty-puppet-padlocal
export WECHATY_PUPPET_PADLOCAL_TOKEN= ' puppet_padlocal_your-token-here '
npm start

على ويندوز 

 set WECHATY_PUPPET=wechaty-puppet-padlocal
set WECHATY_PUPPET_PADLOCAL_TOKEN= ' puppet_padlocal_your-token-here '
npm start

تعرف على المزيد حول تثبيت Wechaty على النوافذ من منشور المدونة هذا.

دروس متقدمة

1. برنامج ويتشاتي التعليمي

أعلاه هو فيديو تعليمي مدته 10 دقائق. إنه يستخدم الإصدار 0.14 أو الإصدارات الأقدم من Wechaty وبالتالي فهو قديم أيضًا. إنها طريقة جيدة للبدء إذا كنت جديدًا في Wechaty.

2. المزيد من الأمثلة

ملاحظة: قبل تجربة المزيد من الأمثلة، تأكد من أنك قمت بتجربة مشروع البدء في wechaty في هذا المستودع.

  • دليل أمثلة Wechaty الرسمي

مرجع واجهة برمجة التطبيقات

  1. مستندات API الرسمية: https://wechaty.js.org/docs/api

المزيد من الموارد

1. البدء باستخدام Docker Wechaty

https://github.com/wechaty/docker-wechaty-getting-started

2. البدء باستخدام Heroku Wechaty

https://github.com/wechaty/heroku-wechaty-getting-started

3. ويتشاتي هوم

https://wechaty.github.io

التعليمات

1. لا أستطيع تسجيل الدخول باستخدام حساب Wechat الخاص بي

لن يتمكن حساب WeChat المسجل بعد عام 2017 من تسجيل الدخول عبر Web API. تعرف على المزيد حول هذا الموضوع على wechaty/wechaty#872

الحل: يمكنك استخدام بروتوكولات دعم Wechaty بخلاف Web API، مثل الوسادة. اعرف المزيد على wechaty/wechaty#1296

2. ما هي Puppet في Wechaty

مصطلح Puppet في Wechaty هو فئة مجردة لتنفيذ المكونات الإضافية للبروتوكول. المكونات الإضافية هي المكونات التي تساعد Wechaty في التحكم في Wechat وهذا هو سبب تسميتها بالدمية.

تمت تسمية المكونات الإضافية باسم PuppetXXX ، على سبيل المثال يستخدم PuppetWeChat محرك الدمى google للتحكم في WeChat Web API عبر متصفح Chrome، ويستخدم PuppetPadchat بروتوكول WebSocket للاتصال بخادم بروتوكول للتحكم في برنامج iPad Wechat. لمزيد من التفاصيل يمكنك الذهاب إلى Puppet في الويكي.

تعرف على المزيد حول Wechaty Puppet من وثائقنا في Wechaty Puppet

Wechaty البدء في لغات متعددة

  • البدء باستخدام TypeScript Wechaty
  • البدء ببايثون ويتشاتي
  • اذهب إلى Wechaty للبدء
  • البدء باستخدام Java Wechaty
  • سكالا ويتشاتي الابتداء
  • البدء باستخدام PHP Wechaty
  • .NET(C#) Wechaty البدء

تاريخ

الإصدار 1.18 الرئيسي (14 مارس 2022)

أضف أمثلة CQRS Wechaty.

الإصدار 1.11 (30 أكتوبر 2021)

الفرع: v1.11: إصدار v1.11 من Wechaty.

  1. الإصدار 0.13: تمكين دعم ESM (وحدة ES) (chatie/tsconfig#16)

الإصدار 0.8 (20 فبراير 2021)

استخدام Google Cloud Shell لإعداد سريع!

الإصدار 0.6 (11 فبراير 2021)

استخدام Gitpod لإعداد سريع!

الإصدار 0.0.1 (12 يناير 2017)

النسخة الأولية

المساهمين

المشرفون

@wechaty/المساهمين

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

  • الكود والمستندات © 2018 - الآن Huan وWechaty Contributors
  • تم إصدار الكود بموجب ترخيص Apache-2.0
  • تم إصدار المستندات تحت المشاع الإبداعي
يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل