X-Device-Id. ينتهي معرف القناة في @newsletter؛ رقم الاتصال أو مجموعة JID ليس معرف القناة.
عيّن عنوان URL للسيرفر ووثائق الاعتماد قبل تشغيل أمثلة الستريل. استخدم عنوان HTTPS العام للخادم البعيد وشمل APP_BASE_PATH عند تكوينه.
البحث عن قناة
ابحث عن البيانات الوصفية للقناة إما عن طريقnewsletter_id أو invite. قم بالتوريد بالضبط. يمكن أن تكون الدعوة رابط https://whatsapp.com/channel/... أو تعليماتها.
results على البيانات الوصفية للقناة، بما فيها معرّفها والبيانات الوصفية لسلسلة المحادثة وللمشاهد. يتيح البحث عبر الدعوة الحصول على البيانات الوصفية العامة دون متابعة القناة. يعتمد البحث بمعرّف JID على صلاحية وصول الحساب المحدد إلى القناة. قد تكون قيمة viewer_metadata هي null عندما يوفّر WhatsApp البيانات الوصفية العامة فقط.
لتصفح الدليل، قم بتوفير رمز بلد واحد على الأقل. للبحث عن طريق الاسم، استخدم search_text.
الاستجابات الدليلية تضع القنوات في
results.data. يستخدم الدليل استفسارات WhatsApp غير موثقة ويمكن أن يتغير بشكل مستقل عن GOWA.
المتابعة أو إلغاء المتابعة
POST /newsletter/unfollow لإلغاء المتابعة. GET /user/my/newsletters تسرد الرسائل الإخبارية التي يتبعها الحساب المحدد.
تتبع قناة والاشتراك في تحديثات المشاركة المباشرة هي عمليات منفصلة. إدارة الاشتراكات الحية من خلال /newsletter/live-updates.
قراءة الرسائل والعدادات
GET /newsletter/messages المنشورات مباشرة من WhatsApp دون اشتراط متابعة القناة. يتحكم WhatsApp في السجل المتاح. لا يضمن GOWA مدة احتفاظ محددة أو أرشيفًا كاملًا. القيمة الافتراضية لـ count هي 50، ويقبل القيم من 1 إلى 100. لتحميل منشورات أقدم، مرّر قيمة server_id لأقدم منشور مُعاد في before.
يحتوي results.data على مشاركات مع server_id، message_id، type، timestamp، text، views_count، forwards_count، اختياري reaction_counts. يمكن أن تكون حقول المحتوى غائبة. تقارير WhatsApp المشاهدات لقناة المشرفين؛ حسابات أخرى يمكن أن ترى views_count: 0.
استخدم رقمي server_id، بدلا من message_id، لتنزيل الصفحات والوسائط.
GET /newsletter/message-updates العدّادات دون جلب محتوى الرسائل. الحقل after مطلوب ويجب أن يكون معرّف خادم موجبًا. القيمة الافتراضية لـ count هي 50، والحد الأقصى هو 100. الحقل الاختياري since هو طابع زمني بنظام Unix بالثواني، ويجب أن يكون غير سالب. تستخدم النتائج بنية القائمة نفسها في results.data، مع حذف حقول المحتوى عندما لا يعيدها WhatsApp.
تلقي تحديثات العداد المباشر
تكوين webhook، ثم قم باشتراك كل جهاز في القنوات التي يحتاجها.results newsletter_id، duration_seconds، expires_at، renewed_at، واختياري last_error. يمنح WhatsApp اشتراكاً قصيرًا، تم ملاحظته في حوالي 90 ثانية. تقوم GOWA بتجديده قبل انتهاء الصلاحية وبعد إعادة الاتصال. تصل أحداث العداد كـ newsletter.message webhooks.
قائمة اشتراكات مع GET /newsletter/live-updates. يتضمن results.data نفس الحقول في الحالة. افحص last_error عند فشل التجديد.
الإشتراكات موجودة في الذاكرة ولا تنجو من إعادة تشغيل الخادم. أعد إنشاءها بعد إعادة تشغيل GOWA. حالة الاشتراك تنتمي إلى الجهاز المحدد.
تحميل قناة الوسائط
results في استجابة JSON على server_id وmessage_id وstatus وmedia_type وmime_type وfilename وfile_path وfile_url وfile_size. يوفّر معالج REST قيمة file_url كعنوان URL عام وثابت للملف المحفوظ. لا تتضمن هذه الاستجابة ملفًا ثنائيًا. يُعاد خطأ إذا كان المنشور غير موجود أو لا يحتوي على وسائط قابلة للتنزيل.