--- title: "Guia rápido: conecte-se ao broker MQTT ConnectMQ | ConnectMQ" description: "Conecte seu primeiro cliente MQTT ao ConnectMQ: endpoints, portas e exemplos de código em Python, Node.js, navegador, ESP32, Go e a CLI do mosquitto." url: "https://connectmq.com/pt/desenvolvedores/" language: "pt" --- Guia rápido para desenvolvedores # Sua primeira mensagem em três passos O ConnectMQ fala MQTT padrão, então a biblioteca cliente que você já conhece funciona sem alterações. Pegue suas credenciais, escolha um exemplo e conecte-se. [Obter credenciais](https://app.connectmq.com/signup) [Ver exemplos de código](#samples) 1. ## Cadastre-se Crie sua conta em [app.connectmq.com](https://app.connectmq.com/signup) e abra seu broker. 2. ## Crie credenciais Adicione um usuário e uma senha para seu dispositivo ou serviço e libere os tópicos de que ele precisa. 3. ## Conecte-se Use um dos exemplos abaixo — substitua YOUR\_USERNAME e YOUR\_PASSWORD e execute. Endpoints ## Portas e protocolos Use TLS (8883) para dispositivos e serviços e WebSockets seguros (8084) para navegadores. MQTT**1883**`mqtt://broker.connectmq.com:1883`TCP MQTT sobre TLS**8883**`mqtts://broker.connectmq.com:8883`TCP + TLS WebSocket**8083**`ws://broker.connectmq.com:8083/mqtt`Navegadores (páginas HTTP) WebSocket seguro**8084**`wss://broker.connectmq.com:8084/mqtt`Navegadores (páginas HTTPS) Exemplos de código ## Copie, cole, conecte Cada exemplo se conecta via TLS (ou WebSockets seguros no navegador), assina `devices/+/telemetry` e publica uma leitura em JSON. [Todos os exemplos de código](https://connectmq.com/pt/exemplos-de-codigo/) client.py · pip install "paho-mqtt>=2.0" ``` import paho.mqtt.client as mqtt def on_connect(client, userdata, flags, reason_code, properties): print("Connected:", reason_code) client.subscribe("devices/+/telemetry", qos=1) client.publish("devices/sensor-1/telemetry", '{"temperature": 21.5}', qos=1) def on_message(client, userdata, msg): print(msg.topic, msg.payload.decode()) client = mqtt.Client(mqtt.CallbackAPIVersion.VERSION2, client_id="sensor-1") client.username_pw_set("YOUR_USERNAME", "YOUR_PASSWORD") client.tls_set() # TLS on port 8883 client.on_connect = on_connect client.on_message = on_message client.connect("broker.connectmq.com", 8883) client.loop_forever() ``` client.mjs · npm install mqtt ``` import mqtt from 'mqtt'; const client = await mqtt.connectAsync('mqtts://broker.connectmq.com:8883', { clientId: 'service-1', username: 'YOUR_USERNAME', password: 'YOUR_PASSWORD', }); client.on('message', (topic, payload) => { console.log(topic, payload.toString()); }); await client.subscribeAsync('devices/+/telemetry', { qos: 1 }); await client.publishAsync('devices/sensor-1/telemetry', JSON.stringify({ temperature: 21.5 }), { qos: 1 }); ``` dashboard.js · npm install mqtt ``` import mqtt from 'mqtt'; // Browsers connect over secure WebSockets. const client = mqtt.connect('wss://broker.connectmq.com:8084/mqtt', { username: 'YOUR_USERNAME', password: 'YOUR_PASSWORD', }); client.on('connect', () => client.subscribe('devices/+/telemetry')); client.on('message', (topic, payload) => { document.querySelector('#log').textContent += `${topic}: ${payload}\n`; }); ``` sketch.ino · Arduino Library Manager → PubSubClient ``` #include #include #include WiFiClientSecure net; PubSubClient mqtt(net); void setup() { WiFi.begin("YOUR_WIFI", "YOUR_WIFI_PASSWORD"); while (WiFi.status() != WL_CONNECTED) delay(250); net.setInsecure(); // for a first test; use net.setCACert(...) in production mqtt.setServer("broker.connectmq.com", 8883); } void loop() { if (!mqtt.connected()) { mqtt.connect("esp32-01", "YOUR_USERNAME", "YOUR_PASSWORD"); } mqtt.loop(); static unsigned long last = 0; if (millis() - last > 5000) { last = millis(); mqtt.publish("devices/esp32-01/telemetry", "{\"temperature\":21.5}"); } } ``` main.go · go get github.com/eclipse/paho.mqtt.golang ``` package main import ( "fmt" mqtt "github.com/eclipse/paho.mqtt.golang" ) func main() { opts := mqtt.NewClientOptions(). AddBroker("ssl://broker.connectmq.com:8883"). SetClientID("go-service"). SetUsername("YOUR_USERNAME"). SetPassword("YOUR_PASSWORD") client := mqtt.NewClient(opts) if token := client.Connect(); token.Wait() && token.Error() != nil { panic(token.Error()) } client.Subscribe("devices/+/telemetry", 1, func(_ mqtt.Client, m mqtt.Message) { fmt.Println(m.Topic(), string(m.Payload())) }) client.Publish("devices/sensor-1/telemetry", 1, false, `{"temperature":21.5}`).Wait() select {} } ``` terminal · apt install mosquitto-clients · brew install mosquitto ``` # Subscribe (terminal 1) mosquitto_sub -h broker.connectmq.com -p 8883 --tls-use-os-certs \ -u YOUR_USERNAME -P YOUR_PASSWORD -t 'devices/#' -v # Publish (terminal 2) mosquitto_pub -h broker.connectmq.com -p 8883 --tls-use-os-certs \ -u YOUR_USERNAME -P YOUR_PASSWORD \ -t devices/sensor-1/telemetry -m '{"temperature":21.5}' ``` ## Perguntas frequentes para desenvolvedores Qual porta devo usar? Use 8883 (MQTT sobre TLS) para dispositivos e serviços, e 8084 (WebSockets seguros, caminho /mqtt) para aplicações no navegador. As portas 1883 e 8083 não são criptografadas e servem apenas para testes rápidos. Onde encontro meu usuário e senha? No seu dashboard do ConnectMQ em app.connectmq.com, depois de se cadastrar. Crie credenciais separadas para cada dispositivo ou serviço. Meu cliente não consegue se conectar — o que devo verificar? Verifique se a porta corresponde ao protocolo (TLS na 8883, WSS na 8084 com caminho /mqtt), se as credenciais estão corretas e se cada cliente usa um client ID único. ## Pronto para conectar seu primeiro dispositivo? Crie uma conta, receba as credenciais do seu broker e conecte seu primeiro dispositivo — sem servidores para instalar, atualizar ou escalar. [Começar agora](https://app.connectmq.com/signup) [Ver preços](https://connectmq.com/pt/precos/) ## Artigos [Todos os artigos](https://connectmq.com/pt/blog/) Tutoriais de IoT ### [Broker MQTT Público e Gratuito para Testes: Conecte ao broker.connectmq.com em Minutos](https://connectmq.com/pt/blog/broker-mqtt-publico-gratuito/) O broker.connectmq.com é um servidor MQTT público e gratuito para testes e aprendizado. Aqui estão as portas, as regras de acesso anônimo, os limites e exemplos prontos para copiar e colar no CLI, em Python, Node.js e no navegador. 20 de setembro de 20268 min de leitura Tutoriais de IoT ### [MQTT sobre WebSocket: Conecte um Navegador a um Broker MQTT com MQTT.js](https://connectmq.com/pt/blog/mqtt-sobre-websocket/) Navegadores não conseguem abrir sockets TCP puros, então aplicações web falam MQTT sobre WebSocket. Construa um cliente funcional no navegador e outro em Node.js usando o servidor MQTT público broker.connectmq.com e aprenda a resolver os erros de conexão mais comuns. 29 de setembro de 20269 min de leitura Tutoriais de IoT ### [Tutorial ESP32 MQTT: Publique Dados de Sensores e Controle um LED com a Arduino IDE](https://connectmq.com/pt/blog/tutorial-esp32-mqtt/) Conecte um ESP32 a um broker MQTT com a Arduino IDE e o PubSubClient, publique leituras de temperatura em JSON, controle o LED da placa pela linha de comando e migre para TLS com credenciais do portal. 23 de agosto de 20269 min de leitura