---
title: チャットやメールとの連携・Webhook・Mailhook
category: help
tags:
created_at: '2014-11-02T23:17:47+09:00'
updated_at: '2021-08-30T16:43:10+09:00'
published: true
number: 10
---
esaでは、Slack等の外部ツールとの連携を可能にするWebhookや、特定のメールアドレスに通知する Mailhookを設定することができます。
これらを用いて、esa記事の更新情報を外部ツールで受け取ることができます。
## Webhook
現在、下記のチャットツールに対応しています。`/team/webhooks` から設定できます。
- Slack
- Discord
- Microsoft Teams
- ChatWork
- Typetalk
- [Workplace by Facebook (詳しい利用法はこちら)](https://docs.esa.io/posts/327)
- Google Chat
- Mattermost
- LINE Notify
- Ikachan(IRC)
## Mailhook
- 特定のカテゴリを指定して、```Shipit``` と同時に投稿と同じ内容をメール送信できる、Mailhookもあります。
- これにより、例えば日報をメールで運用しているチームでも、既存のルールを変えずに esaの日報とメールの日報を併用することができます
## Generic Webhook
Generic Webhookを利用して、記事やコメントの投稿・更新時に指定されたURLに対してHTTPリクエストを送ることができます。
- [#36: release_note/2014/12/23/Webhookの改善(カテゴリ指定, Generic Webhook)](/posts/36)
- [#37: dev/webhooks/generic](/posts/37)
## 特定のカテゴリのみをWebhookで通知する
esa内の特定のカテゴリのみを指定して、Webhookに設定することができます。
- Webhook 設定の __「Filter」__ の欄から、正規表現でカテゴリ名をフィルタして通知することができます。
- 例えば 「日報」カテゴリのみを通知したい場合は、下図のように Filter の欄に `^/日報/` と入れることで、 「日報」カテゴリ以下の記事の更新通知のみがWebhookで受け取れます
- 逆に「日報」カテゴリ以外を通知したい場合は、 Filter の欄に `^(?!/日報/)/` と入れると、 「日報」カテゴリ以外の記事の更新通知のみがWebhookで受け取れます
## ChatWorkのWebhook設定方法
1. 設定名(任意)
2. [特定のカテゴリのみをWebhookで通知する](#特定のカテゴリのみをWebhookで通知する)際のフィルター
3. https://www.chatwork.com/#!rid12345678(URL末尾の太文字部分)
4. ChatWorkの[API Token](https://www.chatwork.com/service/packages/chatwork/subpackages/api/token.php)
5. 記事がShip It!で作成された時
6. 記事がShip It!で更新された時
7. 記事がWIPからShip It!に更新された時
8. 記事がShip It!でArchiveされた時
9. 記事が削除された時
10. 記事が公開・非公開された時
11. コメントが作成された時
12. チームに新メンバーが追加された時
## アイコン
- Webhook などにこちらのアイコンをよかったらお使いください (\\( ⁰⊖⁰)/)
- 
- 