Message

Send a Meshblu message

Send a message to one or more Meshblu devices. In order to send a device a message, the connection must be authenticated as a device that is in the recipient's message.from whitelist. See the Meshblu whitelist documentation for more information.

Event: "message", message

• message Message object, must contain only the devices property. topic is treated special by Meshblu. Other properties are forwarded to the recipient(s), but Meshblu does not act on them in any way.
  • devices Array of UUIDs of devices to send the message to. If any of the UUIDs are the special string "*", then the message will also be emitted as a broadcast message, and can be picked up by anyone in the emitter's broadcast.sent whitelist.
  • topic If the topic is provided as a string and the message is broadcast, the topic can be used by subscribers to filter incoming messages server-side.

🚧

Check the permissions

In order to send a device a message, the connection must be authenticated as a device that is in the recipient's message.from whitelist. See the Meshblu whitelist documentation for more information.

📘

Meshblu does not currently provide any receipt confirmation natively. If a message is sent to an offline recipient that has no message forwarding or device subscriptions, the message will be dropped. If it is important to know when the recipient received a message, it is recommended to have the recipient send some form of acknowledgement message back.