feat(slack): new Slack notification/ChatOps integration

Slack Web API, 8 commands: send message (text/Block Kit), list/create channel,
invite to channel, set topic, get user, add reaction. Bot-token auth, stdlib-only.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

integrations/slack/scripts/add_reaction.py

@@ -0,0 +1,57 @@
+import json, os, sys, urllib.parse, urllib.request, urllib.error
+
+BASE = "https://slack.com/api"
+
+
+def _cfg():
+    return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
+
+
+def _inputs():
+    return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+
+
+def call(method_name, cfg, body=None, params=None, http="POST"):
+    url = BASE + "/" + method_name
+    if params:
+        url += "?" + urllib.parse.urlencode({k: v for k, v in params.items() if v not in (None, "")})
+    data = json.dumps(body).encode("utf-8") if body is not None else None
+    headers = {"Authorization": "Bearer " + str(cfg.get("bot_token", "")), "Accept": "application/json"}
+    if data is not None:
+        headers["Content-Type"] = "application/json; charset=utf-8"
+    req = urllib.request.Request(url, data=data, headers=headers, method=http)
+    with urllib.request.urlopen(req, timeout=60) as r:
+        resp = json.loads(r.read() or "{}")
+    if not resp.get("ok"):
+        raise Exception("Slack error: " + str(resp.get("error") or resp))
+    return resp
+
+
+def _run(fn):
+    try:
+        print(json.dumps(fn(_cfg(), _inputs())))
+    except urllib.error.HTTPError as e:
+        print(json.dumps({"error": "HTTP " + str(e.code), "detail": e.read().decode("utf-8", "replace")}))
+        sys.exit(1)
+    except Exception as e:
+        print(json.dumps({"error": str(e)}))
+        sys.exit(1)
+
+
+def main(cfg, inputs):
+    channel = str(inputs.get("channel") or "").strip()
+    if not channel:
+        raise Exception("channel is required")
+
+    timestamp = str(inputs.get("timestamp") or "").strip()
+    if not timestamp:
+        raise Exception("timestamp is required")
+
+    emoji = str(inputs.get("emoji") or "").strip()
+    if not emoji:
+        raise Exception("emoji is required")
+
+    return call("reactions.add", cfg, body={"channel": channel, "timestamp": timestamp, "name": emoji})
+
+
+_run(main)

integrations/slack/scripts/create_channel.py

@@ -0,0 +1,51 @@
+import json, os, sys, urllib.parse, urllib.request, urllib.error
+
+BASE = "https://slack.com/api"
+
+
+def _cfg():
+    return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
+
+
+def _inputs():
+    return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+
+
+def call(method_name, cfg, body=None, params=None, http="POST"):
+    url = BASE + "/" + method_name
+    if params:
+        url += "?" + urllib.parse.urlencode({k: v for k, v in params.items() if v not in (None, "")})
+    data = json.dumps(body).encode("utf-8") if body is not None else None
+    headers = {"Authorization": "Bearer " + str(cfg.get("bot_token", "")), "Accept": "application/json"}
+    if data is not None:
+        headers["Content-Type"] = "application/json; charset=utf-8"
+    req = urllib.request.Request(url, data=data, headers=headers, method=http)
+    with urllib.request.urlopen(req, timeout=60) as r:
+        resp = json.loads(r.read() or "{}")
+    if not resp.get("ok"):
+        raise Exception("Slack error: " + str(resp.get("error") or resp))
+    return resp
+
+
+def _run(fn):
+    try:
+        print(json.dumps(fn(_cfg(), _inputs())))
+    except urllib.error.HTTPError as e:
+        print(json.dumps({"error": "HTTP " + str(e.code), "detail": e.read().decode("utf-8", "replace")}))
+        sys.exit(1)
+    except Exception as e:
+        print(json.dumps({"error": str(e)}))
+        sys.exit(1)
+
+
+def main(cfg, inputs):
+    name = str(inputs.get("name") or "").strip()
+    if not name:
+        raise Exception("name is required")
+
+    is_private = bool(inputs.get("is_private") or False)
+
+    return call("conversations.create", cfg, body={"name": name, "is_private": is_private})
+
+
+_run(main)

