ボットトークン (xoxb-) ではなくユーザトークン (xoxp-) を取得する方法を紹介します
ただし無料プランだと管理者権限のあるユーザトークンは設定できないので注意してください
あとはトークンを使うだけ
前回続きです
ban になったら slack に通知するようにしてみました
ユーザの権限部分など少し変更しています
作成したアクションの設定ファイルもマウントするようにしています
services:
nginx:
image: nginx:latest
container_name: nginx
network_mode: host
volumes:
- ./nginx/log:/var/log/nginx # このログをfail2banで監視
restart: unless-stopped
fail2ban:
image: linuxserver/fail2ban:latest
container_name: fail2ban
network_mode: host
cap_add:
- NET_ADMIN # BANに必須
- NET_RAW # BANに必須
volumes:
- ./config/jail.local:/config/fail2ban/jail.d/jail.local
- ./config/filter.d/nginx-404.conf:/config/fail2ban/filter.d/nginx-404.conf
- ./config/action.d/slack.conf:/config/fail2ban/action.d/slack.conf
- ./nginx/log:/remotelogs/nginx:ro # nginxログを読み取り専用で監視
environment:
- PUID=1000 # 自身のユーザIDとグループIDに合わせて変更 (config/ 配下の権限がコンテナ側のユーザIDで変更されてしまうため編集ができなくなる)
- PGID=122
- TZ=Asia/Tokyo
- VERBOSITY=-vv
restart: unless-stopped
nginx-404 サービスの action に slack を追加します
[DEFAULT]
# "bantime.increment" allows to use database for searching of previously banned ip's to increase a
# default ban time
bantime.increment = true
# "bantime.maxtime" is the max number of seconds using the ban time can reach (doesn't grow further)
bantime.maxtime = 5w
# "bantime.factor" is a coefficient to calculate exponent growing of the formula or common multiplier
bantime.factor = 24
# "bantime" is the number of seconds that a host is banned.
bantime = 1h
# A host is banned if it has generated "maxretry" during the last "findtime"
# seconds.
findtime = 24h
# "maxretry" is the number of failures before a host get banned.
maxretry = 5
# Prevents banning LAN subnets
ignoreip = 127.0.0.1/8 ::1
10.0.0.0/8
172.16.0.0/12
192.168.0.0/16
# The ban action "iptables-multiport" (default) should work for most
# The ban action "iptables-allports" can be used if multiport causes issues
banaction = iptables-multiport
banaction_allports = iptables-allports
# Read https://github.com/sebres/PoC/blob/master/FW.IDS-DROP-vs-REJECT/README.md before changing block type
# The block type "REJECT --reject-with icmp-port-unreachable" (default behavior) should respond to, but then instantly reject connection attempts
# The block type "DROP" should not respond to connection attempts, resulting in a timeout
#banaction = iptables-multiport[blocktype=DROP]
# Add additional actions
action = %(action_)s
# [sshd]
# configuration inherits from jail.conf
# enabled = true
# chain = INPUT
# action = %(action_)s
[nginx-http-auth]
# configuration inherits from jail.conf
enabled = true
chain = DOCKER-USER
action = %(action_)s
[nginx-badbots]
# configuration inherits from jail.d/nginx-badbots.conf
enabled = true
chain = DOCKER-USER
action = %(action_)s
[nginx-botsearch]
# configuration inherits from jail.conf
enabled = true
chain = DOCKER-USER
action = %(action_)s
[nginx-deny]
# configuration inherits from jail.d/nginx-deny.conf
enabled = true
chain = DOCKER-USER
action = %(action_)s
[nginx-unauthorized]
# configuration inherits from jail.d/nginx-unauthorized.conf
enabled = true
chain = DOCKER-USER
action = %(action_)s
[nginx-404]
# Custom filter to detect excessive 404 errors
enabled = true
chain = INPUT
port = http,https
filter = nginx-404
logpath = /remotelogs/nginx/access.log
maxretry = 3
findtime = 10s
bantime = 1h
action = %(action_)s
slack
前回と同じです
各種アクション時に通知するようにします
webhook_url は変更してください
# Fail2Ban configuration file
#
# Action to send notifications to Slack
#
[Definition]
# Option: actionstart
# Notes.: command executed once at the start of Fail2Ban.
actionstart = curl -X POST -H 'Content-type: application/json' \
--data '{"text":"[Fail2Ban] <name> jail has started"}' \
<slack_webhook_url>
# Option: actionstop
# Notes.: command executed once at the end of Fail2Ban
actionstop = curl -X POST -H 'Content-type: application/json' \
--data '{"text":"[Fail2Ban] <name> jail has stopped"}' \
<slack_webhook_url>
# Option: actioncheck
# Notes.: command executed once before each actionban command
actioncheck =
# Option: actionban
# Notes.: command executed when banning an IP. Take care that the
# command is executed with Fail2Ban user rights.
actionban = curl -X POST -H 'Content-type: application/json' \
--data '{"text":"[Fail2Ban] :no_entry: <name> jail banned IP: *<ip>*\nFailures: <failures>\nTime: <time>"}' \
<slack_webhook_url>
# Option: actionunban
# Notes.: command executed when unbanning an IP. Take care that the
# command is executed with Fail2Ban user rights.
actionunban = curl -X POST -H 'Content-type: application/json' \
--data '{"text":"[Fail2Ban] :white_check_mark: <name> jail unbanned IP: *<ip>*"}' \
<slack_webhook_url>
[Init]
# Slack webhook URL
slack_webhook_url = https://hooks.slack.com/services/xxx/xxx/xxx
あとは localhost/test などで 404 を発生させると通知が来ます
unbanip で ban 解除しても通知が来ます
起動時にちゃんと追加したアクションが読み込まれていることを確認しましょう
ここで読み込まれていないとうまく動作しません
fail2ban | 2025-12-12 10:00:26,132 79986F9C2B28 INFO Loading configs for action.d/iptables-multiport under /etc/fail2ban
fail2ban | 2025-12-12 10:00:26,133 79986F9C2B28 DEBUG Reading configs for action.d/iptables-multiport under /etc/fail2ban
fail2ban | 2025-12-12 10:00:26,133 79986F9C2B28 DEBUG Reading config files: /etc/fail2ban/action.d/iptables-multiport.conf
fail2ban | 2025-12-12 10:00:26,133 79986F9C2B28 INFO Loading files: ['/etc/fail2ban/action.d/iptables-multiport.conf']
fail2ban | 2025-12-12 10:00:26,133 79986F9C2B28 INFO Loading files: ['/etc/fail2ban/action.d/iptables.conf']
fail2ban | 2025-12-12 10:00:26,134 79986F9C2B28 INFO Loading files: ['/etc/fail2ban/action.d/iptables.conf', '/etc/fail2ban/action.d/iptables-multiport.conf']
fail2ban | 2025-12-12 10:00:26,147 79986F9C2B28 INFO Loading configs for action.d/slack under /etc/fail2ban
fail2ban | 2025-12-12 10:00:26,147 79986F9C2B28 DEBUG Reading configs for action.d/slack under /etc/fail2ban
fail2ban | 2025-12-12 10:00:26,147 79986F9C2B28 DEBUG Reading config files: /etc/fail2ban/action.d/slack.conf
fail2ban | 2025-12-12 10:00:26,147 79986F9C2B28 INFO Loading files: ['/etc/fail2ban/action.d/slack.conf']
fail2ban | 2025-12-12 10:00:26,147 79986F9C2B28 INFO Loading files: ['/etc/fail2ban/action.d/slack.conf']
ban になったかどうかをいちいち確認する必要がなくなるので便利です
現在の ban 状況を定期的に送信してくれる機能があると更に便利かなと思います
かなり昔に使い方を紹介したのですがその際はリアルタイムメッセージAPIの使い方を紹介しました
今回はファイルを添付したメッセージの送信方法を紹介します
# frozen_string_literal: true
require 'slack-ruby-client'
# MySlack クラスは Slack へのメッセージ送信とファイルアップロードを行います。
class MySlack
USER_ID = 'U1234567890' # ユーザーIDを定義
TOKEN = 'xoxb-xxx-xxx-xxx' # Slack API トークンを定義
def initialize
# Slack クライアントの初期化
Slack.configure do |config|
config.token = TOKEN
end
@client = Slack::Web::Client.new
end
def channel_id_for_sending_file
# ボットと指定のユーザーとの会話を開始し、チャンネルIDを取得
response = @client.conversations_open(users: USER_ID)
response.channel.id
end
def send_message(message_text, channel_id)
# メッセージを送信
@client.chat_postMessage(
channel: channel_id,
text: message_text
)
end
def upload_file(file_path, message_text, channel_id)
# ファイルをアップロード
@client.files_upload_v2(
filename: File.basename(file_path),
content: File.read(file_path),
channels: [channel_id],
initial_comment: message_text,
snippet_type: 'text',
title: '添付されたテキストファイル'
)
end
end
Slack のファイルアップロード API は v1 から v2 になり大きく変更されています
チャネル名が指定不可になった他ボットからファイルを送信するためにはチャネルにボットが参加しているなどの条件があります
一番確実な方法として特定のユーザとの会話チャネルに送信する方法があるので今回はその方法を採用しています (参考)
invalid_arguments (Slack::Web::Api::Errors::InvalidArguments)
ファイルが空の場合に発生します
どうやら空ファイルは送信できないようです
slack-ruby-client で file uplaod API v2 を使ってファイルのアップロードを行ってみました
v2 からかなり厳格なチェックが入っておりかつ v1 との互換性はないので注意が必要です
Github Actions から Slack に通知する方法を紹介します
slackapi/slack-github-action@v1.26.0 を使います
レガシーアプリではなく最新のアプリを作成します
こちらを参考に取得しましょう
プロジェクト -> Settings -> Secrets and variables -> New repository secret
name: ci
on:
push:
branches:
- "master"
jobs:
docker:
runs-on: ubuntu-latest
steps:
- name: Slack notification
id: slack
uses: slackapi/slack-github-action@v1.26.0
with:
payload: |
{
"text": "Test slack notification"
}
env:
SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL }}
payload に設定可能なキーはこちらを参照してください https://api.slack.com/surfaces/messages
一番大変なのは Webhook URL を取得する部分かもしれません
レガシーアプリではなく最新のアプリの管理 URL になります
Bot トークンや Webhook URL も新しい仕組みで作成したアプリから取得できます
古いURLからだと自分で作成したアプリの Bot トークンや Webhook URL は参照できません
chat_postMessage で thread_ts を指定します
from slack_sdk import WebClient
from slack_sdk.errors import SlackApiError
client = WebClient(token="xoxb-xxxxxx")
channel_id = "C0123456789"
try:
# 会話情報の取得、最新100件
result = client.conversations_history(channel=channel_id)
conversation_history = result["messages"]
# とりあえず最新のメッセージのスレッドに返信する
ts = result["messages"][0]["ts"]
# thread_tsを指定することでスレッド返信になる
response = client.chat_postMessage(
channel="#private",
text="Hello world!",
thread_ts=ts,
# アイコンやユーザ名をカスタムする場合は以下を設定する
username="hawksnowlog",
icon_url="https://pbs.twimg.com/profile_images/712848447569661952/ayfI9-77_400x400.jpg",
)
except SlackApiError as e:
print(e)
as_user オプションは廃止されているので使えません
代わりに username と icon_url を使いますが APP というタグは必ず付与されてしまうようで完全にユーザになり変わって投稿することはできないようです
Legacy App ではなく最近のアプリ作成方法から Incomming Webhooks URL を取得する方法を紹介します
まずはアプリを作成します
ここを参考に作成すれば OK です
アプリの設定画面の左メニューにある「Incomming Webhooks」を選択します
有効にすると再度アプリの再インストールを促されるので従います
OAuth の許可画面になるので許可しましょう
あとは少し下に表示される Incomming Webhooks URL を使用すれば OK です
curl などで行えば OK です
curl -X POST -H 'Content-type: application/json' --data '{"text":"Hello, World!"}' https://hooks.slack.com/services/T1234567890/B1234567890/xxxxxxxxxxxxxxx
Gitlab の Slack notifications Integration などを使っても良いかなと思います
Slack 最近のアプリ作成方法から Incomming Webhooks URL を取得する方法を紹介しました
結構簡単に取得はできますがアプリを再度許可する必要があるので注意しましょう
reaction_add という API を使います
ポイントはリアクションするメッセージを特定する方法が ID などではなくタイムスタンプだという点です
先に会話の情報を取得してリアクションするメッセージを決めます
今回は最新のメッセージに対してリアクションしていますが本来はメッセージの内容やメッセージの投稿者によって特定する必要があります
from slack_sdk import WebClient
from slack_sdk.errors import SlackApiError
client = WebClient(token="xoxb-xxxxxx")
channel_id = "C0123456789"
try:
# 会話情報の取得、最新100件
result = client.conversations_history(channel=channel_id)
conversation_history = result["messages"]
# とりあえず最新のメッセージにリアクションしてみる
ts = result["messages"][0]["ts"]
print(ts)
# 取得したtimestamp情報を元にthumbsupのリアクションする
response = client.reactions_add(channel=channel_id, name="thumbsup", timestamp=ts)
except SlackApiError as e:
print(e)
以下のようにリアクションが追加になれば OK です
また同じメッセージに対して同じリアクションをしようとすると
The request to the Slack API failed. (url: https://www.slack.com/api/reactions.add)
The server responded with: {'ok': False, 'error': 'already_reacted'}
というエラーになるので注意しましょう
Slack Python SDK でリアクションする方法を紹介しました
絵文字に対するリアクションでボタンに対するアクションではないので注意しましょう
conversations.history で oldest と latest を指定します
oldest と latest はエポックタイム形式で指定します
最終的には文字列として API はコールします
もし指定した範囲内のメッセージが 100 件を超える場合は has_more=true が返ってくるのでページネイトする必要があります
from datetime import datetime, timedelta
from zoneinfo import ZoneInfo
from slack_sdk import WebClient
from slack_sdk.errors import SlackApiError
client = WebClient(token="xoxb-xxxxxx")
channel_id = "C0123456789"
try:
# 会話情報の取得、oldestとlatestで範囲指定、前日分の最新100件を取得する
now = datetime.now(ZoneInfo("Asia/Tokyo")).replace(
hour=0, minute=0, second=0, microsecond=0
)
oldest = now - timedelta(days=1)
latest = now - timedelta(days=0)
# print(oldest)
# print(latest)
# メッセージの一覧の取得、oldest,latestのタイムスタンプ(float)は文字列(str)に変換
result = client.conversations_history(
channel=channel_id,
oldest=str(oldest.timestamp()),
latest=str(latest.timestamp()),
inclusive=True,
)
conversation_history = result["messages"]
# メッセージの表示
for msg in conversation_history:
print(msg["text"])
print(msg["ts"])
except SlackApiError as e:
print(e)
サンプルではページネイトに関しては考慮していないので注意してください
最新100件なので古いものが含まれないケースがあります
Attachments はセカンダリメッセージ用のフォーマットで引用などに使われます
今回は Python sdk で Attachments を送信するサンプルを紹介します
トークンは Bot トークンを使います
Attachments は辞書情報として渡します
指定可能なオプションの説明はコード内のコメントに記載しています
from slack_sdk import WebClient
from slack_sdk.errors import SlackApiError
client = WebClient(token="xoxb-xxxxxxxx")
try:
response = client.chat_postMessage(
channel="#private",
text="Hello world!",
# ここからAttachmentsの定義
attachments=[
{
# Attachmentsが表示されない場合の代替テキストを指定
"fallback": "Plain-text summary of the attachment.",
# 左のバーのカラーを指定
"color": "#2eb886",
# Attachmentsの上部のタイトル情報
"pretext": "Optional text that appears above the attachment block",
# Attachmentsの投稿者の名前
"author_name": "Bobby Tables",
# Attachmentsの投稿者のリンク先URL
"author_link": "http://flickr.com/bobby/",
# Attachmentsの投稿者のアイコンのURL
"author_icon": "http://flickr.com/icons/bobby.jpg",
# Attachments内に表示するタイトル
"title": "Slack API Documentation",
# Attachments内に表示するタイトルのURL
"title_link": "https://api.slack.com/",
# Attachments内に表示する本文
"text": "Optional text that appears within the attachment",
# 優先度情報
"fields": [
{
"title": "Priority",
"value": "High",
"short": False,
}
],
# フッター情報に掲載する画像情報とサムネイル情報
"image_url": "https://picsum.photos/200/300",
# image_urlとthumb_urlは一緒に使用できない、thumb_urlは500kb以下でなければならない
# "thumb_url": "https://picsum.photos/200",
# フッター情報
"footer": "Slack API",
"footer_icon": "https://platform.slack-edge.com/img/default_application_icon.png",
# フッターに表示するタイムスタンプ情報
"ts": 1503435956.000247,
}
],
)
except SlackApiError as e:
print(e)
サンプルコードの Attachments の場合以下のような表示になります
Slack Python SDK で Attachments を送信してみました
その他にも blocks という形式でも送信できるようです
ボタンや画像、動画などを送ることができます
Python を使いました
Socket Mode は Bolt と呼ばれる SDK を使ったほうが扱いやすいので Bolt を使います
トークンは Bot トークンと App Level トークンを使います
左メニューの「Event Subscriptions」から使用するイベントを設定します
今回は特定のメッセージに反応するようにしたいので「message.channels」を追加します
from typing import Callable
from slack_bolt import App
from slack_bolt.adapter.socket_mode import SocketModeHandler
# こっちは Bot トークンを設定
app = App(token="xoxb-xxxxxxxxx")
# メッセージへの反応
# Hello に対して Hi there を返す
@app.message("Hello")
def say_hello(message: dict, say: Callable):
user = message["user"]
say(f"Hi there, <@{user}>!")
if __name__ == "__main__":
# Socket モードをスタートする
SocketModeHandler(
app,
# こっちは App Level トークンを設定
"xapp-xxxxxxxxx",
).start()
で起動しましょう
アプリはチャネルに招待しておいてください
そしてメッセージで「Hello」と送信するとアプリが反応してメッセージが返ってくることが確認できると思います
Slack の Socket Mode を試してみました
最近作成したアプリでは RTM API が使えないので Socket Mode に慣れておくと良いかなと思います
RTM に似たような感じで特定のイベントに反応して返信するという動きができます
またプレーンテキストだけではなくボタンなどを含んだインタラクティブコンポーネントを送信することもできるようです
python-slack-sdkを使ってチャネルにメッセージをポストする方法を紹介します
https://api.slack.com/tutorials/tracks/getting-a-token このあたりから作成すると良いです
アプリをワークスペースにも追加しましょう
Slack にはトークンの種類がいくつかあり今回は Bot トークンを使います
アプリの左メニューから「Install App」を選択し「Bot User OAuth Token」を使います
URL で言うと https://api.slack.com/apps/xxxxxxx/install-on-team? という形式になります
先ほど取得した Bot トークンを使用します
サンプルコードは指定したチャネルにメッセージをポストするサンプルで Github にあるサンプルスクリプトをそのまま利用します
from slack_sdk import WebClient
from slack_sdk.errors import SlackApiError
client = WebClient(token="xoxb-xxxxxxxxxxxxxxxxx")
try:
response = client.chat_postMessage(channel='#private', text="Hello world!")
assert response["message"]["text"] == "Hello world!"
except SlackApiError as e:
# You will get a SlackApiError if "ok" is False
assert e.response["ok"] is False
assert e.response["error"] # str like 'invalid_auth', 'channel_not_found'
print(f"Got an error: {e.response['error']}")
# Also receive a corresponding status_code
assert isinstance(e.response.status_code, int)
print(f"Received a response status_code: {e.response.status_code}")
ついでにチャネルに流れるメッセージを取得するスクリプトも動かしてみました
トークンは先ほど取得した Bot トークンを使用します
直近100件のメッセージを取得します
ちなみに RTM API は非推奨になっています (参考)
なので今回は conversations.history を使っています
from slack_sdk import WebClient
from slack_sdk.errors import SlackApiError
client = WebClient(token="xoxb-xxxxxxxxxxxxxxxxx")
conversation_history = []
channel_id = "C0123456789"
try:
result = client.conversations_history(channel=channel_id)
conversation_history = result["messages"]
print("{} messages found in {}".format(len(conversation_history), channel_id))
for msg in conversation_history:
print(msg["text"])
except SlackApiError as e:
print("Error creating conversation: {}".format(e))
channel_id はアプリでチャネル名を右クリックし Copy link で取得できます
またボットがチャネルに参加していないと会話は取得できないのでボットを招待してあげましょう (すでにメッセージを送信しているとチャネルに参加しているように見えますがまだいないのでちゃんと /invite してあげましょう)
Python で Slack のAPI をコールする方法を紹介しました
Slack には 3 つのトークン (User トークン、Bot トークン、アプリレベルトークン) があり今回のようにスクリプトベースの場合には Bot トークンを使います
RTM API が非推奨になり Socket API を変わりに使うようになったようなので機会があれば試してみたいです
過去に Slack + Ruby でメッセージを補足する方法を紹介しました
Incomming を使って Gitlab からの issue のコメントメッセージを補足したい場合は attachments を使います
slack.client.on :message do |data|
if data.has_key?('attachments') && data['attachments'].first['text']
puts "Message from gitlab"
end
end
slack.client.start!
前回 fluentd-plugin-slack を使って fleuntd に来たログを slack に通知する方法を紹介しました
今回は特定の文字列を含むログだけを slack に通知する方法を紹介します
grep ではなく rewrite_tag_filter プラグインを使います
FROM fluent/fluentd
RUN apk add --update --virtual .build-deps sudo build-base ruby-dev \
&& sudo gem install fluent-plugin-slack fluent-plugin-rewrite-tag-filter \
&& sudo gem sources --clear-all \
&& apk del .build-deps \
&& rm -rf /var/cache/apk/* /home/fluent/.gem/ruby/2.5.0/cache/*.gem
<source>
@type forward
port 24224
bind 0.0.0.0
</source>
<match docker.**>
@type copy
<store>
@type stdout
</store>
<store>
@type rewrite_tag_filter
<rule>
key log
pattern /notify slack/
tag slack.${tag}
</rule>
</store>
</match>
<match slack.**>
@type slack
webhook_url https://hooks.slack.com/services/xxx/xxx/xxxxxx
channel private
username test
message_keys log
icon_emoji :ghost:
flush_interval 60s
</match>
今回は log キー内に「notify slack」という文字列を含むログだけを slack に通知します
filter プラグインの grep を使ってもできると思います
fluentd-plugin-slack は fluentd に来たログを slack に投げることができます
今回は docker で試してみました
FROM fluent/fluentd
RUN apk add --update --virtual .build-deps sudo build-base ruby-dev \
&& sudo gem install fluent-plugin-slack \
&& sudo gem sources --clear-all \
&& apk del .build-deps \
&& rm -rf /var/cache/apk/* /home/fluent/.gem/ruby/2.5.0/cache/*.gem
<source>
@type forward
port 24224
bind 0.0.0.0
</source>
<match docker.**>
@type copy
<store>
@type stdout
</store>
<store>
@type slack
webhook_url https://hooks.slack.com/services/xxx/xxx/xxxxxx
channel private
username test
message_keys log
icon_emoji :ghost:
flush_interval 60s
</store>
</match>
message_keys で fluentd に流れてきた JSON ログのキーを指定することでその値を Slack のメッセージとして流すことができます
今回は flush_interval 60s なので 1 分ごとにまとめて通知されます
grep プラグインと組み合わせます
こちらは次回紹介します
Slack の general チャネルにあるメッセージをすべて削除する方法を紹介します
今回紹介する方法は slack-cleaner というツールを使います
pip3 install slack-cleanerslack-cleaner コマンドが実行できない場合は再ログインするか新たにターミナルを開いてください
slack-cleaner --token <TOKEN> --message --channel general --user "*"でドライランで削除するメッセージの数と内容を確認します
--perform を付与することで実際に削除します
大量にメッセージがある場合は削除に多少時間がかかるので待ちましょう
slack-cleaner --token <TOKEN> --message --channel general --user "*" --perform--bot を指定します
slack-cleaner --token <TOKEN> --message --channel general --bot "*" --perform今回はレガシートークンを使用しました
https://api.slack.com/legacy/custom-integrations/legacy-tokens
本来であれば OAuth2 アプリを作成してトークンを取得してから実行する必要があります
前回 Slack の無料プランで slackbot を使ってメールの通知を受け取る方法を紹介しました
直接コメントがあったのですが MailClark という便利なアプリがあるとのことなので使ってみました
まずアプリを追加します
https://mailclark.ai/ にアクセスして「Add to Slack」を選択します
するとチームに対してアプリを追加する画面になるのでアプリに与える権限を確認して「Authorize」を選択します
すると Slack App 側に MailClark アプリから追加されたよという通知が来ます
とりあえずこれでアプリの追加は完了です
次に MailClark 専用の転送アドレスを取得します
先ほどの画面でプルダウンにはチャネルが選択できるようになっています
まず、MailClark アプリを追加したいチャネルを選択しましょう (今回は #general を選択しました)
するとチャネル側に MailClark が追加されたよという通知が届きます
そして「Email」「Twitter」「Facebook」と並んでいるボタンから「Email」を選択しましょう
すると「general@team-kaka.mailclark.ai」というアドレスが払い出されます
このメールアドレスのフォーマットは「チャネル名@チーム名.mailclark.ai」になります
そのまま「Receive a test email」を選択してみましょう
先ほど発行されたアドレスにテストメールが送信されチャネルにもメールの通知が届くと思います
ちなみに払い出されたアドレスに対して Gmail から送信してみたところ問題なく通知が届きました
Slack でメール通知を受け取れる MailClark を使ってみました
そのまま Slack App 上で返信することもでき「Reply」を選択すると対話形式でメールの返信を行うことができます
無料でここまで使えるのはかなり便利かなと思います
Incomming Web Hook などとは違い Integration ではなくアプリになります
権限などを与える必要がありますがそこまで気にならないと思います
Slack にはメールアプリがありこれを使うと好きなチャネルにメールを転送することができるようになります
ただ、このアプリは有料プランでないと使えません
とりあえず自分にだけメールを転送したいのであれば「Bring Email into Slack」という機能がありこれを使えば slackbot さんから通知を受け取ることができます
今回は Web 上ではなく Slack のクライアントアプリから取得します
左上のメニューから「Preferences」を選択します
表示されたメニューの中に「Messages & Media」という項目があるので選択します
画面の一番下に「Bring Email into Slack」の項目があるので移動します
そして「Get a Forwarding Address」をクリックすると転送用のアドレスが取得できます
あとは取得できたメールアドレスにメールを送信してみましょう
すると以下のように slackbot さんから通知を受け取ることができると思います
無料プランの Slack でメールを自分に転送する方法を紹介しました
チャネルに通知ではなく個別に通知されるので逆に良いという場合もあるかもしれません
Slack の Incoming WebHook の機能を使って Gitlab にコミットやコメント情報を通知する方法を紹介します
https://slack.com/apps/manage/custom-integrations から「Incoming WebHooks」を作成します
作成の仕方の詳細はこちらを参照
作成できたら Webhook URL をメモしておきます
Gitlab 側に取得した Webhook URL を設定します
設定はリポジトリ単位で行います
まず、リポジトリの Settings を開きます
Settings を開いたら次に Services を開きます
連携できるサービス一覧の中に Slack があるので選択します
おそらく一番下にあります
Active にチェックを入れ「Webhook」の欄に先ほど取得した Webhook URL を入力します
「Username」と「Channel」には Slack に表示するボットの名前と通知する Slack のチャネルを入力してください
問題なく入力できたら Save changes で設定を保存します
Gitlab 側のリポジトリにコミットしたり issue にコメントしたりしてみましょう
その内容が Slack に通知されると思います
紹介は以上です
Slack + Gitlab の通知連携は結構簡単でした
slack-hn という Hubot アプリがあったのでこれを使って Slack と HackerNews を連携してみたいと思います
また Slack のドメインは適当に「test」というドメインを使って話を進めます
チャネル名は「#test_channel」とします
すでに対象のチャネルがある場合は新規に作成する必要はありません
今回は HackerNews を流す専用のチャネル (#test_chnnel) を作成したとして話を進めます
まずは Incoming WebHooks を作成します
Incoming WebHooks は簡単に言ってしまえば Slack に通知するための機能です
https://test.slack.com/apps/manage にアクセスします
このページ内の「Custom Integrations」を選択します
すると「Incoming WebHooks」という欄があるのでこれを選択します
選択するとこれまでに作成された Incoming WebHooks のリストが表示されると思います
今回は新規で作成するので「Add Configuration」を選択します
すると Incomming WebHooks を作成する画面になります
「Post to Channel」で HackerNews を流す対象のチャネルを選択します
選択したら「Add Incoming WebHooks integration」をクリックして Incoming WebHook を作成します
作成が完了すると設定画面に移行します
ここで大事なのは「Webhook URL」をコピーしておくことです
あとは「Customize Name」「Customize Icon」等を適宜変更すれば OK です
設定できたら「Save Settings」をクリックして設定を完了しましょう
次に Slash Commands を作成します
Incoming WebHooks の時と同様に https://test.slack.com/apps/manage にアクセスします
このページ内の「Slash Commands」を選択します
たぶんこれまで作成された Slash Commands がリストで表示されると思います
今回は新規で作成するので「Add Configuration」を選択します
すると Slash Commands を作成する画面になります
Choose a Command に「/hn」と入力し Add Slash Command Integration で Slash Command を作成しましょう
すると設定画面に移動するので Integration Settings で以下の部分を設定してください
URL に入力した http://test-slack-hn.herokuapp.com/hn の部分はあとで Heroku にアプリをデプロイする URL になります
あとは「Customize Name」「Customize Icon」「Show this command in the autocomplete list」あたりを適当に変更しましょう
Save Integration をクリックし Slash Command の作成を完了してください
先ほど作成した Slash Command に設定した URL にデプロイする Heroku アプリを作成します
基本的にはすでにあるアプリを自分の Heroku アカウントにデプロイして完了です
https://github.com/karan/slack-hn の下の方にある「Deploy to Heroku」をクリックします
すると自分の Heroku アカウント配下に slack-hn というアプリをデプロイすることができます
( あらかじめブラウザで Heroku にログインしておくといいと思います )
アプリの設定画面に移動するので「App Name」と「Runtime Selection」を設定すれば OK です
設定したら「Deploy for free」をクリックしてデプロイします
App Name は Heroku の世界でユニークなので被ってしまう可能性があります
被ってしまった場合は適宜変更し、設定済みの Slash Command の URL の部分も変更してください
問題なくデプロイできれば完了です
あとはデプロイしたアプリに Incoming WebHook 時に取得した URL をアプリに設定してあげます
ターミナルで heroku-toolbelt を使って以下のコマンドを実行します
heroku config:set SLACK_WEBHOOK_URL="https://hooks.slack.com/services/xxxxxxxxxxxxxxxxxxxxxx" --app test-slack-hn事前に heroku login でログインしておくといいと思います
これで WebHook 用の URL をアプリに設定することができました
実際に動作するか確認してみましょう
対象のチャネルに移動してコメント欄に「/hn」と入力してみると HackerNews の一覧が表示されると思います
如何でしたでしょうか
Incoming WebHook と Slash Command という Slack のアプリを組み合わせて HackerNews の情報を取得してみました
基本的に Incoming WebHook を使った通知系はこれの応用なので、覚えておいて損はないと思います
あとはこういったニュース系のやつは cron を使って定期的に通知したいという要望があると思うので cron に対応してもいいかなと思います
その辺もおいおい紹介できればなと思います
Incoming WebHooks も Slash Commands も該当の URL (https://test.slack.com/apps/manage) にまだ存在しない場合は https://test.slack.com/apps/ から「Slash Commands」で検索して、そこから「Add Configuration」を実行すれば OK です
