> ## Documentation Index
> Fetch the complete documentation index at: https://help.zarms.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# ボードの出来事を Google Chat・Slack に流す

> ボードでカードが作られた、状態が変わった、コメントが付いたなどの出来事を、Google Chat のスペースや Slack のチャンネルに投稿します。受信 Webhook の URL の取り方と、ボードごと・チーム全体への設定のしかた。

ボードの出来事を、チームの Google Chat のスペースや Slack のチャンネルに投稿できます。メールの通知は一人ひとりに届きますが、こちらは 1 か所へまとめて流れるので、チームで動きを追うのに向いています。

送り先は、ボードごとにも、チーム全体（すべてのボード）にも設定できます。

できる人: オーナー、マネージャー

## 投稿される出来事

送る出来事は、サービスごとに選べます。最初はすべてオンです。

| 出来事 | 投稿される内容 |
| - | - |
| カードの作成 | 誰がどのカードを作ったか |
| 状態の変更 | 誰がどのカードをどの状態にしたか |
| 担当の設定 | 誰がどのカードの担当に誰を入れたか |
| コメントとメンション | 誰がどのカードにコメントしたか、誰にメンションしたか |
| 期限間近・期限切れ | 期限の 24 時間前と、期限が切れたとき |

投稿にはボード名とカードへのリンクが付きます。テンプレートカードの出来事は送りません。個人の [通知設定](https://help.zarms.cloud/ja/notifications/settings.md) とは関係なく、ボードの設定どおりに投稿されます。

> [!NOTE]
>
> スペースやチャンネルにいる人は、ZARMS
> のメンバーでなくても投稿を読めます。社外の人がいる場所に流すときは、カード名が見えてよいかを確かめてください。

## 受信 Webhook の URL を用意する

先に、投稿したい場所で受信 Webhook を作り、URL をコピーしておきます。

> [tab] Google Chat
>
> **1. スペースを開く**
>
> Google Chat で、投稿したいスペースを開きます。
>
> **2. Webhook を追加する**
>
> スペース名を押し、**アプリと統合** から **Webhook を追加** を選びます。名前（例: ZARMS）を入れて保存します。
>
> **3. URL をコピーする**
>
> 作った Webhook の URL（`https://chat.googleapis.com/v1/spaces/` で始まるもの）をコピーします。
>
> スペースに Webhook を追加できないときは、Google Workspace の管理者に確かめてください。詳しくは [Google の説明](https://developers.google.com/workspace/chat/quickstart/webhooks) を見てください。

> [tab] Slack
>
> Slack のアプリで **Incoming Webhooks** を有効にし、投稿したいチャンネルを選んで Webhook を追加します。できた URL（`https://hooks.slack.com/services/` で始まるもの）をコピーします。ワークフロービルダーの Webhook（`https://hooks.slack.com/triggers/` で始まるもの）も使えます。
>
> 手順は [Slack の説明](https://api.slack.com/messaging/webhooks) を見てください。アプリを追加できないときは、Slack のワークスペースの管理者に確かめてください。

## ボードに設定する

**1. ボード設定を開く**

ボードの画面で、上部のボード名か説明を押して **ボード設定** を開きます。

**2. 通知タブを開く**

**通知** タブを選びます。このタブは、オーナーとマネージャーにだけ出ます。

**3. URL を貼り付ける**

**Google Chat・Slack に通知** の欄で、使うサービスの **受信 Webhook の URL** にコピーした URL
を貼り付けます。

**4. 送る出来事を選んで保存する**

**送る出来事** で要らないものをオフにし、そのサービスの **保存**
を押します。この欄は、ボード設定の **変更を保存** を待たずにすぐ反映されます。

**5. テスト送信で確かめる**

**テスト送信** を押すと、「ZARMS
からのテストです。」という投稿が届きます。届けば設定は完了です。

1 つのボードに、Google Chat と Slack を 1 か所ずつ設定できます。URL は保存すると一部だけが表示され、全体は見られません。変えるときは **新しい URL（変えるときだけ）** に入れ直します。

## すべてのボードの出来事を 1 か所に流す

チーム全体の送り先を設定すると、どのボードの出来事もそこへ投稿されます。新しく作ったボードも対象です。

**1. チーム設定を開く**

**管理画面** の **チーム設定** タブを開き、**チャット通知（Google Chat・Slack）** まで進みます。

**2. URL を貼り付けて保存する**

**チーム全体の通知** で、使うサービスの **受信 Webhook の URL** にコピーした URL
を貼り付け、**送る出来事** を選んで **保存** を押します。

**3. テスト送信で確かめる**

**テスト送信** を押すと、「ZARMS からのテストです。」という投稿が届きます。

チーム全体とボードの両方に設定すると、そのボードの出来事は両方に投稿されます。同じスペースやチャンネルを両方に設定すると、同じ投稿が 2 回届くので気をつけてください。チーム全体の送り先があるときは、ボード設定の **通知** タブにその旨が表示されます。

## やめる

設定した欄（ボード設定の **通知** タブ、またはチーム設定の **チーム全体の通知**）で、そのサービスの **解除** を押します。登録した URL は消え、元に戻せません。また流すときは URL を貼り付け直してください。

## チームでチャット通知を止める

チーム設定の **チャット通知（Google Chat・Slack）** で **受信 Webhook を登録して、Google Chat・Slack に通知できるようにする** を外して保存すると、チーム全体でチャット通知が止まります。

* ボードとチーム全体のどちらにも、新しく登録できなくなります。テスト送信もできません。
* 登録済みの送り先にも投稿されなくなります。
* 登録した URL は消えません。オンに戻すと、また投稿されます。

社外とのやり取りに使うスペースへ誤って流さないよう、使わない会社は外しておくと安心です。

## うまくいかないとき

* **欄が出てこない**: 設定できるのはオーナーとマネージャーだけです。ほかのロールでは表示されません。マイボードには設定できません。
* **「チーム設定でチャット通知がオフになっているため、登録とテスト送信はできません。」と出る**: チーム設定でチャット通知が止められています。使うときは、上の「チームでチャット通知を止める」のチェックを入れ直してください。
* **「受信 Webhook の URL ではありません。」と出る**: サービスの画面でコピーした URL を、前後を削らずにそのまま貼り付けてください。上に書いた形以外の URL は登録できません。
* **テスト送信が失敗する**: Webhook がスペースやチャンネルから削除されていないか確かめ、URL を作り直して入れ直してください。
* **投稿が届かなくなった**: 欄の下に「送れませんでした」と理由が出ていれば、その時点で送れていません。一時的な失敗は ZARMS が時間をおいて送り直します。続くときは URL を作り直してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.