> ## 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.

# Hermes

> راسل Hermes على WhatsApp ودعه يجيب دون حد زمني.

## ما الذي يعمل

يستمع Hermes إلى WhatsApp الخاص بك باستمرار عبر مكوّن إضافي صغير من zapbip. وسواء راسلته أولًا أو أجبت لاحقًا عن سؤال، تصل الرسالة إلى جلسة Hermes.

WhatsApp: Hermes

### الرسائل التي تعيد توجيهها

الرسائل التي تعيد توجيهها من شخص آخر تصل إلى Hermes مع وسم يبيّن أنك لم تكتبها، فلا يعاملها Hermes كتعليماتك.

## كيف يستمع

نوع الإيقاظ: محلي. عندما يكون هناك سؤال معلّق، ينتظر Hermes 50 ثانية على الأكثر في كل مرة. وإذا لم تجب بعد، ينتهي هذا الانتظار بحالة «قيد الانتظار» (pending)، فيستدعي Hermes مرة أخرى، بقدر ما يلزم، دون حد زمني.

يُبقي المكوّن الإضافي اتصالًا واحدًا مفتوحًا بـ zapbip، دون حد زمني. وإذا انقطعت الشبكة، يعيد الاتصال تلقائيًا، وينتظر بعد كل فشل مدة أطول قليلًا (ثانية واحدة في البداية، و30 ثانية على الأكثر). وخلال ذلك تنتظر رسائلك في صندوق وارد zapbip، ويجلب المكوّن الإضافي فور عودته كل رسالة لم يُجَب عنها.

### إذا تعذّر تثبيت المكوّن الإضافي

يستطيع Hermes فحص الصندوق دوريًا بدلًا من ذلك. أضف خادم MCP في الإعدادات، وأنشئ مهمة تستدعي `check_inbox` كل دقيقة. تنتظر رسائلك دقيقة على الأكثر، ويصل الجواب بالطريقة نفسها.

## الإعداد من الصفر

### ما الذي تحتاج إليه

* Hermes مع تشغيل البوابة (gateway).
* رابط اتصالك، وهو الرابط نفسه `https://.../c/<secret>/mcp` الذي يستخدمه الذكاء الاصطناعي لديك للتواصل مع zapbip. عامله كما تعامل كلمة المرور.

### ثبّت المكوّن الإضافي

ثبّت الحزمة في بيئة Python التي يعمل فيها Hermes:

```bash theme={null}
d=$(mktemp -d) && curl -fsSL https://mcp.zapbip.com/pkg/zapbip_platform-0.1.0-requirements.txt -o "$d/zapbip-requirements.txt" && python3 -c 'import hashlib,sys; sys.exit(hashlib.sha256(open(sys.argv[1],"rb").read()).hexdigest() != sys.argv[2])' "$d/zapbip-requirements.txt" fc258f304227f3eb44169c5416f581424296a876995c6499daaa42c7cf04cc31 && python3 -m pip install --only-binary=:all: --require-hashes -r "$d/zapbip-requirements.txt"
```

ثم فعّله في `~/.hermes/config.yaml`:

```yaml theme={null}
plugins:
  enabled:
    - zapbip-platform
```

اضبط الرابط ومن يُسمح له بمحادثة Hermes في البيئة التي تعمل فيها البوابة، ولا تكتبهما أبدًا في ملف تشاركه:

```bash theme={null}
export ZAPBIP_CONNECTION_LINK='https://<host>/c/<secret>/mcp'
export ZAPBIP_ALLOWED_USERS=owner
```

الملف الذي يحمل رابط اتصالك يعادل كلمة مرور. اجعل صلاحياته `600` ليقرأه مستخدمك وحده، ولا تشاركه ولا تضعه في commit:

```bash theme={null}
chmod 600 <file>
```

أعد تشغيل البوابة.

شغّل مستمعًا واحدًا فقط لكل وكيل: المكوّن الإضافي أو `npx zapbip@0.1.0 listen`، وليس الاثنين معًا. المستمع الثاني يحل محل الأول.

### كيف يجيب Hermes

تعود ردود Hermes على رسائلك عبر المكوّن الإضافي نفسه، دون إعداد إضافي.

أضف zapbip بصفته خادم MCP ليتمكن Hermes أيضًا من بدء محادثة معك، وسؤالك بالأزرار وانتظار الجواب، ومن استخدام بديل الفحص الدوري أدناه:

```yaml theme={null}
mcp_servers: { zapbip: { url: 'https://<host>/c/<secret>/mcp' } }
```

ثم اطلب من Hermes على WhatsApp أن يرسل `✅ تم التثبيت`. إذا وصلت هذه الرسالة فكل شيء سليم.

WhatsApp: zapbip

## تحقق من أنه يعمل

| ما تراه | معناه |
| - | - |
| رسالتك لا تُجاب | البوابة لا تعمل، أو المكوّن الإضافي ليس في `plugins.enabled`. |
| توقف المكوّن الإضافي من تلقاء نفسه | بدأ مكوّن إضافي آخر أو موصّل آخر للاتصال نفسه وحلّ محله. |
| Hermes لا يبدأ محادثة ولا يسألك | خادم MCP باسم `zapbip` غير موجود في `config.yaml`. |
| توقف المكوّن الإضافي بخطأ | الرابط غير معروف أو أُبطل الاتصال. اطلب رابطًا جديدًا. |


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