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

فريقك

استدعاءان للقراءة فقط يُظهران من في فريقك. يعرض GET /v1/agents/{agentId}/members الجميع ومن منهم يستطيع فتح الوكيل، ويعرض GET /v1/organization/members الجميع مع دور كل منهم والوكلاء الذين يستطيع فتحهم. استخدمهما لتوجيه العملاء المحتملين إلى الشخص المناسب، ولإظهار اسم بدل assigned_to في عميل محتمل أو كاتب ملاحظة، ولمطابقة زملائك مع المسؤولين في نظام CRM لديك عبر البريد الإلكتروني.

كيف أعرف من يمكن إسناد عملاء الوكيل المحتملين إليه؟​

استدعِ GET /v1/agents/{agentId}/members.

curl https://api.mojeeb.app/v1/agents/YOUR_AGENT_ID/members \
  -H "Authorization: Bearer mk_live_YOUR_KEY_HERE"

لا تُسند عميلاً محتملاً إلا إلى من لديه can_open_agent: true: فهؤلاء وحدهم يمكن إسناد عملاء الوكيل ومحادثاته إليهم، ويرفض مجيب أي شخص آخر بـ 422 assignee_not_allowed. راجع إسناد العملاء المحتملين وتصفيتهم وحقولهم للإسناد، ومرجع عرض أعضاء الفريق لوكيل لكل الحقول.

كيف أعرض كل من في منظمتي؟​

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

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

يأتي كل عضو بدوره وبريده الإلكتروني والوكلاء الذين يستطيع فتحهم: all_agents: true تعني كل الوكلاء، ومنهم من تضيفهم لاحقاً؛ وإلا فإن agent_ids تسرد الوكلاء الذين أُعطيهم. راجع مرجع عرض أعضاء منظمتك.

كيف أُظهر اسماً بدل assigned_to أو كاتب ملاحظة؟​

assigned_to في العميل المحتمل وauthor_id في الملاحظة هما user_id لأحد زملائك. اقرأ قائمة الأعضاء مرة واحدة واحتفظ بها، وابحث فيها عن الأسماء. وحين لا تجد معرّفاً في نسختك، اقرأ القائمة مجدداً: ربما انضم أحد منذ ذلك الحين. أما المعرّف الذي لا يظهر بعدها فيعود إلى شخص لم يعد في منظمتك.

أسئلة شائعة​

لماذا لا يظهر شخص ما في القائمة؟​

لا تعرض القائمة إلا الأعضاء: من دعوته يظهر حين يقبل الدعوة. وقد يبقى في عميل محتمل أو ملاحظة معرّف شخص غادر منظمتك؛ أسند عملاءه المحتملين إلى من لديه can_open_agent: true.

لماذا agent_ids فارغة؟​

إما أن قيمة all_agents هي true، وهي تشمل كل الوكلاء، وإما أن الزميل لم يُعطَ أي وكيل يستطيع هذا المفتاح العمل عليه. فالمفتاح المقيّد ببعض الوكلاء لا يعرض في agent_ids إلا أولئك الوكلاء، فقد يكون للزميل وكلاء آخرون.

لماذا يكون الاسم أو البريد الإلكتروني null؟​

ليس لكل حساب اسم أو بريد إلكتروني مسجّل.

هل أستطيع الحصول على أرقام هواتف زملائي؟​

لا. تُعيد الواجهة البرمجية اسم كل زميل ودوره وبريده الإلكتروني، ولا تُعيد رقم هاتفه أبداً.

هل يستطيع المفتاح دعوة زملاء أو إزالتهم، أو تغيير ما يستطيعون فتحه؟​

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

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

team:read، ويحمله كل مفتاح اليوم؛ راجع التوثيق. ويستطيع المفتاح قراءة البريد الإلكتروني لزملائك، لذا أبقِه على خوادمك.