Guía rápida para desarrolladores

Tu primer mensaje en tres pasos

ConnectMQ habla MQTT estándar, así que la biblioteca cliente que ya conoces funciona sin cambios. Consigue tus credenciales, elige un ejemplo y conéctate.

  1. Regístrate

    Crea tu cuenta en app.connectmq.com y abre tu broker.

  2. Crea credenciales

    Añade un usuario y una contraseña para tu dispositivo o servicio y permite los topics que necesita.

  3. Conéctate

    Usa uno de los ejemplos de abajo: sustituye YOUR_USERNAME y YOUR_PASSWORD y ejecútalo.

Endpoints

Puertos y protocolos

Usa TLS (8883) para dispositivos y servicios, y 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)
Ejemplos de código

Copia, pega y conéctate

Cada ejemplo se conecta mediante TLS (o WebSockets seguros en el navegador), se suscribe a devices/+/telemetry y publica una lectura en JSON.

Todos los ejemplos 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()

Preguntas frecuentes para desarrolladores

¿Qué puerto debo usar?

Usa el 8883 (MQTT sobre TLS) para dispositivos y servicios, y el 8084 (WebSockets seguros, ruta /mqtt) para aplicaciones de navegador. El 1883 y el 8083 no están cifrados y son solo para pruebas rápidas.

¿Dónde encuentro mi usuario y mi contraseña?

En tu panel de ConnectMQ en app.connectmq.com, después de registrarte. Crea credenciales independientes para cada dispositivo o servicio.

Mi cliente no se conecta, ¿qué debo comprobar?

Comprueba que el puerto corresponde al protocolo (TLS en el 8883, WSS en el 8084 con la ruta /mqtt), que las credenciales son correctas y que cada cliente usa un client ID único.

¿Listo para conectar tu primer dispositivo?

Crea una cuenta, obtén las credenciales de tu broker y conecta tu primer dispositivo, sin servidores que instalar, parchear ni escalar.

MQTT sobre WebSocket: conecta un navegador a un broker MQTT con MQTT.js

Los navegadores no pueden abrir sockets TCP directos, así que las aplicaciones web hablan MQTT sobre WebSocket. Construye un cliente de navegador y un cliente Node.js funcionales contra broker.connectmq.com y aprende a resolver los errores de conexión más comunes.

9 min de lectura