ask - zapbip

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

المدخلات

الحقل	النوع	الوصف
`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. تكرار السؤال نفسه خلال 4 دقائق يعيد السؤال نفسه ولا يرسل أي شيء. راجع الأسئلة.

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

النوع	من الوكيل إلى صاحب الحساب	من صاحب الحساب إلى الوكيل
`text`	send_message	نص
`image`	send_media، حتى 5 MB	مضمّنة حتى 1 MB، وإلا رابط موقّع
`video`	send_media، حتى 16 MB	رابط موقّع
`audio`	send_media، حتى 16 MB، والرسالة الصوتية بـ `voice`	رابط موقّع
`document`	send_media، حتى 100 MB	رابط موقّع واسم الملف ونوع MIME
`sticker`	send_media	رابط موقّع
`location`	send_location	خط العرض وخط الطول والاسم والعنوان
`contacts`	send_contact	بطاقات جهات الاتصال
`reaction`	react	`message_id` و`emoji`، وتُوجَّه إلى الوكيل الذي أرسل الرسالة المتفاعَل معها
`choice`	ask، حتى 3 خيارات أزرار، ومن 4 إلى 10 قائمة	`option_id` و`title` و`description` اختياري
اقتباس	`reply_to` في كل إرسال	`reply_to`، ويُوجَّه إلى الوكيل الذي أرسل الرسالة المقتبسة