> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# الجلسات و دورة حياة الاتصال

> كيف تقوم GOWA بتخزين جلسات WhatsApp، وإعادة الاتصال بعد إعادة التشغيل، وما الذي يفعله تسجيل الخروج والإزالة.

**الجلسة** هي مشكلة الهوية التشفيرية WhatsApp عندما تقوم باقران فتحة الجهاز. وتحافظ GOWA على قاعدة بياناتها، لذلك تبقى فتحة مرتبطة عبر إعادة التشغيل حتى يتم تسجيل خروجها من GOWA أو من الهاتف.

## دورة الحياة

```mermaid theme={null}
flowchart LR
  A[POST /devices] --> B[disconnected]
  B -->|login: QR / pairing code| C[connected]
  C -->|scan or code accepted| D[logged_in]
  D -->|network drop| E[connecting]
  E --> D
  D -->|logout from GOWA or phone| B
  B -->|DELETE /devices/id| F[removed]
```

| الحدث | ما يفعله GOWA |
| - | - |
| بداية الخادم | تحميل كل فتحة، وحوالي ثواني بعد بدء التشغيل، يعيد توصيل تلك بجلسة مخزنة. |
| تم فقدان الاتصال | ماتسميو إعادة الاتصال تلقائياً. التحقق من الخلفية أيضاً يعمل كل 5 دقائق ويعيد توصيل عميل مسقط. |
| إعادة الاتصال يدوياً | `POST /devices/{device_id}/reconnect` أو `GET /app/reconnect`. |
| تسجيل الخروج | `POST /devices/{device_id}/logout` أو `GET /app/logout`. إلغاء الروابط من WhatsApp، يحذف مفاتيح الجلسة، ويحتفظ بالفتحة. |
| غير متصل من الهاتف | نفس تسجيل الخروج: تبقى الخانة ويجب اقترانها مرة أخرى. |
| إزالة | `DELETE /devices/{device_id}`. قم بتسجيل الخروج، ثم قم بحذف الخانة وبيانات محادثاته. |

تحقق من فتحة في أي وقت:

```bash theme={null}
curl -u admin:changeme http://localhost:3000/devices/my-device/status
```

يعكس `is_connected` حالة اتصال المقبس؛ ويعكس `is_logged_in` ما إذا كانت الجلسة صالحة. يجب أن تكون قيمة كليهما `true` حتى تتمكن من الإرسال.

## حيث يتم تخزين الجلسات

| الإعدادات | الافتراضي | المحتويات |
| - | - | - |
| `DB_URI` | `file:storages/whatsapp.db` | أي مخزن أجهزة: مفاتيح الهوية والجلسات وجهات الاتصال. SQLite أو PostgreSQL (`postgres://...`). |
| `DB_KEYS_URI` | فارغ (يستخدم `DB_URI`) | إختيار قاعدة بيانات منفصلة للذاكرة المؤقتة لمفتاح التشفير. تجنب التخزين في الذاكرة في الإنتاج؛ إعادة التشغيل ستفقد حالة الجلسة. |
| (ثابت) | `file:storages/chatstorage.db` | تسجيل الجهاز، سجل المحادثة والرسائل، الإرسالات المجدولة، روابط Chatwoot. |

يمكن لأي شخص يمتلك هذه الملفات التصرف باسم الحسابات المرتبطة. ينشئ GOWA أدلة التخزين المحلية بصلاحيات `0700` ويحمي ملفات قاعدة بيانات الجلسات المحلية والملفات المصاحبة لـ SQLite بصلاحيات `0600`. احرص على تشفير النسخ الاحتياطية والحفاظ على هذه الصلاحيات عند الاستعادة. لا تضع ملفات تخزين الجلسات ضمن الدليل العام `statics/`.

### النسخ الاحتياطي والاستعادة

أوقف GOWA (أو أنشئ لقطة لوحدة التخزين)، ثم انسخ `storages/`. عند استخدام PostgreSQL في `DB_URI`، انسخ قاعدة البيانات هذه **و** `storages/chatstorage.db` احتياطيًا معًا. تؤدي استعادة كليهما إلى استعادة جميع خانات الأجهزة دون الحاجة إلى الاقتران مجددًا.

