# فريقك

> اعرض زملاءك في مجيب ومن يمكن إسناد عملاء الوكيل المحتملين ومحادثاته إليه، عبر GET /v1/agents/{agentId}/members وGET /v1/organization/members. للقراءة فقط.

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

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

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

```bash
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`. راجع [إسناد العملاء المحتملين وتصفيتهم وحقولهم](./lead-assignment-and-fields) للإسناد، و[مرجع عرض أعضاء الفريق لوكيل](../api-reference/list-agent-members) لكل الحقول.

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

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

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

يأتي كل عضو بدوره وبريده الإلكتروني والوكلاء الذين يستطيع فتحهم: `all_agents: true` تعني كل الوكلاء، ومنهم من تضيفهم لاحقاً؛ وإلا فإن `agent_ids` تسرد الوكلاء الذين أُعطيهم. راجع [مرجع عرض أعضاء منظمتك](../api-reference/list-organization-members).

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

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

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

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

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

### لماذا `agent_ids` فارغة؟

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

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

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

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

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

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

لا. الاستدعاءان للقراءة فقط. أدِر فريقك من صفحة **الفريق** في لوحة التحكم، بصفتك المالك أو مديراً لديه كل الوكلاء؛ راجع [إدارة الفريق](/docs/features/team-management).

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

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