Import from Slack
Starting with uKnowva Messenger 1.8, uKnowva Messenger supports importing data from Slack,
including users, channels, messages, attachments, avatars, custom
emoji, and emoji reactions.
This tool has been used to import Slack workspaces with 10,000 members
and millions of messages. If you're planning on doing an import much
larger than that, or run into performance issues when importing, email
us at support@zulipchat.com for help.
Note: You can only import a Slack workspace as a new uKnowva Messenger
organization. In particular, you cannot use this tool to import from Slack
into an existing uKnowva Messenger organization.
Import from Slack
First, export your data from Slack.
-
Export your Slack data. You will
receive a zip file slack_data.zip
.
Note: Only Slack owners and admins can export data from Slack.
See Slack's
guide to data exports
for more information.
-
Generate a Slack API token.
Import into zulipchat.com
Email support@zulipchat.com with slack_data.zip
, the Slack API token
generated above, and your desired subdomain. Your imported organization will
be hosted at <subdomain>.zulipchat.com
.
If you've already created a test organization at
<subdomain>.zulipchat.com
, let us know, and we can rename the old
organization first.
Import into a self-hosted uKnowva Messenger server
First
install a new uKnowva Messenger server,
skipping "Step 3: Create a uKnowva Messenger organization, and log in" (you'll
create your uKnowva Messenger organization via the data import tool instead).
Log in to a shell on your uKnowva Messenger server as the zulip
user. To import with
the most common configuration, run the following commands, replacing
<token>
with the value generated above.
cd /home/zulip/deployments/current
./manage.py convert_slack_data slack_data.zip --token <token> --output converted_slack_data
./manage.py import '' converted_slack_data
This could take several minutes to run, depending on how much data you're
importing.
Import options
The commands above create an imported organization on the root domain
(EXTERNAL_HOST
) of the uKnowva Messenger installation. You can also import into a
custom subdomain, e.g. if you already have an existing organization on the
root domain. Replace the last line above with the following, after replacing
<subdomain>
with the desired subdomain.
./manage.py import <subdomain> converted_slack_data
Logging in
Once the import completes, all your users will have accounts in your
new uKnowva Messenger organization, but those accounts won't have passwords yet
(since for very good security reasons, passwords are not exported).
Your users will need to either authenticate using something like
Google auth, or start by resetting their passwords.
You can use the ./manage.py send_password_reset_email
command to
send password reset emails to your users. We
recommend starting with sending one to yourself for testing:
./manage.py send_password_reset_email -u username@example.com
and then once you're ready, you can email them to everyone using e.g.
./manage.py send_password_reset_email -r '' --all-users
(replace ''
with your subdomain if you're using one).
Caveats
-
Slack doesn't export private channels or direct messages unless you pay
for Slack Plus or contact Slack support. See
Slack's documentation
for more details.
-
(Slack Plus import) Private channels and direct messages are currently
not imported. We expect to address this in a future revision.
-
(Slack Plus import) Message edit history is currently not imported.
-
Slack doesn't export user settings or organization settings, so
you'll need to configure these manually.
-
Permission hierarchy:
Slack's Primary owner
, owner
, and admin
are mapped to uKnowva Messenger's Organization admin
.
Slack's Member
, restricted
, and ultra restricted
are mapped to regular uKnowva Messenger users.
Channel creators
have no special permissions in uKnowva Messenger.
-
The "joined #channel_name" messages are not imported.