📋 この記事の概要
StyleflowとChatworkを連携し、申請・承認の通知をChatworkルームに自動送信する設定方法について詳しく説明します。APIトークンの取得、ルームID確認、設定手順からトラブルシューティングまで包括的に解説します。
⚠️ 機能の利用開始について
🚨 重要:事前相談が必要
Chatwork通知機能をご利用いただくには、事前にStyleflowサポート窓口へのご相談が必要です。
- 機能有効化:システム側での機能有効化設定
🔗 Chatwork通知について
StyleflowのChatwork通知機能は、申請・承認の通知をChatworkの指定ルームに自動送信する機能です。
通知機能の特徴
- ルーム通知: 指定したChatworkルームに通知メッセージを送信
- API連携: Chatwork APIを使用した安全な連携
- ワークフロー連動: ワークフローのメール設定と連動した通知
- リアルタイム通知: 申請・承認のタイミングで即座に通知
⚠️ 重要な前提条件
メール設定が必須: Chatwork通知を送信するには、対応するワークフローのステータス遷移でメール送信設定が有効になっている必要があります。
APIトークンが必要: CratworkのAPIトークンを事前に取得しておく必要があります。
⚙️ Chatwork通知設定手順
Chatwork通知を有効にするための設定手順を説明します。
ステップ1: 基本情報画面への移動
設定画面アクセス
- メニュー選択: 「基本情報」メニューを押下
- 社員情報画面: 「社員情報」画面に遷移
- 編集モード: 「編集」ボタンを押下
ステップ2: Chatwork設定の入力
以下の項目を設定します:
| 設定項目 | 設定内容 | 説明 |
|---|---|---|
| Chatwork通知設定 | 「する」を選択 | Chatworkでの通知受信を有効化 |
| 利用するAPIトークン | 個人用/管理者用を選択 | 使用するAPIトークンの種類を選択 ※管理者用は事前設定が必要 |
| APIトークン | 取得したAPIトークンを入力 | 個人用を選択した場合のみ入力 ※取得方法はこちら |
| ルームID | 通知先ルームのIDを入力 | 通知を送信するChatworkルームのID ※確認方法はこちら |
💡 APIトークンの選択について
個人用APIトークン: 各ユーザーが自身のChatworkアカウントから取得
管理者用APIトークン: 管理者が設定した共通のAPIトークンを使用(事前に管理者による設定が必要)
注意: APIの利用制限は5分間で100回までです。管理者用APIトークンを複数ユーザーで利用する際はご注意ください。
ステップ3: 設定完了と動作確認
設定の保存と確認
- 設定保存: 「更新」ボタンを押下して設定を保存
- テスト実行: 「テスト通知」ボタンを押下
- 通知確認: 設定したChatworkルームにテスト通知用メッセージが送信されることを確認
- 設定完了: 正常に通知が届けば設定完了
❌ テスト通知が届かない場合
以下の項目を確認してください:
- APIトークン: 正しいAPIトークンが入力されているか
- ルームID: 入力したルームIDが正しいか
- API制限: 利用制限(5分間で100回)に達していないか
- 権限: APIトークンのユーザーが対象ルームに参加しているか
📋 APIトークンの確認方法
Chatwork通知を設定するには、CratworkのAPIトークンを取得する必要があります。
APIトークン取得手順
Chatworkでの設定
- Chatworkログイン: Chatworkにログイン
- メニュー選択: 画面右上のメニューから「サービス連携」を選択
- APIトークン画面: 画面左側のメニューから「APIトークン」を選択
- トークン確認: 自身のAPIトークンを確認・コピー
💡 APIトークンについて
セキュリティ: APIトークンは重要な認証情報です。第三者に知られないよう管理してください。
権限: APIトークンには、そのユーザーがアクセス可能なルームの権限が含まれます。
利用制限: Chatwork APIには利用制限があります(5分間で100回まで)。
📋 ルームIDの確認方法
Chatwork通知を設定するには、通知先ルームのIDを確認する必要があります。
ルームID確認手順
ブラウザでの確認方法
- Chatworkログイン: ブラウザでChatworkにログイン
- ルーム移動: 通知を送りたいルームに移動
- URLを確認: ブラウザのアドレスバーのURLを確認
- IDを抽出: URL末尾の「#rid」に続く数字がルームID
💡 URLの見方
URL例: https://www.chatwork.com/#!rid123456789
ルームID: 123456789(「#rid」に続く数字部分)
ルーム権限の確認
⚠️ 重要な注意点
ルーム参加: APIトークンのユーザーが対象ルームに参加している必要があります。
送信権限: ルームでメッセージ送信権限が必要です。
プライベートルーム: プライベートルームの場合、明示的にルームに招待されている必要があります。
📱 通知例と表示形式
通知メッセージの形式
Chatwork通知で受信するメッセージの例をご紹介します。
通知メッセージの内容(例)
📄 経費申請の承認依頼
田中太郎さんから経費申請の承認依頼が届きました。
申請日: 2025年9月12日
金額: ¥5,000
内容: 会議資料購入費
💡 通知メッセージについて
通知メッセージの内容は、ワークフローのメール設定で設定したメールタイトル・本文がベースとなります。
詳細については、チャット通知メッセージとワークフロー設定の関係についてをご参照ください。
🛠️ トラブルシューティング
よくある問題と解決法
❌ 通知が届かない場合
| 問題 | 考えられる原因 | 解決策 |
|---|---|---|
| 通知が全く届かない | ワークフローのメール設定が無効 | 対応するステータス遷移のメール設定を有効化 |
| APIエラーが発生 | APIトークンが間違っている | 正しいAPIトークンを確認・入力 |
| ルームに届かない | ルームIDが間違っている | 正しいルームIDを再確認・入力 |
| 権限エラー | ルームに参加していない | APIトークンのユーザーをルームに招待 |
| 利用制限エラー | API制限に達している | 時間をおいて再実行、または管理者用APIの利用見直し |
設定確認のチェックリスト
✅ 設定確認ポイント
-
ワークフロー設定:
- 対象ステータス遷移でメール送信設定が有効か
- 送信対象(申請者・承認者・回覧者)にチェックが入っているか
- メールタイトル・本文が設定されているか
-
Chatwork個人設定:
- Chatwork通知設定が「する」になっているか
- 正しいAPIトークンが入力されているか
- 正しいルームIDが入力されているか
-
Chatwork側設定:
- 指定ルームが存在するか
- APIトークンのユーザーがルームに参加しているか
- ルームでメッセージ送信権限があるか
高度なトラブルシューティング
🔧 詳細診断項目
- API制限状況: 5分間で100回の制限に達していないか確認
- ルームタイプ: プライベートルームの場合、明示的な招待が必要
- アカウント状態: Chatworkアカウントが有効状態か確認
- ネットワーク: ファイアウォール等でChatworkとの通信がブロックされていないか確認
📞 サポート情報
お問い合わせ先
- Styleflow関連: Styleflowサポート窓口
- Chatwork設定関連: 各組織のChatwork管理者
- API関連: Chatwork公式サポート
関連マニュアル
- ワークフロー設定: 【Styleflow】操作マニュアル-ワークフロー設定
- チャット通知: 【Styleflow】操作マニュアル-チャット通知
- 管理者向け: 【Styleflow】操作マニュアル-チャット通知_管理者向け
🎓 まとめ
Chatwork連携の活用効果
Chatwork通知を適切に設定することで、以下のメリットが得られます:
- 即時通知: 申請・承認の進行状況をリアルタイムで把握
- 業務効率化: 普段使用するChatworkで通知確認
- 見落とし防止: 重要な承認依頼を見逃すリスクを軽減
- チーム連携: チーム全体での進捗状況共有が可能