إنتقل إلى المحتوى الرئيسي

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

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

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

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

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

messages.remaining هو ما تبقّى حتى period.end، حين يبدأ استهلاك الرسائل من الصفر من جديد. وتشمل الحدود إضافاتك؛ ولرفعها راجع الإضافات. وكل الحقول في مرجع جلب باقتك واستخدامك الحالي.

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

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

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

تأتي الفترات من الأحدث إلى الأقدم، كل منها بالرسائل المستخدمة مقابل حدود تلك الفترة، وcurrent: true تميّز الفترة التي تشمل الآن. راجع مرجع عرض الاستخدام حسب فترة الفوترة.

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

كل مرة يجيب فيها الذكاء الاصطناعي أو يتصرّف: كل رد، وكل دور يشغّل فيه أداة (حتى إن لم يرسل نصاً)، وكل تشغيل لأداة بحد ذاته، مثل حفظ عميل محتمل أو حجز موعد أو إضافة صف إلى جدول أو استدعاء Custom API أو Webhook. وتُحتسب أيضاً الملفات التي يرسلها الذكاء الاصطناعي والمتابعات والردود على التعليقات، وكذلك تشغيل أحد زملائك لأداة حفظ عميل من محادثة. وحين تكون لدى الوكيل معرفة كثيرة يُحتسب كل منها أكثر من رسالة؛ راجع كم معرفة يمكنني إضافتها؟. أما ردود فريقك ورسائل بث واتساب فلا تُحتسب، ولا تُحتسب اليوم أيضاً رسائل واتساب وقوالبه التي ترسلها عبر الواجهة البرمجية. راجع الخطط والأسعار.

أسئلة شائعة​

لماذا used أعلى من limit؟​

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

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

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

ماذا تعني status؟​

هي حالة اشتراكك. active وtrialing في وضع جيد؛ أما past_due وpaused وcanceled وpending_payment فتعني أن اشتراكك يحتاج إلى انتباه في صفحة اشتراكي. وقد تظهر قيم جديدة. راجع إدارة الاشتراك.

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

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

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

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

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

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

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

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

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

لا. افعل الاثنين من صفحة اشتراكي؛ راجع إدارة الاشتراك والإضافات.

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

usage:read، ويحمله كل مفتاح اليوم؛ راجع التوثيق.