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

هيكل المشروع

  • انظر هنا

whatsapp-api-nodejs

هذا الرمز هو تطبيق للويسكيوكيتس ، كخدمة API Restfull ، والتي تتحكم في وظائف WhatsApp.
باستخدام هذا النظام ، يمكنك إنشاء دردشات متعددة الخدمات أو روبوتات الخدمة أو أي نظام آخر يستخدم WhatsApp. باستخدام هذا الرمز ، لا تحتاج إلى معرفة JavaScript for NodeJS ، ما عليك سوى بدء تشغيل الخادم وقدم طلبات اللغة التي تشعر بها أكثر راحة.

بنية تحتية

1. التثبيت Docker

  • أولاً ، دعنا نثبت Docker. Docker هو منصة تتيح لنا إنشاء التطبيقات واختبارها ونشرها بسرعة في بيئات معزولة تسمى الحاويات. 
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker ${USER}

2. تثبيت قاعدة البيانات

postgreSQL [مطلوب]

  • الآن ، قمنا بتكوين قاعدة بيانات postgreSQL الخاصة بنا باستخدام Docker Compose.
  • الوصول إلى مدير postgre الخاص بك وإنشاء قاعدة بيانات.

يؤلف من Postgres

3. تثبيت NVM 

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# or
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

بعد الانتهاء ، أعد تشغيل المحطة لتحميل المعلومات الجديدة.

3.1 تثبيت NodeJS

  • تثبيت Node.js باستخدام NVM ، مدير إصدار يسمح لنا بالتبديل بين إصدارات مختلفة من Node.js بسهولة. 
nvm install 20

4. PM2 تثبيت 

npm i -g pm2

5. بدء تشغيل التطبيق

استنساخ المستودع 

 git clone https://github.com/code-chat-br/whatsapp-api.git

انتقل إلى دليل المشروع وتثبيت جميع التبعيات.

إعطاء الأفضلية إلى NPM لأنه لديه توافق أكبر. 

 cd whatsapp-api-v2

npm install
# or
npm install --force

6. متغيرات البيئة

راجع إعدادات إضافية يمكن تطبيقها من خلال ملف ENV بالنقر هنا .

️ انتباه ️ : انسخ ملف .env.dev إلى .env . 

cp .env.dev .env

7. المنشور orm

  • سنستخدم Prisma ORM لإدارة قاعدة البيانات الخاصة بنا. يقوم Prisma بتبسيط الوصول إلى قاعدة البيانات ويضمن أن العمليات آمنة وسهلة الصيانة.
  • الأوامر والتفسيرات:
    • في بيئة التنمية: NPX Prisma يهاجر
      • نستخدم migrate dev في التطوير لإنشاء وتطبيق الترحيل تلقائيًا ، مما يجعل العمل مع قاعدة البيانات أسهل.
    • في بيئة الإنتاج: ترحيل prisma npx الانتشار
      • في الإنتاج ، نستخدم migrate deploy لتطبيق الترحيل بطريقة خاضعة للرقابة وآمنة.
    • تصور البيانات: npx prisma studio
      • Prisma Studio هي أداة مرئية تساعدنا على إدارة وتصور البيانات المصرفية بطريقة بديهية.

حدد متغير بيئة Database_url لنشر قاعدة البيانات.

  • تنفيذ نشر قاعدة البيانات. 
bash deploy_db.sh

أخيرًا ، قم بتشغيل الأمر أدناه لبدء التطبيق: 

npm run start:dev

npm run start:prod

# pm2
pm2 start ' npm run start:prod ' --name CodeChat_API_v1.3.0

العامل

خيارات العمال لإدارة الجلسة

  • ماناجر الجلسة: ملفات-V0.0.1
  • ماناجر الجلسة: SQLITE-V0.0.1

لاستخدام العامل مع API ، من الضروري تحديد متغيرات البيئة التالية في API:

  • PROVIDER_ENABLED=true : يتيح هذا المتغير استخدام الموفر (العامل) في واجهة برمجة التطبيقات.
  • PROVIDER_HOST=127.0.0.1 : يحدد المضيف الذي يستمع إليه العامل للطلبات.
  • PROVIDER_PORT=5656 : يحدد المنفذ الذي يستمع إليه العامل للطلبات.
  • PROVIDER_PREFIX=codechat : تعيين بادئة على سبيل المثال التجميع على العامل

