الانتقال إلى المحتوى الرئيسي
تقرأ GOWA التكوين من ثلاثة أماكن:
  • خيارات سطر الأوامر للأمر whatsapp rest (شغّل ./whatsapp rest --help للاطلاع على القائمة الكاملة).
  • متغيرات البيئة.
  • ملف .env في مجلد العمل (src/.env عند التشغيل من المصدر؛ انسخ src/.env.example).
لا يملأ ملف .env إلا المتغيرات التي لم تُضبط بالفعل في البيئة.
في الشيفرة الحالية، تُطبَّق متغيرات البيئة (بما فيها .env) بعد تحليل خيارات سطر الأوامر، لذا تتجاوز قيمة المتغير المضبوط قيمة الخيار المقابل. وتُستثنى من ذلك إعدادات MCP OAuth والخيارات --allow-unauthenticated و--trusted-origins و--chatwoot-webhook-allow-unsigned و--webhook-all-device-receipts، إذ تكون الأولوية لخياراتها الصريحة. اضبط كل خيار في موضع واحد فقط. على سبيل المثال، تتجاوز WHATSAPP_WEBHOOK_INSECURE_SKIP_VERIFY=true القيمة --webhook-insecure-skip-verify=false.
يقبل Booleans true/false. تستخدم فترات بناء الجملة (30s, 5m , 3h). قيم القائمة مفصولة بفواصل.

الأوامر

خادم

لوحة التحكم

MCP

انظر MCP server.

التخزين

وحدة تخزين الدردشة (المحادثات، الرسائل، الجداول) تعيش دائما في storages/chatstorage.db وغير قابلة للتكوين. يتم إنشاء قواعد بيانات SQLite للجلسات، وتخزين الدردشة، و OAuth بأذونات 0600. تنشئ دلائل GOWA لهذه الملفات باستخدام 0700. الدلائل الموجودة تحتفظ بالأذونات الخاصة بها. يتم تسجيل تغييرات الأذونات التي لا يدعمها نظام الملفات كتحذيرات. بالنسبة إلى مخازن الجلسات والمفاتيح في PostgreSQL، تكون القيمة الافتراضية لـ sslmode عند إغفاله أو تركه فارغًا هي verify-full لوجهات الاتصال البعيدة. أما localhost وعناوين IP للاسترجاع المحلي ومقابس Unix، فقيمتها الافتراضية disable. تظل إعدادات URI الصريحة وPGSSLMODE وتهيئة الخدمة سارية. ويمكن لإدخال PGSERVICE تجاوز المضيف ووضع TLS المحددين في URI. عند استخدام PostgreSQL مُدار، حدّد sslmode=verify-full وتهيئة جهة إصدار الشهادات CA المطلوبة صراحةً.

سلوك WhatsApp

الوب

انظر Webhooks.

Chatwoot

خيار تصفية الحدث وإلغاء اتجاه واحد متاح على نظام GOWA main بعد v9.9.0. انظر Chatwoot Integration للاطلاع على السلوك والأمثلة.

حدود ثابتة

يتم تجميع هذه التجميع ولا يمكن تغييرها عن طريق التكوين:

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

إرسال الطلبات التي تجلب الوسائط أو المستندات أو معاينات الارتباط تقبل HTTP و HTTPS URLs. يرفض جلب عنوان URL العام حلقة الظهور، الخاص، وصلة - محلية، وبيانات تعريفية، ومتعدد البث، والوجهات المحجوزة. يتم تحديد إعادة توجيه وعنوان الاتصال الفعلي. هذه التنزيلات تتصل مباشرة ولا تستخدم HTTP_PROXY أو HTTPS_PROXY. تستطيع GOWA قراءة عناوين URL الخاصة بها /statics من القرص. يمكن لتنزيلات مرفقات الدردشة استخدام وجهة الدردشة المكونة أو المضيف المسموح به، بما في ذلك المضيف الداخلي عندما يكون موثوقا به من خلال هذا الدمج. لا ينطبق هذا الاستثناء على عناوين URL الاعتباطية المقدمة إلى واجهة برمجة التطبيقات المرسلة. استخدم تحميل الملفات عندما يكون المصدر خاصًا.

غير مستخدم

قائمتا src/.env.example WHATSAPP_WEBHOOK_INCLUDE_OUTGOING وWHATSAPP_CHAT_STORAGE، ولكن الرمز الحالي لا يقرأ أيضا.

مثال

.env
الأعلام المتساوية: