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

> Stellt dem Owner eine Frage mit Buttons oder einer Liste und wartet auf die Antwort.

Stellt dem Owner eine Frage mit Buttons oder einer Liste und wartet auf die Antwort.

## Eingabe

| Feld | Typ | Hinweise |
| - | - | - |
| `question` | string | Bis zu 1024 Zeichen. |
| `options` | Array mit 1 bis 10 | Bis zu 3 Optionen erscheinen als Buttons (Titel bis zu 20 Zeichen), 4 bis 10 als Liste (Zeile bis zu 24). |
| `timeout_seconds` | number, optional | Bis zu 50. |

## Ausgabe

`{ "status": "answered", "answer": ..., "message_id": string }`, wenn der Owner rechtzeitig antwortet, oder `{ "status": "pending", "question_id": string }`, wenn das Warten zuerst endet. Gib die `question_id` an [wait\_for\_reply](https://docs.zapbip.com/de/mcp-reference/wait-for-reply.md) weiter.

Dieselbe Frage innerhalb von 4 Minuten zu wiederholen gibt dieselbe Frage zurück und sendet nichts. Siehe [Fragen](https://docs.zapbip.com/de/concepts/questions.md).

## Nachrichtenarten

| Art | Agent an Owner | Owner an Agent |
| - | - | - |
| `text` | [send\_message](https://docs.zapbip.com/de/mcp-reference/send-message.md) | Text |
| `image` | [send\_media](https://docs.zapbip.com/de/mcp-reference/send-media.md), bis zu 5 MB | das Bild inline bis 1 MB, sonst ein signierter Link |
| `video` | [send\_media](https://docs.zapbip.com/de/mcp-reference/send-media.md), bis zu 16 MB | signierter Link |
| `audio` | [send\_media](https://docs.zapbip.com/de/mcp-reference/send-media.md), bis zu 16 MB, `voice` für eine Sprachnachricht | signierter Link |
| `document` | [send\_media](https://docs.zapbip.com/de/mcp-reference/send-media.md), bis zu 100 MB | signierter Link, Dateiname und MIME-Typ |
| `sticker` | [send\_media](https://docs.zapbip.com/de/mcp-reference/send-media.md) | signierter Link |
| `location` | [send\_location](https://docs.zapbip.com/de/mcp-reference/send-location.md) | Breitengrad, Längengrad, Name und Adresse |
| `contacts` | [send\_contact](https://docs.zapbip.com/de/mcp-reference/send-contact.md) | die Kontaktkarten |
| `reaction` | [react](https://docs.zapbip.com/de/mcp-reference/react.md) | `message_id` und `emoji`, geleitet an den Agent, der die Nachricht gesendet hat, auf die reagiert wurde |
| `choice` | [ask](https://docs.zapbip.com/de/mcp-reference/ask.md), bis zu 3 Optionen als Buttons und 4 bis 10 als Liste | `option_id`, `title` und optional `description` |
| Zitat | `reply_to` bei jedem Senden | `reply_to`, geleitet an den Agent, der die zitierte Nachricht gesendet hat |


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