Skip to content
Try for free

ThingsBoard Cloud

Choose your data region

Your data stays in the region you choose, for residency and compliance. No credit card required.

Rather run it yourself? Install on your own servers

Integration Downlink

Use this node to push a message as a downlink to a configured integration — for example, forwarding a command from the rule chain to an external MQTT broker or HTTP endpoint managed by a ThingsBoard integration, or relaying device RPC responses to an IoT platform via an integration connector.

  • Integration — required. The integration to which downlink messages will be pushed. Selected by UUID from the list of configured integrations in your ThingsBoard instance.
  1. Push the entire incoming message to the configured integration for downlink processing.
  2. If the submission succeeds, forward the original message via Success.
  3. If the integration does not exist, is disabled, or submission fails, route via Failure.
Connection Condition
Success Message successfully submitted to the integration. Outgoing message is unchanged.
Failure Integration not found, integration disabled, submission error, or unexpected error.

Example 1 — Forward telemetry to external MQTT broker

Section titled “Example 1 — Forward telemetry to external MQTT broker”

Incoming message — originator: DEVICE.

Data:

{
"voltage": 230.5,
"current": 12.3,
"power": 2835.15
}
{
"integrationId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d"
}

Result: telemetry submitted to an MQTT integration; the integration publishes to the configured external broker topic. Routes via Success.

{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"title": "TbIntegrationDownlinkConfiguration",
"type": "object",
"required": ["integrationId"],
"additionalProperties": false,
"properties": {
"integrationId": {
"type": "string",
"format": "uuid",
"description": "UUID of the integration to push downlink messages to."
}
}
}