mirror of https://github.com/zulip/zulip.git
45 lines
1.6 KiB
Markdown
45 lines
1.6 KiB
Markdown
# Import users and channels from Slack
|
|
|
|
{!follow-steps.md!} import users and channels from Slack to Zulip.
|
|
|
|
!!! warn ""
|
|
**Note:** Please ensure that you have admin rights before importing users and channels from Slack.
|
|
|
|
1. Generate a Slack API token using Slack's [test token generator](https://api.slack.com/docs/oauth-test-tokens)
|
|
to import all of the necessary data.
|
|
|
|
{!go-to-the.md!} [Your Account](/#settings/your-account)
|
|
{!settings.md!}
|
|
|
|
3. Click on the **Show/change your API key** button.
|
|
|
|
4. Upon clicking the **Show/change your API key** button,
|
|
you will be asked to confirm your identity by entering
|
|
your password in the **Current password** field.
|
|
|
|
5. Click the **Get API Key** button and copy the generated API Key.
|
|
|
|
6. Fill all of the settings in `api/integrations/slack/zulip_slack_config.py`:
|
|
|
|
* `SLACK_TOKEN` - the token from point number 1.
|
|
|
|
* `ZULIP_USER` - the e-mail of the user (the user that API key was generated for).
|
|
|
|
* `ZULIP_KEY` - the API key from point number 4.
|
|
|
|
* `ZULIP_SITE` - the Zulip API server URI.
|
|
|
|
7. Install the `slacker` dependency using the command `pip install slacker`
|
|
|
|
8. Finally, run the script in your local Zulip directory using the command
|
|
`python api/integrations/slack/zulip_slack.py`
|
|
|
|
## Importing users from a different organization
|
|
|
|
If the users are not from the same organization, you should change your organization settings accordingly.
|
|
|
|
{!go-to-the.md!} [Organization settings](/#administration/organization-settings)
|
|
{!admin.md!}
|
|
|
|
2. Disable the **Restrict new users to the following email domains** option.
|