لا تشغّل نسختين من GOWA باستخدام بيانات الجلسة نفسها. يرى WhatsApp عميلين بهوية واحدة ويفصل أحدهما.

تبقي فتحة على عنوان ويب هوك لكل جهاز، ومفتاح التوقيع، وفلاتر الأحداث عند تسجيل الخروج والإقران مرة أخرى. حذف الخانة يزيل تكوينها. اشترك في `device.logged_out`، و `device.temporary_ban`، و `device.reachout_timelock` لتمييز قيود الحساب عن قطع الاتصال بالشبكة. انظر [Webhooks](https://gowa-docs.mintlify.site/ar/concepts/webhooks.md).

لجلسات PostgreSQL، انظر [دليل إعداد Neon](https://github.com/aldinokemal/go-whatsapp-web-multidevice/blob/main/docs/neon.md). تغيير `DB_URI` لا يرحل الجلسات الحالية. ولا يزال السجل وتاريخ الدردشة موجودين في SQLite، وبالتالي لا تزال هناك `storages/` أيضا.

## الحضور

| الإعدادات | الافتراضي | التأثيرات |
| - | - | - |
| `WHATSAPP_PRESENCE_ON_CONNECT` | `unavailable` | حالة التواجد المُرسلة بعد الاتصال: `available` أو `unavailable` أو `none`. |
| `WHATSAPP_PRESENCE_PULSE_ENABLED` | `true` | يضبط حالة الحساب دوريًا على `available` لفترة قصيرة، ثم يعيدها إلى `unavailable`. |
| `WHATSAPP_PRESENCE_PULSE_INTERVAL` | `24h` | الوقت بين النبضة. |
| `WHATSAPP_PRESENCE_PULSE_DURATION` | `5m` | المدة التي تظل فيها الحالة `available` خلال كل نبضة. |

اضبط حالة التواجد يدويًا باستخدام `POST /send/presence` (`{"type": "available"}` أو `"unavailable"`).

## استكشاف الأخطاء

| الأعراض | السبب المحتمل | إصلاح |
| - | - | - |
| `is_logged_in: false` بعد إعادة تشغيل | أُلغي ربط الجلسة بالهاتف، أو لم يُحفظ `storages/` في تخزين دائم. | قم بتحميل `/app/storages` كمجلد؛ وزوج مرة أخرى. |
| الخانة تواصل قطع الاتصال | عملية أخرى تستخدم نفس الجلسة، أو الهاتف غير متصل منذ حوالي 14 يوما. | تشغيل مثيل واحد؛ فتح WhatsApp على الهاتف. |
| QR ينتهي قبل المسح | انقضى `qr_duration`. | اتصل بنقطة نهاية تسجيل الدخول مرة أخرى، أو استخدم رمز الاقتران. |
| إرسال فشل مع "لم يتم تسجيل الدخول" | الخانة موجودة ولكنها غير مقترنة. | تحقق من `/devices/{device_id}/status`؛ ثم زوج مرة أخرى. |


## Related topics

- [إرسال جهة الاتصال](https://gowa-docs.mintlify.site/ar/api-reference/send/إرسال-جهة-الاتصال.md)
- [إعادة الاتصال بالجهاز](https://gowa-docs.mintlify.site/ar/api-reference/device/إعادة-الاتصال-بالجهاز.md)
- [إعادة الاتصال بخادم ماتسلاب](https://gowa-docs.mintlify.site/ar/api-reference/app/إعادة-الاتصال-بخادم-ماتسلاب.md)
- [الحصول على حالة الاتصال](https://gowa-docs.mintlify.site/ar/api-reference/app/الحصول-على-حالة-الاتصال.md)
- [الاشتراك في وجود جهة الاتصال](https://gowa-docs.mintlify.site/ar/api-reference/user/الاشتراك-في-وجود-جهة-الاتصال.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.