> ## 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/ja/mcp-reference/wait-for-reply.md) に渡してください。

4 分以内に同じ質問を繰り返すと、同じ質問が返り、何も送信されません。[質問](https://docs.zapbip.com/ja/concepts/questions.md)をご覧ください。

## メッセージの種類

| 種類 | エージェントからオーナーへ | オーナーからエージェントへ |
| - | - | - |
| `text` | [send\_message](https://docs.zapbip.com/ja/mcp-reference/send-message.md) | テキスト |
| `image` | [send\_media](https://docs.zapbip.com/ja/mcp-reference/send-media.md)、最大5 MB | 1 MB以下ならインラインの画像、それ以外は署名付きリンク |
| `video` | [send\_media](https://docs.zapbip.com/ja/mcp-reference/send-media.md)、最大16 MB | 署名付きリンク |
| `audio` | [send\_media](https://docs.zapbip.com/ja/mcp-reference/send-media.md)、最大16 MB、ボイスメッセージは `voice` | 署名付きリンク |
| `document` | [send\_media](https://docs.zapbip.com/ja/mcp-reference/send-media.md)、最大100 MB | 署名付きリンク、ファイル名、MIMEタイプ |
| `sticker` | [send\_media](https://docs.zapbip.com/ja/mcp-reference/send-media.md) | 署名付きリンク |
| `location` | [send\_location](https://docs.zapbip.com/ja/mcp-reference/send-location.md) | 緯度、経度、名称、住所 |
| `contacts` | [send\_contact](https://docs.zapbip.com/ja/mcp-reference/send-contact.md) | 連絡先カード |
| `reaction` | [react](https://docs.zapbip.com/ja/mcp-reference/react.md) | `message_id` と `emoji`。リアクションされたメッセージを送ったエージェントへ届く |
| `choice` | [ask](https://docs.zapbip.com/ja/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.