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.

Repetir a mesma pergunta em até 4 minutos devolve a mesma pergunta e não envia nada. Veja Perguntas.

​

Tipos de mensagem

Tipo	Agente para o dono	Dono para o agente
text	send_message	texto
image	send_media, até 5 MB	a imagem inline até 1 MB, senão um link assinado
video	send_media, até 16 MB	link assinado
audio	send_media, até 16 MB, voice para mensagem de voz	link assinado
document	send_media, até 100 MB	link assinado, nome do arquivo e tipo MIME
sticker	send_media	link assinado
location	send_location	latitude, longitude, nome e endereço
contacts	send_contact	os cartões de contato
reaction	react	message_id e emoji, roteados ao agente que enviou a mensagem reagida
choice	ask, 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