chatz

Chatz is an open-source application designed to send messages to popular communication platforms like Google Chat, Slack, Discord and Telegram etc. Whether you're monitoring server health, tracking job completions, or needing a quick notification tool, Chatz offers a unified way to communicate with your teams and devices, such as:

• Event Notifications: Automatically notify users of events occurring in background jobs, system processes, or application workflows.
• Alerts: Integrate with script to alert teams of system status changes, errors, or other critical updates.
• CI/CD Pipeline: Receive notifications when build status changes, pipeline status changes, and other events occur in the CI/CD pipeline. Visit: Chatz Action to add to your github workflow.

With chatz, you can streamline your notification processes across multiple platforms, making it an essential tool for developers, system administrators, and teams that need reliable communication for automated tasks.

Supported Providers

• Slack: Read documentation
• Google Chat: Read documentation
• Telegram: Read documentation
• Discord: Read documentation
• Redis: Read documentation

Installation

Download and install executable binary from GitHub releases page.

Using homebrew

brew tap tech-thinker/tap
brew update
brew install chatz

Linux Installation

curl -sL https://github.com/tech-thinker/chatz/releases/download/v1.1.3/chatz-linux-amd64 -o chatz
chmod +x chatz
sudo mv chatz /usr/bin

MacOS Installation

curl -sL https://github.com/tech-thinker/chatz/releases/download/v1.1.3/chatz-darwin-amd64 -o chatz
chmod +x chatz
sudo mv chatz /usr/bin

Windows Installation

curl -sL https://github.com/tech-thinker/chatz/releases/download/v1.1.3/chatz-windows-amd64.exe -o chatz.exe
chatz.exe

Setup

• Create config file at home directory. .chatz.ini

[default]
PROVIDER=slack
TOKEN=<token>
CHANNEL_ID=<one-channel-id>

[another]
PROVIDER=slack
TOKEN=<token>
CHANNEL_ID=<another-channel-id>

• Config for slack provider

[default]
PROVIDER=slack
TOKEN=<token>
CHANNEL_ID=<channel-id>

• Config for google provider

[default]
PROVIDER=google
WEB_HOOK_URL=<webhook-url>

• Config for telegram provider

[default]
PROVIDER=telegram
TOKEN=<bot-token>
CHAT_ID=<chat-id>

• Config for discord provider

[default]
PROVIDER=discord
WEB_HOOK_URL=<webhook-url>

• Config for redis provider

[default]
PROVIDER=redis
CONNECTION_URL=<redis-connection-url>
CHANNEL_ID=<redis-publish-channel>

System Environment Support

Chatz also support system environment variable. To use system environment variable then use --from-env or -e flag. Name of the environment variable is same as chatz.ini config key, for example export PROVIDER=slack.

chatz -e "Test"
# Or
chatz --from-env "Test"

Usage

• Send message using default profile

chatz "hello"

• Reply message using default profile

chatz -t="<thread-id>" "Hello"

• Send message using another profile

chatz --profile=another "hello"

• Reply message using another profile

chatz --profile=another -t="<thread-id>" "Hello"

• See output

chatz -o "Hi"

• See help

chatz --help