ask - zapbip

Ask the owner a question with buttons or a list and wait for the answer.

Input

Field	Type	Notes
`question`	string	Up to 1024 characters.
`options`	array of 1 to 10	Up to 3 options render as buttons (title up to 20 characters), 4 to 10 as a list (row up to 24).
`timeout_seconds`	number, optional	Up to 50.

Output

{ "status": "answered", "answer": ..., "message_id": string } when the owner answers in time, or { "status": "pending", "question_id": string } when the wait ends first. Pass the question_id to wait_for_reply. Repeating the same question within 4 minutes returns the same question and sends nothing. See Questions.

Message kinds

Kind	Agent to owner	Owner to agent
`text`	send_message	text
`image`	send_media, up to 5 MB	the image inline when up to 1 MB, otherwise a signed link
`video`	send_media, up to 16 MB	signed link
`audio`	send_media, up to 16 MB, `voice` for a voice note	signed link
`document`	send_media, up to 100 MB	signed link, file name and MIME type
`sticker`	send_media	signed link
`location`	send_location	latitude, longitude, name and address
`contacts`	send_contact	the contact cards
`reaction`	react	`message_id` and `emoji`, routed to the agent that sent the reacted message
`choice`	ask, up to 3 options as buttons and 4 to 10 as a list	`option_id`, `title` and optional `description`
quote	`reply_to` on every send	`reply_to`, routed to the agent that sent the quoted message