ask - zapbip

Pose une question au propriétaire avec des boutons ou une liste et attend la réponse.

Entrée

Champ	Type	Notes
`question`	string	Jusqu’à 1024 caractères.
`options`	tableau de 1 à 10	Jusqu’à 3 options s’affichent comme boutons (titre jusqu’à 20 caractères), de 4 à 10 comme liste (ligne jusqu’à 24).
`timeout_seconds`	number, facultatif	Jusqu’à 50.

Sortie

{ "status": "answered", "answer": ..., "message_id": string } quand le propriétaire répond à temps, ou { "status": "pending", "question_id": string } quand l’attente se termine d’abord. Passez le question_id à wait_for_reply. Répéter la même question dans les 4 minutes renvoie la même question et n’envoie rien. Voir Questions.

Types de messages

Type	Agent vers propriétaire	Propriétaire vers agent
`text`	send_message	texte
`image`	send_media, jusqu’à 5 MB	l’image en ligne jusqu’à 1 MB, sinon un lien signé
`video`	send_media, jusqu’à 16 MB	lien signé
`audio`	send_media, jusqu’à 16 MB, `voice` pour un message vocal	lien signé
`document`	send_media, jusqu’à 100 MB	lien signé, nom du fichier et type MIME
`sticker`	send_media	lien signé
`location`	send_location	latitude, longitude, nom et adresse
`contacts`	send_contact	les cartes de contact
`reaction`	react	`message_id` et `emoji`, acheminés vers l’agent qui a envoyé le message réagi
`choice`	ask, jusqu’à 3 options en boutons et de 4 à 10 en liste	`option_id`, `title` et `description` facultatif
citation	`reply_to` à chaque envoi	`reply_to`, acheminé vers l’agent qui a envoyé le message cité