integrations/slack/scripts/get_user.py

@@ -0,0 +1,53 @@
+import json, os, sys, urllib.parse, urllib.request, urllib.error
+
+BASE = "https://slack.com/api"
+
+
+def _cfg():
+    return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
+
+
+def _inputs():
+    return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+
+
+def call(method_name, cfg, body=None, params=None, http="POST"):
+    url = BASE + "/" + method_name
+    if params:
+        url += "?" + urllib.parse.urlencode({k: v for k, v in params.items() if v not in (None, "")})
+    data = json.dumps(body).encode("utf-8") if body is not None else None
+    headers = {"Authorization": "Bearer " + str(cfg.get("bot_token", "")), "Accept": "application/json"}
+    if data is not None:
+        headers["Content-Type"] = "application/json; charset=utf-8"
+    req = urllib.request.Request(url, data=data, headers=headers, method=http)
+    with urllib.request.urlopen(req, timeout=60) as r:
+        resp = json.loads(r.read() or "{}")
+    if not resp.get("ok"):
+        raise Exception("Slack error: " + str(resp.get("error") or resp))
+    return resp
+
+
+def _run(fn):
+    try:
+        print(json.dumps(fn(_cfg(), _inputs())))
+    except urllib.error.HTTPError as e:
+        print(json.dumps({"error": "HTTP " + str(e.code), "detail": e.read().decode("utf-8", "replace")}))
+        sys.exit(1)
+    except Exception as e:
+        print(json.dumps({"error": str(e)}))
+        sys.exit(1)
+
+
+def main(cfg, inputs):
+    user_id = str(inputs.get("user_id") or "").strip()
+    email = str(inputs.get("email") or "").strip()
+
+    if email:
+        return call("users.lookupByEmail", cfg, params={"email": email}, http="GET")
+    elif user_id:
+        return call("users.info", cfg, params={"user": user_id}, http="GET")
+    else:
+        raise Exception("user_id or email is required")
+
+
+_run(main)

integrations/slack/scripts/invite_to_channel.py

@@ -0,0 +1,54 @@
+import json, os, sys, urllib.parse, urllib.request, urllib.error
+
+BASE = "https://slack.com/api"
+
+
+def _cfg():
+    return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
+
+
+def _inputs():
+    return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+
+
+def call(method_name, cfg, body=None, params=None, http="POST"):
+    url = BASE + "/" + method_name
+    if params:
+        url += "?" + urllib.parse.urlencode({k: v for k, v in params.items() if v not in (None, "")})
+    data = json.dumps(body).encode("utf-8") if body is not None else None
+    headers = {"Authorization": "Bearer " + str(cfg.get("bot_token", "")), "Accept": "application/json"}
+    if data is not None:
+        headers["Content-Type"] = "application/json; charset=utf-8"
+    req = urllib.request.Request(url, data=data, headers=headers, method=http)
+    with urllib.request.urlopen(req, timeout=60) as r:
+        resp = json.loads(r.read() or "{}")
+    if not resp.get("ok"):
+        raise Exception("Slack error: " + str(resp.get("error") or resp))
+    return resp
+
+
+def _run(fn):
+    try:
+        print(json.dumps(fn(_cfg(), _inputs())))
+    except urllib.error.HTTPError as e:
+        print(json.dumps({"error": "HTTP " + str(e.code), "detail": e.read().decode("utf-8", "replace")}))
+        sys.exit(1)
+    except Exception as e:
+        print(json.dumps({"error": str(e)}))
+        sys.exit(1)
+
+
+def main(cfg, inputs):
+    channel = str(inputs.get("channel") or "").strip()
+    if not channel:
+        raise Exception("channel is required")
+
+    users_raw = inputs.get("users")
+    users_list = [s.strip() for s in str(users_raw or "").split(",") if s.strip()]
+    if not users_list:
+        raise Exception("users is required")
+
+    return call("conversations.invite", cfg, body={"channel": channel, "users": ",".join(users_list)})
+
+
+_run(main)

