> ## 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/ko/mcp-reference/wait-for-reply.md)에 전달하세요.

4분 안에 같은 질문을 반복하면 같은 질문이 반환되고 아무것도 전송되지 않아요. [질문](https://docs.zapbip.com/ko/concepts/questions.md)을 보세요.

## 메시지 종류

| 종류 | 에이전트에서 소유자로 | 소유자에서 에이전트로 |
| - | - | - |
| `text` | [send\_message](https://docs.zapbip.com/ko/mcp-reference/send-message.md) | 텍스트 |
| `image` | [send\_media](https://docs.zapbip.com/ko/mcp-reference/send-media.md), 최대 5 MB | 1 MB 이하면 이미지를 그대로, 그 외에는 서명된 링크 |
| `video` | [send\_media](https://docs.zapbip.com/ko/mcp-reference/send-media.md), 최대 16 MB | 서명된 링크 |
| `audio` | [send\_media](https://docs.zapbip.com/ko/mcp-reference/send-media.md), 최대 16 MB, 음성 메시지는 `voice` | 서명된 링크 |
| `document` | [send\_media](https://docs.zapbip.com/ko/mcp-reference/send-media.md), 최대 100 MB | 서명된 링크, 파일 이름, MIME 타입 |
| `sticker` | [send\_media](https://docs.zapbip.com/ko/mcp-reference/send-media.md) | 서명된 링크 |
| `location` | [send\_location](https://docs.zapbip.com/ko/mcp-reference/send-location.md) | 위도, 경도, 이름, 주소 |
| `contacts` | [send\_contact](https://docs.zapbip.com/ko/mcp-reference/send-contact.md) | 연락처 카드 |
| `reaction` | [react](https://docs.zapbip.com/ko/mcp-reference/react.md) | `message_id`와 `emoji`. 반응한 메시지를 보낸 에이전트에게 전달돼요 |
| `choice` | [ask](https://docs.zapbip.com/ko/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.