📋 Archiving & Transcripts

When a ticket is closed, the bot can automatically generate a styled HTML transcript, save it to disk, and DM it to the ticket opener and/or a log user.

---

Configuration

{
  "archive": {
    "enabled": true,
    "dmOpener": true
  }
}

The logUserId (for staff copies) is set in .env as ARCHIVE_LOG_USER_ID, not in config.json.

Field	Type	Default	Description
enabled	boolean	true	Save an HTML transcript to disk on close
dmOpener	boolean	true	DM the transcript file to the ticket opener
ARCHIVE_LOG_USER_ID (env)	string	—	User ID that receives a DM copy of every transcript

---

Where transcripts are stored

Transcripts are saved to the transcript-archive/ directory in the project root:

fluxer-ticket-bot/
└── transcript-archive/
    ├── ticket-general-alice-0042_2025-03-01T14-30-00-000Z.html
    ├── ticket-billing-bob-0123_2025-03-02T09-15-00-000Z.html
    └── ...

Filenames follow the pattern: {channelName}_{closedAt}.html.

Back up your transcripts

The transcript-archive/ directory is not cleared automatically. Consider periodically copying it to cloud storage or a backup drive.

---

The HTML transcript

Each transcript is a self-contained HTML file that renders correctly in any modern browser, with no internet connection required (aside from loading user avatars from Fluxer's CDN).

It includes:

• A header with ticket type, opener username, open/close timestamps, and message count
• Full rendered message history with avatars, timestamps, embeds, attachments, and formatted text (bold, italic, code blocks, spoilers, mentions)
• Syntax-highlighted code blocks
• Inline image previews for image attachments

---

Retrieving transcripts

Via DM (automatic)

If dmOpener is true, the opener receives the HTML file as a DM attachment when the ticket closes.

Known issue

There is a known bug in Fluxer that currently prevents bots from sending DMs to users in some cases. If DM delivery fails, the transcript is still saved to disk.

Via admin command

A staff member can re-send any transcript on demand:

!ticket transcript

Lists the 15 most recent archives.

!ticket transcript ticket-general-alice-0042_2025-03-01T14-30-00-000Z.html

Sends the specified file to the command author's DMs.

See Transcripts for full details.

---

Disabling archiving

Set "enabled": false to skip archiving entirely:

{
  "archive": {
    "enabled": false,
    "dmOpener": false
  }
}