integrations/slack/scripts/list_channels.py

@@ -0,0 +1,48 @@
+import json, os, sys, urllib.parse, urllib.request, urllib.error
+
+BASE = "https://slack.com/api"
+
+
+def _cfg():
+    return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
+
+
+def _inputs():
+    return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+
+
+def call(method_name, cfg, body=None, params=None, http="POST"):
+    url = BASE + "/" + method_name
+    if params:
+        url += "?" + urllib.parse.urlencode({k: v for k, v in params.items() if v not in (None, "")})
+    data = json.dumps(body).encode("utf-8") if body is not None else None
+    headers = {"Authorization": "Bearer " + str(cfg.get("bot_token", "")), "Accept": "application/json"}
+    if data is not None:
+        headers["Content-Type"] = "application/json; charset=utf-8"
+    req = urllib.request.Request(url, data=data, headers=headers, method=http)
+    with urllib.request.urlopen(req, timeout=60) as r:
+        resp = json.loads(r.read() or "{}")
+    if not resp.get("ok"):
+        raise Exception("Slack error: " + str(resp.get("error") or resp))
+    return resp
+
+
+def _run(fn):
+    try:
+        print(json.dumps(fn(_cfg(), _inputs())))
+    except urllib.error.HTTPError as e:
+        print(json.dumps({"error": "HTTP " + str(e.code), "detail": e.read().decode("utf-8", "replace")}))
+        sys.exit(1)
+    except Exception as e:
+        print(json.dumps({"error": str(e)}))
+        sys.exit(1)
+
+
+def main(cfg, inputs):
+    types = str(inputs.get("types") or "public_channel,private_channel").strip()
+    limit = inputs.get("limit") or 200
+
+    return call("conversations.list", cfg, params={"types": types, "limit": int(limit)}, http="GET")
+
+
+_run(main)

integrations/slack/scripts/send_message.py

@@ -0,0 +1,67 @@
+import json, os, sys, urllib.parse, urllib.request, urllib.error
+
+BASE = "https://slack.com/api"
+
+
+def _cfg():
+    return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
+
+
+def _inputs():
+    return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+
+
+def call(method_name, cfg, body=None, params=None, http="POST"):
+    url = BASE + "/" + method_name
+    if params:
+        url += "?" + urllib.parse.urlencode({k: v for k, v in params.items() if v not in (None, "")})
+    data = json.dumps(body).encode("utf-8") if body is not None else None
+    headers = {"Authorization": "Bearer " + str(cfg.get("bot_token", "")), "Accept": "application/json"}
+    if data is not None:
+        headers["Content-Type"] = "application/json; charset=utf-8"
+    req = urllib.request.Request(url, data=data, headers=headers, method=http)
+    with urllib.request.urlopen(req, timeout=60) as r:
+        resp = json.loads(r.read() or "{}")
+    if not resp.get("ok"):
+        raise Exception("Slack error: " + str(resp.get("error") or resp))
+    return resp
+
+
+def _run(fn):
+    try:
+        print(json.dumps(fn(_cfg(), _inputs())))
+    except urllib.error.HTTPError as e:
+        print(json.dumps({"error": "HTTP " + str(e.code), "detail": e.read().decode("utf-8", "replace")}))
+        sys.exit(1)
+    except Exception as e:
+        print(json.dumps({"error": str(e)}))
+        sys.exit(1)
+
+
+def main(cfg, inputs):
+    channel = str(inputs.get("channel") or "").strip()
+    if not channel:
+        raise Exception("channel is required")
+
+    text = str(inputs.get("text") or "").strip()
+    blocks_raw = str(inputs.get("blocks") or "").strip()
+    thread_ts = str(inputs.get("thread_ts") or "").strip()
+
+    if not text and not blocks_raw:
+        raise Exception("text or blocks is required")
+
+    body = {"channel": channel}
+    if text:
+        body["text"] = text
+    if blocks_raw:
+        try:
+            body["blocks"] = json.loads(blocks_raw)
+        except Exception:
+            raise Exception("blocks must be a valid JSON array")
+    if thread_ts:
+        body["thread_ts"] = thread_ts
+
+    return call("chat.postMessage", cfg, body=body)
+
+
+_run(main)

