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

> Pergunta ao dono com botões ou lista e espera a resposta.

Pergunta ao dono com botões ou lista e espera a resposta.

## Entrada

| Campo | Tipo | Notas |
| - | - | - |
| `question` | string | Até 1024 caracteres. |
| `options` | array de 1 a 10 | Até 3 opções viram botões (título até 20 caracteres), de 4 a 10 viram lista (linha até 24). |
| `timeout_seconds` | number, opcional | Até 50. |

## Saída

`{ "status": "answered", "answer": ..., "message_id": string }` quando o dono responde a tempo, ou `{ "status": "pending", "question_id": string }` quando a espera termina antes. Passe o `question_id` para [wait\_for\_reply](https://docs.zapbip.com/pt-br/mcp-reference/wait-for-reply.md).

Repetir a mesma pergunta em até 4 minutos devolve a mesma pergunta e não envia nada. Veja [Perguntas](https://docs.zapbip.com/pt-br/concepts/questions.md).

## Tipos de mensagem

| Tipo | Agente para o dono | Dono para o agente |
| - | - | - |
| `text` | [send\_message](https://docs.zapbip.com/pt-br/mcp-reference/send-message.md) | texto |
| `image` | [send\_media](https://docs.zapbip.com/pt-br/mcp-reference/send-media.md), até 5 MB | a imagem inline até 1 MB, senão um link assinado |
| `video` | [send\_media](https://docs.zapbip.com/pt-br/mcp-reference/send-media.md), até 16 MB | link assinado |
| `audio` | [send\_media](https://docs.zapbip.com/pt-br/mcp-reference/send-media.md), até 16 MB, `voice` para mensagem de voz | link assinado |
| `document` | [send\_media](https://docs.zapbip.com/pt-br/mcp-reference/send-media.md), até 100 MB | link assinado, nome do arquivo e tipo MIME |
| `sticker` | [send\_media](https://docs.zapbip.com/pt-br/mcp-reference/send-media.md) | link assinado |
| `location` | [send\_location](https://docs.zapbip.com/pt-br/mcp-reference/send-location.md) | latitude, longitude, nome e endereço |
| `contacts` | [send\_contact](https://docs.zapbip.com/pt-br/mcp-reference/send-contact.md) | os cartões de contato |
| `reaction` | [react](https://docs.zapbip.com/pt-br/mcp-reference/react.md) | `message_id` e `emoji`, roteados ao agente que enviou a mensagem reagida |
| `choice` | [ask](https://docs.zapbip.com/pt-br/mcp-reference/ask.md), até 3 opções como botões e de 4 a 10 como lista | `option_id`, `title` e `description` opcional |
| citação | `reply_to` em todo envio | `reply_to`, roteado ao agente que enviou a mensagem citada |


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