Skip to main content

Rocket.Chat

The rocketchat trigger posts container update messages to Rocket.Chat channels via incoming webhooks.

⚙️ Configuration Variables​

WUD_TRIGGER_ROCKETCHAT_{trigger_name}_AUTH_TOKEN
Requiredstring

Personal Access Token (PAT) of the sending account

WUD_TRIGGER_ROCKETCHAT_{trigger_name}_CHANNEL
Requiredstring

Destination channel or user

Allowed values:Channel ID (`6561ce603d237c33797650d7`), channel name (`#example`), or username (`@example`)
WUD_TRIGGER_ROCKETCHAT_{trigger_name}_URL
Requiredurl

Rocket.Chat workspace URL (e.g. https://chat.example.com)

Allowed values:Valid HTTP/HTTPS URL
WUD_TRIGGER_ROCKETCHAT_{trigger_name}_USER_ID
Requiredstring

User ID of the sending account

WUD_TRIGGER_ROCKETCHAT_{trigger_name}_ALIAS
Optionalstring

Custom sender display name (requires message-impersonate permission on the bot account)

WUD_TRIGGER_ROCKETCHAT_{trigger_name}_AVATAR
Optionalurl

Custom sender avatar image URL

Allowed values:Valid HTTP/HTTPS image URL
WUD_TRIGGER_ROCKETCHAT_{trigger_name}_DISABLETITLE
Optionalbooleandefault: false

Disable the default title heading to allow full custom message formatting

WUD_TRIGGER_ROCKETCHAT_{trigger_name}_EMOJI
Optionalstring

Custom sender avatar emoji

Allowed values:Emoji shortcode (e.g. `:whale:`)
WUD_TRIGGER_ROCKETCHAT_{trigger_name}_PARSE_URLS
Optionalbooleandefault: true

Generate link previews when message contains URLs

Channel Pre-creation Required

The destination channel must already exist on your Rocket.Chat workspace; WUD will not create missing channels automatically.

info

This trigger also supports all common trigger configuration options (such as thresholds, scheduling, and batching).

🚀 Examples​

Post to a Public Channel​

services:
  whatsupdocker:
    image: getwud/wud
    environment:
      - WUD_TRIGGER_ROCKETCHAT_LOCAL_URL=https://chat.example.com
      - WUD_TRIGGER_ROCKETCHAT_LOCAL_USER_ID=myUserId123
      - WUD_TRIGGER_ROCKETCHAT_LOCAL_AUTH_TOKEN=mySecretPatToken
      - WUD_TRIGGER_ROCKETCHAT_LOCAL_CHANNEL=#devops-alerts

📖 Setup Guide: Generating a Personal Access Token​

  1. Log in to Rocket.Chat and click your avatar (top left) > My Account.
  2. Select Personal Access Tokens.
  3. Enter a token name (e.g. WUD) and click Add.
  4. Copy the generated User ID and Token values into your WUD configuration.