slack-messaging

Slack Messaging

Purpose

Send and read Slack messages programmatically via the Slack Web API. Two deterministic shell scripts backed by a shared helper library:

• send.sh — post a message to a channel via chat.postMessage
• read.sh — fetch recent messages from a channel via conversations.history and emit them as stable JSON

Credentials are read exclusively from the SLACK_BOT_TOKEN environment variable. The token is never written to a file, never appears in script output or logs, and is never committed to the repository.

---

Constraints

• Token only from env var SLACK_BOT_TOKEN. Never from a file, never echoed.
• TLS is never disabled — no curl -k, no --insecure, no verify=false.
• No silent download-and-execute (curl … | sh).
• Errors on network/security operations are always surfaced — no 2>/dev/null on calls whose result matters, no empty catch.
• set -euo pipefail in every script.
• Exit-code contract: 0 success; 1 usage/argument error; 2 missing tool (curl/jq) or missing SLACK_BOT_TOKEN; 3 API failure (HTTP non-2xx, network error, or Slack ok:false).

---

Setup — co a kam vložit

1. Vytvoř Slack App

1. Přejdi na https://api.slack.com/apps a klikni Create New App → From scratch.

2. Vyber workspace a pojmenuj appku (např. messaging-bot).

3. V sekci OAuth & Permissions → Bot Token Scopes přidej scopy:

   Scope	Použití
   chat:write	odesílání zpráv (send.sh)
   channels:history	čtení zpráv z veřejných kanálů (read.sh)
   channels:read	přístup k metadatům veřejných kanálů
   groups:history	čtení zpráv z privátních kanálů (read.sh)

4. Klikni Install to Workspace a potvrď oprávnění.

5. Zkopíruj Bot User OAuth Token (začíná xoxb-…) z OAuth & Permissions.

2. Bezpečné nastavení tokenu

Nastav token jako env var — NIKDY ho necommituj do repa, NIKDY ho nevkládej do .env souboru sledovaného Gitem:

# shell profil (mimo repo) — ~/.zshrc nebo ~/.bash_profile
export SLACK_BOT_TOKEN=xoxb-...

# CI secret (GitHub Actions):
# Settings → Secrets → New repository secret → Name: SLACK_BOT_TOKEN
# V workflow: env: SLACK_BOT_TOKEN: ${{ secrets.SLACK_BOT_TOKEN }}