トラブルシューティング
Portlの利用中に発生する一般的な問題と、その解決方法をまとめています。
Botに関する問題
Botが応答しない
原因: BotがDiscordサーバーから除外されている、またはオフラインになっている可能性があります。
対処法:
- Discordサーバーのメンバー一覧でPortl Botが表示されているか確認
- 表示されていない場合は、ダッシュボードから再度Botを招待してください
- 表示されているのに応答しない場合は、しばらく待ってから再度お試しください
/subscribe コマンドが表示されない
原因: Discordのコマンドキャッシュが更新されていない可能性があります。
対処法:
- Discordクライアントを再起動する
- コマンド入力欄に
/subscribeと入力し、候補が表示されるか確認 - それでも表示されない場合は、Botを再招待してください
ロールに関する問題
ロールが付与されない
原因: Botの権限またはロール階層の問題が考えられます。
対処法:
- ロール階層を確認: Discordサーバーの設定 → ロール で、Portl Botのロールが付与したいロールよりも上にあることを確認
- ロール管理権限を確認: Portl Botに「ロールの管理」権限があることを確認
- ティア設定を確認: ダッシュボードでティアに正しいロールが設定されているか確認
ロールが剥奪されない
通常、以下のタイミングでロールは自動剥奪されます:
- サブスクリプションのキャンセル
- 支払い失敗後の猶予期間超過
/unsubscribeコマンドの実行
対処法: ロールの手動剥奪が必要な場合は、Discordサーバーの設定から直接ロールを外してください。
Stripe・決済に関する問題
「Stripe連携が必要です」と表示される
原因: Stripe Connectの連携が完了していません。
対処法:
- ダッシュボードの設定ページを開く
- 「Stripeアカウントを連携」をクリックして、連携フローを完了する
- Stripe連携ガイドを参照
メンバーの決済が失敗する
原因: メンバーのクレジットカードの問題（残高不足、有効期限切れなど）が考えられます。
対処法:
- メンバーにはDiscord DMで支払い失敗の通知が自動送信されます
- 猶予期間中にStripeが自動で再請求を試行します
- 猶予期間内に決済が成功すれば、ロールは維持されます
売上が入金されない
原因: Stripeの審査・確認が未完了の可能性があります。
対処法:
- Stripe Dashboardにログイン
- 入金スケジュールと残高を確認
- 未完了の確認事項がないかチェック
コマンド権限に関する問題
管理者コマンドが効かない
原因: /members /status /dashboard は Discord の「サーバーの管理」権限を持つユーザーのみ実行できます。
対処法:
- Discordサーバー設定 → 連携サービス → Portl を開く
- 「コマンド権限」セクションで対象コマンドを選択
- 共同管理者用のロール、または特定ユーザーを許可リストに追加
Discord公式の機能なのでPortl側の設定は不要です。
/subscribe がメンバーに表示されない
原因: Discordクライアントのコマンドキャッシュが古い、もしくはBotの再招待が必要な可能性があります。
対処法:
- Discordクライアントを再起動
- Botを一度サーバーから外して再招待（Stripe Connect情報は保持されます）
- それでも表示されない場合はサポートまで
お支払い管理に関する問題
カスタマーポータルが開かない
原因: Stripe Connect未連携、もしくはStripeアカウント側で支払い方法が登録されていない可能性があります。
対処法:
- 運営者: 設定ページでStripe連携ステータスが「連携済み」になっているか確認
- メンバー: 入会時のDMリンクから開いてみる（最新のリンクが含まれています）
- それでも開かない場合は、メンバー本人がポータルから新規Stripeアカウントを作成する必要がある場合があります
/myplan にお支払い管理ボタンが表示されない
原因: 古いサブスクリプションでHMACトークンが生成されていない可能性があります。
対処法: 一度 /unsubscribe で解約 → /subscribe で再入会することで最新のリンクが生成されます（再入会は即時可能）。
ダッシュボードに関する問題
ログインできない
対処法:
- ブラウザのCookieとキャッシュをクリア
- シークレットモードでアクセスしてみる
- Discord自体にログインできるか確認
サーバーが表示されない
原因: そのサーバーの管理権限がないか、Botがサーバーにいない可能性があります。
対処法:
- Discordサーバーで「サーバーの管理」権限を持っているか確認
- Portl Botがサーバーに参加しているか確認
- ダッシュボードに戻って再読み込み
解決しない場合
上記で解決しない場合は、以下の方法でお問い合わせください。
- お問い合わせフォーム: portl.jp のお問い合わせセクション
- メール: contactportldiscord@gmail.com
- Discord: Portlサポートサーバー