الانتقال إلى المحتوى الرئيسي
يوفر GOWA طريقتين لاستقبال الرسائل:

الوب

بدء تشغيل GOWA مع رابط ويب هوك وسرّ:
تصل رسالة نصية كما يلي:
في المجموعة، chat_id هي مجموعة JID (...@g.us) و from هو العضو الذي أرسلها.

مثال: بوت الرد التلقائي

التحقق من التوقيع، الاعتراف، ثم الرد من خلال API بنفس الجهاز:
ويعترف هذا المثال الأدنى قبل إرسال الرد. للإنتاج ، قم بإنتظار الحدث الذي تم التحقق منه بشكل دائم قبل الاعتراف به ، وإزالة التكرار بواسطة الجهاز والدردشة ومعرّف الرسالة ، وفشل إعادة المحاولة في إرسال العامل الخاص بك. تخطي الأحداث بدون session_id أو حل الجهاز الصحيح صراحة. لإرسال رد ثابت على كل رسالة، يتيح WHATSAPP_AUTO_REPLY="We'll get back to you soon" ذلك دون كتابة أي شيفرة. راجع خطافات الويب للاطلاع على جميع أنواع الأحداث وحقول الوسائط وإعادات المحاولة وعناوين URL الخاصة بكل جهاز.

التعامل مع أشكال الأحداث الجديدة

ترويسة الألبوم هي حدث message يتضمن payload.album دون متن نصي. تتبعها كل صورة أو مقطع فيديو في حدث وسائط منفصل يتضمن payload.album_id. اجمع الوسائط بحسب هذا المعرّف بدلًا من التعامل مع الترويسة بوصفها رسالة مفقودة. يتضمن newsletter.message تحديثات عدادات القناة ولا يضمن تضمين متن منشور جديد. تستخدم تحديثات اتصال جهات الاتصال وانقطاع اتصالها presence، وتتطلب POST /user/presence/subscribe، كما تتطلب بقاء عميلك متاحًا. تستخدم تغييرات اسم المجموعة group.info. اشترك في device.logged_out، و device.temporary_ban، و device.reachout_timelock لتمييز قيود الحساب من قطع الاتصال العادية. هذه الأحداث تحدد دائماً الخانة مع session_id. انظر Webhooks للحقول وتكوين الوجود.

وحدة تخزين الدردشة API

يسجل GOWA المحادثة والرسائل لكل فتحة في وحدة تخزين المحادثة المحلية. استفسر عنه لكل جهاز:
فقط الرسائل التي شاهدها GOWA (تم تلقيها أثناء الاتصال، أو تسليمها بواسطة مزامنة تاريخ WhatsApp) متوفرة. لسؤال الهاتف عن التاريخ القديم في محادثة، اتصل بـ POST /chat/{chat_jid}/history مع {"count": 50}؛ تصل الرسائل في وقت واحد. التصويت مناسب لمشاهدة اللحاق بركب البريد الوارد. للبوتات والأتمتة ، استخدم الويب.

تنزيل الوسائط

مع التحميل التلقائي على (الافتراضي)، يعطي ويبهوك مسارا تحت statics/media/، يخدم في http://localhost:3000/statics/media/<file>. وإلا أحضرت الوسائط بناء على الطلب:
انظر الوسائط الواردة للشروط التي يمكن في إطارها لGOWA استرداد ملف انتهت صلاحيته.

إيصالات القراءة

ضع علامة على رسالة مقروءة (الدقائق الزرقاء) مع POST /message/{message_id}/read و {"phone": "<chat_jid>"}، أو تعيين WHATSAPP_AUTO_MARK_READ=true لوضع علامة على كل رسالة واردة مقروءة تلقائياً.