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.

  1. Cadastre-se

    Crie sua conta em app.connectmq.com 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.

MQTT1883mqtt://broker.connectmq.com:1883TCP
MQTT sobre TLS8883mqtts://broker.connectmq.com:8883TCP + TLS
WebSocket8083ws://broker.connectmq.com:8083/mqttNavegadores (páginas HTTP)
WebSocket seguro8084wss://broker.connectmq.com:8084/mqttNavegadores (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

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()

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.

MQTT sobre WebSocket: Conecte um Navegador a um Broker MQTT com MQTT.js

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.

9 min de leitura