Skip to main content

Send Messages (MT)

The ability to easily send Messages to Devices without needing to know the minutia of each protocol is a compelling benefit of the platform. The platform exposes a number of endpoints for this purpose, depending on the protocol the Device utilises. There are matching endpoints for each message type that will send to all Things within a Thing Group (all members of the group must support the message type).

SBD Message (RockBLOCK or 9602/9603)​

The RockBLOCK doesn't have any inherent protocol; you can send any payload (up to a maximum of 270 bytes).

  • thing - Cloudloop Thing Identifier for Device
  • messsage - Base16 (Hex) encoded payload you wish to send

Example (Sending Hello World to Thing):

Data/DoSendSbdMessage?thing=XXX&message=48656c6c6f20576f726c64

Endpoint: Data/DoSendSbdMessage

SBD Message to Group​

  • thingGroup - Cloudloop Thing Group Identifier
  • messsage - Base16 (Hex) encoded payload you wish to send

Example (Sending Hello World to Thing Group):

Data/DoSendSbdMessageForThingGroup?thingGroup=XXX&message=48656c6c6f20576f726c64

Endpoint: Data/DoSendSbdMessageForThingGroup

IMT Message (RockREMOTE)​

The RockREMOTE supports both "RAW" IMT messages as well as IoT Gateway Messages; you can send any payload (up to a maximum of 100 kilobytes).

  • thing - Cloudloop Thing Identifier for Device
  • messsage - Base64 encoded payload you wish to send

Example (Sending Hello World to Thing):

Data/DoSendImtMessage?thing=XXX&message=SGVsbG8gV29ybGQ=

Endpoint: Data/DoSendImtMessage

IMT Message to Group​

  • thingGroup - Cloudloop Thing Group Identifier
  • messsage - Base64 encoded payload you wish to send

Example (Sending Hello World to Thing Group):

Data/DoSendImtMessageForThingGroup?thingGroup=XXX&message=SGVsbG8gV29ybGQ=

Endpoint: Data/DoSendImtMessageForThingGroup

Checking IMT Delivery Status​

The deliver status of IMT MT messages can be checked with the Get MT delivery status endpoint. This will inform whether the device has acknowledged receiving the message corresponding to the data message record provided.

  • message - Identifier of the message you wish to check

Example

Data/GetMtDeliveryStatus?message=XXX

Endpoint: Data/GetMtDeliveryStatus

P6 Message (RockSTAR, RockFLEET or RockAIR)​

As defined by the P6 Protocol use the following endpoint to send Messages to Tracking Devices.

  • thing - Cloudloop Thing Identifier for Device
  • p6 - JSON Encoded P6MtMessage

Example (Sending Hello to screen of Thing):

Data/DoSendP6Message?thing=XXX&p6={"type": "MT_MESSAGE_TEXT", "textMessage":{"message": "Hello"}}

Endpoint: Data/DoSendP6Message

P6 Message to Group​

  • thingGroup - Cloudloop Thing Group Identifier
  • p6 - JSON Encoded P6MtMessage

Example (Sending Hello to screen of Thing Group):

Data/DoSendP6MessageForThingGroupAction?thingGroup=XXX&p6={"type": "MT_MESSAGE_TEXT", "textMessage":{"message": "Hello"}}

Endpoint: Data/DoSendP6MessageForThingGroupAction

IoT Gateway Message (RockREMOTE)​

**As defined by the IoT Gateway protocol use the following endpoint to send IoT Messages to Devices **

  • thing - Cloudloop Thing Identifier for Device
  • iot - JSON Encoded IoTMessage

Example (Publishing Hello World to topic this/is/my/topic on Thing):

Data/DoSendIotMessage?thing=XXX&iot={"topic": "hello/world", "message":"SGVsbG8gV29ybGQ="}

Endpoint: Data/DoSendIotMessage

IoT Gateway Message to Group​

  • thingGroup - Cloudloop Thing Group Identifier
  • iot - JSON Encoded IoTMessage

Example (Publishing Hello World to topic this/is/my/topic on Thing Group Devices):

Data/DoSendIotMessageForThingGroupAction?thingGroup=XXX&iot={"topic": "hello/world", "message":"SGVsbG8gV29ybGQ="}

Endpoint: Data/DoSendIotMessageForThingGroupAction

CDM Message (RockREMOTE)​

  • thing - Cloudloop Thing Identifier for Device
  • ceefax - JSON Encoded CeefaxMessage

Example (Send Restart command to Thing):

Data/DoSendCeefaxMessage?thing=XXX&ceefax={"message":[{"rebootRequest": {}}]}

Endpoint: Data/DoSendCeefaxMessage

CDM Message (RockREMOTE) to Group​

  • thingGroup - Cloudloop Thing Group Identifier
  • ceefax - JSON Encoded CeefaxMessage

Example (Send Restart command to Thing Group):

Data/DoSendCeefaxMessageForThingGroup?thingGroup=XXX&ceefax={"message":[{"rebootRequest": {}}]}

Endpoint: Data/DoSendCeefaxMessageForThingGroup

CDM Message (RockREMOTE Mini)​

  • thing - Cloudloop Thing Identifier for Device
  • pebble - JSON Encoded PebbleMessage

Example (Send Restart command to Thing):

Data/DoSendPebbleMessage?thing=XXX&pebble={"rebootRequest": {}}

Endpoint: Data/DoSendPebbleMessage

CDM Message (RockREMOTE Mini) to Group​

  • thingGroup - Cloudloop Thing Group Identifier
  • pebble - JSON Encoded PebbleMessage

Example (Send Restart command to Thing Group):

Data/DoSendPebbleMessageForThingGroup?thingGroup=XXX&pebble={"rebootRequest": {}}

Endpoint: Data/DoSendPebbleMessageForThingGroup

Edge Solar Message (Iridium Edge Solar)​

As defined by the IES Protocol use the following endpoint to send Messages to Iridium Edge Solar devices.

  • thing - Cloudloop Thing Identifier for Device
  • ies - JSON Encoded IridiumEdgeSolarMessage

Example (Send location command to Thing):

Data/DoSendEdgeSolarMessage?thing=XXX&ies={"sendLocation": {}}

Endpoint: Data/DoSendEdgeSolarMessage

Edge Solar Message to Group​

  • thingGroup - Cloudloop Thing Group Identifier
  • ies - JSON Encoded IridiumEdgeSolarMessage

Example (Send location command to Thing Group):

Data/DoSendEdgeSolarMessageForThingGroup?thingGroup=XXX&ies={"sendLocation": {}}

Endpoint: Data/DoSendEdgeSolarMessageForThingGroup