# الباقة والاستخدام

> اعرف باقتك في مجيب واستهلاك فترة الفوترة الحالية من الرسائل والوكلاء وفترات الفوترة السابقة عبر GET /v1/organization/usage وGET /v1/organization/usage/history. للقراءة فقط.

استدعاءان للقراءة فقط يُظهران وضع منظمتك. يُعيد `GET /v1/organization/usage` باقتك وحالة اشتراكك وفترة الفوترة التي تشمل الآن، مع الرسائل والوكلاء المستخدمين مقابل حدودك. ويعرض `GET /v1/organization/usage/history` فترات الفوترة في اشتراكك. يشمل كلاهما منظمتك كلها، ولا يُعيد أي منهما أسعاراً أو بيانات دفع.

## كيف أعرف كم رسالة تبقّت؟

استدعِ `GET /v1/organization/usage`.

```bash
curl https://api.mojeeb.app/v1/organization/usage \
  -H "Authorization: Bearer mk_live_YOUR_KEY_HERE"
```

`messages.remaining` هو ما تبقّى حتى `period.end`، حين يبدأ استهلاك الرسائل من الصفر من جديد. وتشمل الحدود إضافاتك؛ ولرفعها راجع [الإضافات](/docs/billing/add-ons). وكل الحقول في [مرجع جلب باقتك واستخدامك الحالي](../api-reference/get-usage).

## كيف أعرض فترات الفوترة السابقة؟

استدعِ `GET /v1/organization/usage/history`.

```bash
curl https://api.mojeeb.app/v1/organization/usage/history \
  -H "Authorization: Bearer mk_live_YOUR_KEY_HERE"
```

تأتي الفترات من الأحدث إلى الأقدم، كل منها بالرسائل المستخدمة مقابل حدود تلك الفترة، و`current: true` تميّز الفترة التي تشمل الآن. راجع [مرجع عرض الاستخدام حسب فترة الفوترة](../api-reference/list-usage-history).

## ما الذي يُحتسب رسالة؟

كل مرة يجيب فيها الذكاء الاصطناعي أو يتصرّف: كل رد، وكل دور يشغّل فيه أداة (حتى إن لم يرسل نصاً)، وكل تشغيل لأداة بحد ذاته، مثل حفظ عميل محتمل أو حجز موعد أو إضافة صف إلى جدول أو استدعاء Custom API أو Webhook. وتُحتسب أيضاً الملفات التي يرسلها الذكاء الاصطناعي والمتابعات والردود على التعليقات، وكذلك تشغيل أحد زملائك لأداة حفظ عميل من محادثة. وحين تكون لدى الوكيل معرفة كثيرة يُحتسب كل منها أكثر من رسالة؛ راجع [كم معرفة يمكنني إضافتها؟](/docs/features/knowledge-base#كم-معرفة-يمكنني-إضافتها). أما ردود فريقك و[رسائل بث واتساب](/docs/channels/whatsapp-broadcasts) فلا تُحتسب، ولا تُحتسب اليوم أيضاً رسائل واتساب وقوالبه التي ترسلها عبر الواجهة البرمجية. راجع [الخطط والأسعار](/docs/billing/plans-and-pricing).

## أسئلة شائعة

### لماذا `used` أعلى من `limit`؟

الرد من وكيل لديه معرفة كثيرة يُحتسب عدة رسائل، فقد يدفع آخر رد قبل بلوغ الحد قيمةَ `used` إلى ما بعد `limit`. وتبقى `remaining` عند الصفر، وقد تتجاوز `percent` قيمة 100.

### لماذا يرى مفتاح مقيّد ببعض الوكلاء استخدام المنظمة كلها؟

رصيد باقتك ملك للمنظمة، ويسحب منه كل وكيل. ولا تقسّمه الواجهة البرمجية حسب الوكيل.

### ماذا تعني `status`؟

هي حالة اشتراكك. `active` و`trialing` في وضع جيد؛ أما `past_due` و`paused` و`canceled` و`pending_payment` فتعني أن اشتراكك يحتاج إلى انتباه في صفحة **اشتراكي**. وقد تظهر قيم جديدة. راجع [إدارة الاشتراك](/docs/billing/manage-subscription).

### ماذا تعني `409 no_current_usage_period` و`409 usage_periods_overlap`؟

لا يستطيع مجيب تحديد فترة الفوترة الوحيدة التي تشمل الآن، فلا يعرف أي الحدود تنطبق. `no_current_usage_period` تعني أنه لا توجد فترة تشمل الآن: يعامل مجيب الاشتراك على أنه غير مُجدَّد، ولا يرد الذكاء الاصطناعي حتى تبدأ فترة. ويزول ذلك حين يصل التجديد. وهي أيضاً الرد حين لا يكون لمنظمتك اشتراك أصلاً. أما `usage_periods_overlap` فتعني أن أكثر من فترة تشمل الآن. وإن استمرت أيّ منهما، فتواصل مع الدعم مع `correlation_id` من الرد.

### لماذا لا يعود السجل إلى شهري الأول؟

يشمل السجل اشتراكك الحالي فقط. فالإلغاء يبدأ اشتراكاً جديداً على الباقة المجانية، ويبدأ السجل من جديد من هناك.

### لماذا لا يوجد عدد وكلاء للفترات السابقة؟

لا يُسجَّل استخدام الوكلاء لكل فترة. ويحتوي `GET /v1/organization/usage` على عدد اليوم.

### كم مرة يجب أن أستدعيه؟

يتغيّر الاستخدام مع كل رد من الذكاء الاصطناعي، فاستدعاؤه كل بضع دقائق يكفي للوحة متابعة أو تنبيه. وتشترك هذه الاستدعاءات في حد المعدّل الخاص بمفتاحك؛ راجع [حدود المعدّل](../rate-limits).

### هل أستطيع تغيير باقتي أو شراء إضافات عبر الواجهة البرمجية؟

لا. افعل الاثنين من صفحة **اشتراكي**؛ راجع [إدارة الاشتراك](/docs/billing/manage-subscription) و[الإضافات](/docs/billing/add-ons).

### ما النطاق الذي يحتاجه هذان الاستدعاءان؟

`usage:read`، ويحمله كل مفتاح اليوم؛ راجع [التوثيق](../authentication).