integrations/slack/scripts/set_channel_topic.py

@@ -0,0 +1,53 @@
+import json, os, sys, urllib.parse, urllib.request, urllib.error
+
+BASE = "https://slack.com/api"
+
+
+def _cfg():
+    return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
+
+
+def _inputs():
+    return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+
+
+def call(method_name, cfg, body=None, params=None, http="POST"):
+    url = BASE + "/" + method_name
+    if params:
+        url += "?" + urllib.parse.urlencode({k: v for k, v in params.items() if v not in (None, "")})
+    data = json.dumps(body).encode("utf-8") if body is not None else None
+    headers = {"Authorization": "Bearer " + str(cfg.get("bot_token", "")), "Accept": "application/json"}
+    if data is not None:
+        headers["Content-Type"] = "application/json; charset=utf-8"
+    req = urllib.request.Request(url, data=data, headers=headers, method=http)
+    with urllib.request.urlopen(req, timeout=60) as r:
+        resp = json.loads(r.read() or "{}")
+    if not resp.get("ok"):
+        raise Exception("Slack error: " + str(resp.get("error") or resp))
+    return resp
+
+
+def _run(fn):
+    try:
+        print(json.dumps(fn(_cfg(), _inputs())))
+    except urllib.error.HTTPError as e:
+        print(json.dumps({"error": "HTTP " + str(e.code), "detail": e.read().decode("utf-8", "replace")}))
+        sys.exit(1)
+    except Exception as e:
+        print(json.dumps({"error": str(e)}))
+        sys.exit(1)
+
+
+def main(cfg, inputs):
+    channel = str(inputs.get("channel") or "").strip()
+    if not channel:
+        raise Exception("channel is required")
+
+    topic = str(inputs.get("topic") or "").strip()
+    if not topic:
+        raise Exception("topic is required")
+
+    return call("conversations.setTopic", cfg, body={"channel": channel, "topic": topic})
+
+
+_run(main)

integrations/slack/scripts/test_connection.py

@@ -0,0 +1,46 @@
+import json, os, sys, urllib.parse, urllib.request, urllib.error
+
+BASE = "https://slack.com/api"
+
+
+def _cfg():
+    return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
+
+
+def _inputs():
+    return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+
+
+def call(method_name, cfg, body=None, params=None, http="POST"):
+    url = BASE + "/" + method_name
+    if params:
+        url += "?" + urllib.parse.urlencode({k: v for k, v in params.items() if v not in (None, "")})
+    data = json.dumps(body).encode("utf-8") if body is not None else None
+    headers = {"Authorization": "Bearer " + str(cfg.get("bot_token", "")), "Accept": "application/json"}
+    if data is not None:
+        headers["Content-Type"] = "application/json; charset=utf-8"
+    req = urllib.request.Request(url, data=data, headers=headers, method=http)
+    with urllib.request.urlopen(req, timeout=60) as r:
+        resp = json.loads(r.read() or "{}")
+    if not resp.get("ok"):
+        raise Exception("Slack error: " + str(resp.get("error") or resp))
+    return resp
+
+
+def _run(fn):
+    try:
+        print(json.dumps(fn(_cfg(), _inputs())))
+    except urllib.error.HTTPError as e:
+        print(json.dumps({"error": "HTTP " + str(e.code), "detail": e.read().decode("utf-8", "replace")}))
+        sys.exit(1)
+    except Exception as e:
+        print(json.dumps({"error": str(e)}))
+        sys.exit(1)
+
+
+def main(cfg, inputs):
+    resp = call("auth.test", cfg)
+    return {"ok": True, "team": resp.get("team"), "user": resp.get("user")}
+
+
+_run(main)