WebSocket

تمت إضافة توافق WebSocket. اقرأ هنا.

Swagger - Openapi 3.0.0

  • الطريق: http://localhost:8084/docs
  • ملف yaml: swagger.yaml

المصادقة

يمكنك تحديد نوعين مصادقة للطرق في ملف ENV . يجب إدراج المصادقة في رأس الطلب.

  1. JWT: A JWT هو معيار للمصادقة وتبادل المعلومات المحددة بتوقيع.

يتم إنشاء المصادقة في وقت إنشاء المثال.

ملاحظة: هناك أيضًا إمكانية لتحديد مفتاح API العالمي ، والذي يمكنه الوصول إلى جميع الحالات والتحكم فيها.

التطبيق في Docker

  • Docker-corm
  • Dockerhub-codechat/API: تطوير

بعد إنشاء التطبيق ، في نفس الدليل مثل الملفات أعلاه ، قم بتشغيل الأمر التالي: 

docker-compose up

إرسال الرسائل

إرسال النص ✔
إرسال الأزرار ✔ فقط [iOS ، Android]
إرسال الوسائط: الصوت - فيديو - صورة - مستند - GIF

BASE64: false		 ✔
إرسال ملف الوسائط ✔
إرسال نوع الصوت whatsapp ✔
إرسال نوع الصوت whatsapp - ملف ✔
إرسال الموقع ✔
إرسال القائمة ✔ فقط [iOS ، Android]
إرسال معاينة الارتباط
أرسل جهة الاتصال ✔
أرسل رد الفعل - الرموز التعبيرية ✔

مجموعات Postman

أحداث webhook

اسم حدث typedata وصف
qrcode_updated qrcode.updated جيسون يرسل Base64 من الرمز QRCODE للقراءة
Connection_update اتصال جيسون يبلغ حالة الاتصال مع WhatsApp
messages_set message.set جيسون يرسل قائمة بجميع رسائلك التي تم تحميلها على WhatsApp
يحدث هذا الحدث مرة واحدة فقط
messages_upsert message.upsert جيسون يعلمك عند استلام رسالة
messages_update message.update جيسون يخبرك عند تحديث رسالة
send_message send.message جيسون يتم إخطاره عند إرسال رسالة
contacts_set الاتصالات جيسون يؤدي التحميل الأولي لجميع جهات الاتصال
يحدث هذا الحدث مرة واحدة فقط
contacts_upsert contacts.upsert جيسون إعادة تحميل جميع جهات الاتصال بمعلومات إضافية
يحدث هذا الحدث مرة واحدة فقط
Contacts_update contacts.update جيسون يخبرك عند تحديث الدردشة
التواجد _update التواجد جيسون يُعلم ما إذا كان المستخدم متصلاً بالإنترنت ، وإذا كان يقوم ببعض الإجراءات مثل الكتابة أو التسجيل وآخره ينظر إليه
'غير متاح'
chats_set chats.set جيسون أرسل قائمة بجميع الدردشات المحملة
chats_update chats.update جيسون يخبرك عند تحديث الدردشة
chats_upsert chats.upsert جيسون يرسل أي معلومات دردشة جديدة
مجموعات _upsert Groups.upsert جيسون يخطر عند إنشاء مجموعة
مجموعات _update Groups.update جيسون يتم إخطارها عندما يتم تحديث مجموعة معلوماتها
group_partispants_update المشاركين في المجموعة جيسون يتم إخطاره عند حدوث أي إجراء ينطوي على مشارك
'يضيف'
new_token new.jwt جيسون يتم إخطاره عند تحديث الرمز المميز (JWT)

SSL

لتثبيت شهادة SSL ، اتبع الإرشادات أدناه.

ملحوظة

هذا الرمز لا يربط بأي حال من الأحوال WhatsApp. استخدم وفقًا لتقديرك. لا ترسل هذا.

تم إنتاج هذا الرمز بناءً على مكتبة Baileys ولا يزال قيد التطوير.

تبرع للمشروع.

PIX: 2B526ADA-4EF4-4DB4-BBEB-F60DA2421FCE

picpay


يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل