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.

Configuration

Integration — required. The integration to which downlink messages will be pushed. Selected by UUID from the list of configured integrations in your ThingsBoard instance.

Message processing algorithm

Push the entire incoming message to the configured integration for downlink processing.
If the submission succeeds, forward the original message via Success.
If the integration does not exist, is disabled, or submission fails, route via Failure.

Output connections

Connection	Condition
`Success`	Message successfully submitted to the integration. Outgoing message is unchanged.
`Failure`	Integration not found, integration disabled, submission error, or unexpected error.

Examples

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.

JSON schema

{
  "$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."
    }
  }
}