> For the complete documentation index, see [llms.txt](https://docs.kiloiot.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kiloiot.io/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/control-widget/button.md).
# Botão
Adicione um Controlo de Botão a um painel IoT Kilo para disparar um comando de dispositivo único — reiniciar, abrir ou iniciar.
A **Botão** é o tipo de ação de disparo único. Um pressionar envia um comando uma vez. Ao contrário de um Interruptor, não representa um estado duradouro — ele aciona algo e termina.
## Quando usar
Use um Botão para ações momentâneas ou de acionamento, onde não há um estado ligado/desligado a manter: **redefinir** um equipamento, acionar uma **calibração**, **abrir um portão**, ou **iniciar um processo**. Se a ação for "faça isto agora" em vez de "permanecer neste estado", um Botão é o controlo certo.
## O que precisa primeiro
* Um dispositivo controlável com um comando definido na sua **separador Comandos & Estados** separador (ver [Criar Comandos](/kilo-docs-pt/kilo-iot-server/devices/commands/creating-commands.md)).
* O comando que executa a ação que pretende que o botão dispare.
## Como configurá-lo
1. Abra o painel em **modo de edição** → **Adicionar widget** → **Controlo**.
2. **Origem de dados** separador: escolha o **Dispositivo** e um separador **Métrica do dispositivo**. Clique em **Seguinte**.
3. **Aparência** separador: introduza um **Nome do widget**, depois em **Tipo de widget** escolha **Botão**.
4. Defina a **ligações de estado** com o **Comando** o botão envia (e qualquer parâmetro **Valor**s), mais o **Valor esperado do sensor** onde a ação produz um estado verificável.
5. Defina a **Cor do botão** (Ativo / Inativo / Desativado) e a **Tamanho do botão** — **S**, **M**, ou **L** (predefinição M). Alternar **Mostrar nome e última atualização**.
6. Clique em **Salvar**.
## O que acontece quando o utiliza
Pressionar o botão envia o seu comando uma vez através da cadeia de comandos do dispositivo, e a execução é registada no **separador Estados** histórico do separador, tal como qualquer outro comando. Não há nenhuma posição persistente de ligado/desligado a manter — o botão é um disparador.
## Erros comuns
* **Usar um Botão para um estado que precisa de ver** — se precisar que o painel mostre se algo está ligado ou desligado, use um [Interruptor](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/control-widget/switch.md) em vez disso.
* **Esperar confirmação que uma ação momentânea não pode dar** — um disparo único (por exemplo, "redefinir") pode não produzir uma alteração métrica duradoura para verificar; isso é esperado.
## Ver também
* [Widget de controlo](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/control-widget.md) — visão geral e os outros tipos de controlo
* [Comandos do Dispositivo](/kilo-docs-pt/kilo-iot-server/devices/commands.md) — defina o comando que este botão dispara
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.kiloiot.io/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/control-widget/button.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
