よくある質問

スタンプを押しても「記録しました」が出ない

そのチャンネルに Bot が招待されていません。/invite @Actagate を実行してから、 リアクションを付け直してください（一度外して付け直せば OK）。

/actagate が「app did not respond」になる

Slack はスラッシュコマンドに 3 秒以内の応答がないとこのエラーを出します。 Bot が落ちているか、Socket Mode の接続が切れているかのどちらかです。 1 分ほど置いて /actagate をもう一度実行し、それでも同じなら管理者に連絡してください。 （管理者向け：docker compose ps bot で状態を見て、docker compose logs --tail=100 bot を確認。 ヘルスチェックは http://127.0.0.1:3001/healthz、復旧は docker compose restart bot。）

申請を出そうとしたら「上長を設定してください」と言われた

/actagate setup @あなたの上長 を一度だけ実行してください。

承認カードを押したのに「この承認ステップの承認者ではありません」と出る

そのステップの承認者に指定された本人のみ押せます。代理承認は現在未対応です。

ワークスペースが見えない

管理ワークスペース /ws/* は、承認や管理をする人だけが入れます。次のいずれかに当てはまると 入れます：（1）admin / owner、（2）誰かの上長、（3）承認グループのメンバー、 （4）これまでに承認者として対応したことがある。どれにも当てはまらない場合は ホーム（/home?message=workspace_unavailable）に戻ります。承認だけなら Slack のカードからも行えます。

Web で承認したら Slack のカードはどうなる

Web で承認・却下・差戻しをすると、対応する Slack の承認カードも同じ結果に更新されます。逆に Slack で 操作した場合も Web に反映されます。二重に処理されることはなく、どちらで行っても監査記録と plan hash の検証は同じです。

間違えて申請してしまった

承認前であれば管理者に取消を依頼してください。承認・実行済みのものは 台帳から「回収」で取り消し、記録を残した上で無効化します。

Web にログインできない（not_registered と出る）

Sign in with Slack は、Actagate に登録済みの Slack アカウントだけが使えます。一度 Slack 側で /actagate を実行するか、スタンプを使うと登録され、ログインできるようになります。 メールアドレスで招待されている場合は、/login のメールログインを使ってください。

メールが届かない

ログインリンクや招待メールが届かないときは、次の順に確認してください。

1. 迷惑メールフォルダを見る。差出人は管理者が設定した MAIL_FROM のアドレスです
2. 入力したメールアドレスが、管理者が招待したものと同じか確認する（大文字・小文字は区別しません）。 登録の有無に関わらず画面の応答は同じなので、未登録なら管理者に招待を依頼してください
3. リンクは 15 分で失効し、1 回しか使えません。期限切れなら /login からもう一度送ってください
4. 短時間に何度も送ると制限がかかります（同じメールアドレスで 1 時間に 5 回まで）。しばらく待ってから再送してください
5. それでも届かないときは管理者に連絡してください（管理者向け：MAIL_TRANSPORT が log のままだと 実際には送信されず、サーバーのログにだけ出ます。smtp と SMTP_URL / MAIL_FROM の設定と、 送信ドメインの SPF / DKIM を確認してください）

言語を変えたい

Web は右上の 🌐 から切替できます（保存されます）。Slack の通知はあなたの Slack の言語設定に自動で従います。

データはどこに保存される？

自社で管理する PostgreSQL データベースです（セルフホスト）。 チャットの本文は、スタンプを付けたメッセージの抜粋のみを保存します。