Troubleshooting
Fix panel, channel and transcript issues.
| Problem | Likely cause | Fix |
|---|---|---|
| Panel publish fails | Discord rejected the message or the bot lacks permission in the panel channel. | Check Send Messages/Embed Links in the target channel. The API rolls back the orphaned panel row when publish fails. |
| Ticket channel cannot be created | The bot lacks Manage Channels or the category is invalid/deleted. | Verify the selected category and bot permissions. |
| User says they already have a ticket | An OPEN ticket exists for that user and panel. | Use the linked channel. If the channel was deleted outside the bot, clicking again will close the stale row and continue. |
| Claim/lock buttons reject staff | The member lacks Manage Channels and none of the panel manager roles. | Add the correct role to managerRoleIds or grant Manage Channels. |
| No transcript link in log | NEXTAUTH_URL is missing or transcript creation returned null. | Set the dashboard base URL and check that the bot can read message history before close. |
| Transcript is short | Transcript generation caps at 2000 messages. | Close very large tickets earlier or split support work across tickets. |
Closing deletes the channel
After confirmation, the bot sends an archive notice and schedules channel deletion after 5 seconds. Make sure staff have captured any needed context before confirming.