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

# ask

> اسأل صاحب الحساب بأزرار أو قائمة وانتظر الجواب.

اسأل صاحب الحساب بأزرار أو قائمة وانتظر الجواب.

## المدخلات

| الحقل | النوع | الوصف |
| - | - | - |
| `question` | string | حتى 1024 حرفًا. |
| `options` | مصفوفة من 1 إلى 10 عناصر | حتى 3 خيارات تظهر أزرارًا (العنوان حتى 20 حرفًا)، ومن 4 إلى 10 تظهر قائمة (الصف حتى 24 حرفًا). |
| `timeout_seconds` | number، اختياري | حتى 50. |

## المخرجات

`{ "status": "answered", "answer": ..., "message_id": string }` عندما يجيب صاحب الحساب في الوقت المناسب؛ و`{ "status": "pending", "question_id": string }` عندما ينتهي الانتظار أولًا. مرّر `question_id` إلى [wait\_for\_reply](https://docs.zapbip.com/ar/mcp-reference/wait-for-reply.md).

تكرار السؤال نفسه خلال 4 دقائق يعيد السؤال نفسه ولا يرسل أي شيء. راجع [الأسئلة](https://docs.zapbip.com/ar/concepts/questions.md).

## أنواع الرسائل

| النوع | من الوكيل إلى صاحب الحساب | من صاحب الحساب إلى الوكيل |
| - | - | - |
| `text` | [send\_message](https://docs.zapbip.com/ar/mcp-reference/send-message.md) | نص |
| `image` | [send\_media](https://docs.zapbip.com/ar/mcp-reference/send-media.md)، حتى 5 MB | مضمّنة حتى 1 MB، وإلا رابط موقّع |
| `video` | [send\_media](https://docs.zapbip.com/ar/mcp-reference/send-media.md)، حتى 16 MB | رابط موقّع |
| `audio` | [send\_media](https://docs.zapbip.com/ar/mcp-reference/send-media.md)، حتى 16 MB، والرسالة الصوتية بـ `voice` | رابط موقّع |
| `document` | [send\_media](https://docs.zapbip.com/ar/mcp-reference/send-media.md)، حتى 100 MB | رابط موقّع واسم الملف ونوع MIME |
| `sticker` | [send\_media](https://docs.zapbip.com/ar/mcp-reference/send-media.md) | رابط موقّع |
| `location` | [send\_location](https://docs.zapbip.com/ar/mcp-reference/send-location.md) | خط العرض وخط الطول والاسم والعنوان |
| `contacts` | [send\_contact](https://docs.zapbip.com/ar/mcp-reference/send-contact.md) | بطاقات جهات الاتصال |
| `reaction` | [react](https://docs.zapbip.com/ar/mcp-reference/react.md) | `message_id` و`emoji`، وتُوجَّه إلى الوكيل الذي أرسل الرسالة المتفاعَل معها |
| `choice` | [ask](https://docs.zapbip.com/ar/mcp-reference/ask.md)، حتى 3 خيارات أزرار، ومن 4 إلى 10 قائمة | `option_id` و`title` و`description` اختياري |
| اقتباس | `reply_to` في كل إرسال | `reply_to`، ويُوجَّه إلى الوكيل الذي أرسل الرسالة المقتبسة |


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