Slack Exports#

Tap into the Slack API and export threads into Markdown format, including user mentions, attachments, and reactions.

Features#

  • Resolve Slack user IDs to usernames.

  • Export reactions associated with messages.

  • Handle attachments and blocks in messages.

  • Download and embed file attachments.

  • Opsgenie-specific message formatting.

  • Comprehensive logging.

Setup#

In order to authenticate with the Slack API, you will need a Slack Bot authentication token with access permissions to the required OAuth scopes.

  • channels:read: To access channel information.

  • channels:history: To read message history in channels.

  • groups:read: To access private channels information.

  • groups:history: To read message history in private channels.

  • users:read: To resolve user IDs to usernames.

  • files:read: To download file attachments.

  • reactions:read: To access reactions on messages.

Usage#

Authentication#

Either define the authentication token as an environment variable,

export SLACK_TOKEN="xoxb-your-slack-bot-token"

or use the --slack-token command-line option.

Export conversation#

Export Slack conversation thread into Markdown document.

rapporto slack export \
  "https://acme.slack.com/archives/D018V8WDABA/p1738873838427919"