Migration Support
Productboard Feedback
This guide will walk you through the process of migrating customer feedback from Productboard into Vistaly.
If your team has been adding insights to ProductBoard from Slack, ensure you follow steps 1-4 if you’d like to include messages collected from Slack as part of your migration. Otherwise, skip to step 5.
Step 1: Create a Slack App
- Go to api.slack.com/apps
- Click the “Create New App” button
- Choose “From scratch”
- Name your app (e.g., “Vistaly Migration App”) and select your workspace
- Click “Create App”
Step 2: Configure User-Level Permissions
- In the left sidebar, click on “OAuth & Permissions”
- Scroll down to the “Scopes” section
- Under “User Token Scopes” (not Bot Token Scopes), add the following permissions:
- (to read messages from public channels)
- (to read messages from private channels)
- (to get channel information)
- (to get private channel information)
- (to get user information)
- (to match users by email)
Step 3: Install the App to Your Workspace
- Scroll up to the top of the “OAuth & Permissions” page
- Click “Install to Your Workspace Name”
- Review the permissions and click “Allow”
- After installation, you’ll see a “User OAuth Token” that starts with
- Copy this token and store it securely - this is what you’ll need for the migration
Step 4: Channel Access
With a user token, access permissions work differently:
Public Channels:
- The app can access the complete history of all public channels without being added to them
- This simplifies the migration process as no manual channel joining is required
Private Channels:
- The app will have access to private channels that the authorizing user has access to
- Private channels the authorizing user is not a member of will not be accessible
- Vistaly’s data migration tool will include a link to any instances it is unable to read so users can view those messages if they have access
Step 5: Export ProductBoard Feedback
If you use ProductBoard, you’ll need to export your feedback data:
- Use ProductBoard’s export functionality to download your Notes
- Save the exported file for the next step
Step 6: Share Required Files with Vistaly
Share the following with us using a secure method:
- Your Slack user token (starts with xoxp- or xoxb-) if using Slack
- Your ProductBoard feedback export file
Step 7: Upload Vistaly Feedback
The Vistaly team will return a CSV file that you can use to upload your feedback using the bulk feedback import feature.
Important Security Notes
- The user token provides access to your Slack workspace data. Only share it through secure channels.
- User tokens have broader permissions than bot tokens and should be handled with extra care
- User tokens will expire if the authorizing user changes their password
- After migration is complete, you can revoke the token by:
- Going to api.slack.com/apps
- Selecting your migration app
- Going to “OAuth & Permissions”
- Clicking “Regenerate” or completely uninstalling the app
Data Migration Limitations
Please be aware of these limitations:
- Private Channels: The app can only access private channels that the authorizing user is a member of
- Direct Messages: The app cannot access direct messages (DMs) or multi-person direct messages (MPDMs)
- File Access: While the app can see file metadata, downloading files may require additional permissions
- Rate Limits: Slack API has rate limits that may affect migration speed for very large workspaces
- Token Expiration: User tokens expire if the authorizing user changes their password
Need Help?
If you encounter any issues during setup, please reach out to our support team at support@vistaly.com.