MQTT no Home Assistant
mqtt
parte do Home Assistant desde pre 0.7
A integração MQTT permite que o Home Assistant se conecte a dispositivos e sistemas via um broker de mensagens local, facilitando o controle e a atualização em tempo real. É usada para integrar uma ampla gama de dispositivos inteligentes e sensores.
Utilização típica
- Controle de dispositivos inteligentes
- Monitoramento de sensores
- Notificações por push
- Integração com sistemas IoT
Factos sobre esta integração
- Compatível com o Home Assistant
- sim, integração oficial
- Ligação
- Local, empurrar – Fala com o dispositivo em sua própria rede e é informado sobre cada mudança imediatamente.
- Configurar
- na interface do utilizador
- Tipo
- Serviço online
- Escala de qualidade
- Platina – O nível mais alto: totalmente tipado, eficiente e mantido em todas as regras do projeto.
- Instalações
- 276.069 (38,3 % das instalações que partilham estatísticas)
- Fornece
- Painel de controle de alarme, Sensor binário, Botão, Câmera, Clima, Coberturas, Data, Data e hora, Rastreador de dispositivos, Diagnósticos, Evento, Ventilador, Humidificador, Imagem, Cortador de relva, Luz, Bloquear, Notificação, Número, Cena, Seleccionar, Sensor, Sirene, Interruptor, Escâner de etiquetas, Texto, Tempo, Atualizar, Aspirador, Válvula, Aquecedor de água
- Mantido por
- @emontnemery, @jbouwh, @bdraco
- Pacotes Python
paho-mqtt==2.1.0
Configurar
- No Home Assistant abrir Definições → Dispositivos e serviços.
- Clique em "Adicionar integração" e procure por MQTT.
- Siga o diálogo – pede tudo o que a integração precisa.
Adicionar ao meu Home Assistant
O link passa por my.home-assistant.io e abre o diálogo de configuração em sua própria instância – nenhum endereço nosso está envolvido.
Complementos compatíveis
Complementos que declaram uma conexão a esta integração em sua própria configuração.
Blueprints que usam esta integração
- Automação AWTRIX show entity
- Automação Controller - IKEA E2001/E2002 STYRBAR Remote control
- Automação Zigbee2MQTT - Tuya 4-Button Scene Switch
- Automação Controller - IKEA E1524/E1810 TRÅDFRI Wireless 5-Button Remote
- Automação Controller - IKEA E1743 TRÅDFRI On/Off Switch & Dimmer
- Automação Controller - IKEA E1744 SYMFONISK Rotary Remote
Problemas e correções conhecidos
No rastreador de problemas do Home Assistant estão registados para MQTT 9 problemas abertos e 39 correções de erros nos últimos doze meses. Se algo não funcionar, atualize primeiro: a correção mais recente incluída com Home Assistant 2026.10.2.
Abrir
- aberto Cannot interpret the data sent by the Tasmota device.
- aberto The switch's current state doesn't update properly even though commands are working.
- aberto The MQTT integration stops working after updating to version 2026.8.3.
- aberto Some messages from zigbee2mqtt are triggered twice, even after a previous fix.
- aberto The MQTT system incorrectly shows the host as unavailable.
- aberto The option to retain MQTT messages in automation is unclear and may cause confusion.
- aberto The lock status of the switch bot is displayed incorrectly.
- aberto Wireless scene switch devices like Moes don't function correctly in automation actions. Afeta: Interruttore di scena wireless Moes e similari
Fixo
- fixado em 2026.10.2 MQTT device triggers and tags may fire twice after reloading.
- fixado em 2026.10.0 Optimistic MQTT climate setpoints are swapped when switching HVAC modes.
- fixado em 2026.9.4 The entity ID is now logged in MQTT group member update messages.
- fixado em 2026.8.0 Empty JSON objects in MQTT IR signal payloads are now ignored without error messages.
- fixado em 2026.6.4 The MQTT discovery option was mistakenly added to entry data and has been corrected.
- fixado em 2026.6.3 MQTT entities disabled by the user are not re-enabled through discovery.
- fixado em 2026.6.2 Reloading MQTT fails if the entry isn't properly set up, now fixed.
- fixado em 2026.6.1 Certificate files are created before migrating MQTT configuration to avoid errors.
- fixado em 2026.6.1 Value templates in MQTT Fan and Siren setups are now correctly applied.
- fixado em 2026.6.0 Correcção de erros #172732
- fixado em 2026.6.0 Correcção de erros #172629
- fixado em 2026.6.0 The MQTT protocol setting is now in the main configuration options.
Fonte: o rastreador de problemas do Home Assistant, a partir de 1 de Novembro, 2026. As frases são escritas por um modelo de linguagem a partir dos títulos das questões; os próprios relatórios estão no GitHub.
Verifique um dispositivo específico para problemas conhecidos na verificação do produto →
Fonte desta entrada: documentação oficial da integração
A descrição foi escrita por um modelo de linguagem a partir dos fatos aqui listados, não retirado da documentação.