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

# connect_agent

> اربط وكيلًا جديدًا بعد أن يسمح صاحب الحساب بذلك على WhatsApp.

يربط وكيلًا جديدًا بهذا الحساب باسمه. يسأل النظام صاحب الحساب على WhatsApp بصفة الوكيل المستدعي، ويبقى الاستدعاء ينتظر الجواب. وهو ينفّذ حالة الاستخدام نفسها لأمر `وكيل جديد`، فقواعد الاسم وحد 8 وكلاء ورابط التثبيت كلها كما هي. راجع [دع الذكاء الاصطناعي لديك يدير zapbip](https://docs.zapbip.com/ar/features/let-your-ai-manage-zapbip.md).

## المدخلات

| الحقل | النوع | الوصف |
| - | - | - |
| `name` | string | يُبسَّط كما في الأمر: أحرف صغيرة، دون علامات تشكيل، وشرطة بدل المسافة، حتى 20 حرفًا. |

## السؤال

ثلاثة أزرار: **Allow** و**Allow, send to agent** و**Deny**، وفي نهاية السؤال رقم قصير. ينتظر الاستدعاء 50 ثانية على الأكثر. والرد بالزر وحده هو المعتبر: النص المكتوب يُعامل على أنه Deny. لا يغيّر Deny ولا عدم الرد أي شيء، ولا يغيّر الرد بعد انتهاء الانتظار أي شيء؛ وبعدها يُرفض الطلب نفسه (`cooling_down`) لمدة 10 دقائق.

## المخرجات

`{ "status": "applied" | "denied" | "timed_out" | "refused", "agent": string | null, "reason": string | null, "install_prompt": string | null }`.

* `applied`: رُبط الوكيل. عند اختيار **Allow** يُرسَل رابط التثبيت إلى صاحب الحساب عبر WhatsApp ويكون `install_prompt` هو `null`. وعند اختيار **Allow, send to agent** يحمل `install_prompt` السطرين اللذين يُلصقان في الوكيل الجديد. وهذه هي الطريقة الوحيدة التي يدخل بها رابط أو سرّ إلى نتيجة أداة.
* `denied` و`timed_out`: لا شيء تغيّر.
* `refused`: يكون `reason` أحد `invalid_name` أو `reserved_name` أو `name_taken` أو `limit_reached` أو `cooling_down` أو `window_closed` أو `send_failed` أو `suspended` أو `waitlisted`. يُرفض الاسم غير الصالح أو المحجوز قبل سؤال صاحب الحساب. وعندما يتعذّر إرسال الرابط، يُبطَل الاتصال الذي أُنشئ من جديد.

الاستدعاءات التي تنفّذ إجراءً (`connect_agent` و[revoke\_agent](https://docs.zapbip.com/ar/mcp-reference/revoke-agent.md) و[sign\_in\_link](https://docs.zapbip.com/ar/mcp-reference/sign-in-link.md)) محدودة بـ 3 في الدقيقة لكل اتصال؛ ويعيد الاستدعاء التالي خطأ يبدأ بـ `rate_limited`.


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