Migrate from Meta Workplace to Zoho Cliq

Migrate from Meta Workplace to Zoho Cliq

Prerequisites-Migration Requirements

1. Disk Space
Users must ensure that the disk has sufficient free space for the export process to complete successfully.
2. Network and System Stability
Users must ensure there are no network interruptions during the migration. They should also ensure their machine does not go to sleep, as the script will terminate if the system enters sleep mode.
3. Python Installation and Setup
Python version 3 or above is strongly recommended to avoid errors. Users can install Python using the following links: MacOS and Windows. For step-by-step instructions on how to install Python, you can refer to this link.
To verify the installation, run:
  •  python3 --version
4. pip is usually installed along with Python. If pip is missing, it must be installed separately. Installation guide:
https://pip.pypa.io/en/stable/installation/
To verify pip installation, run:
  •    pip3 --version (or) python3 -m pip --version
5. As a prerequisite to checking if all the necessary modules are installed, you can run the following code in a .py file in your terminal. This will display all the installed modules. If a specific module is missing, you can install it.
  1. import importlib
  2. def check_module(module_name):
  3.     try:
  4.         module = importlib.import_module(module_name)
  5.         print(f"{module_name} module is installed")
  6.     except ModuleNotFoundError:
  7.         print(f"{module_name} module is not installed")
  8.     print()
  9. #List of modules to check  
  10. modules_to_check = ['os', 'urllib', 'ssl', 'certifi', 'requests', 'json', 'logging', 'queue', 'threading']
  11. #Check each module  
  12. for module_name in modules_to_check:
  13.     check_module(module_name)
6. If you encounter the 'No module $module_name' error, identify the exact command for the Python 3 version and enter it in the script. For example, in Python 3, the command is "sudo pip3 install requests".

7. If pip3 install does not work, users should use: python3 -m pip install <module_name>
8. Required Python dependencies such as requests and certification must also be installed.

To migrate your conversations from Meta Workplace to Zoho Cliq, do the following:

Export your data from  Meta Workplace

Grant permissions and copy access token

  1. Log in to your Meta Workplace account.
  2. In the navigation sidebar, click on the Admin Panel.
  1. Go to Integrations and click the Create custom integration button.
  1. Enter a name and description of your integration, then click Create.
 Add API permissions 
  1. Once you have created your custom integration, click Permissions. A list of categories will appear where you can select the permission you want to request.
  2. Check the 13 permissions mentioned below, then click Save.
API permissions to select:
  • Read all messages
  • Message any member
  • Explore employee data
  • Read group membership
  • Read group content
  • Manage groups
  • Read user email
  • Read work profile
  • Read org chart
  • Manage accounts
  • Read user timeline
  • Read Workplace company data exports
  1. Click Confirm in the Profile template updated pop-up.
 Copy access token 
  1. Select Details, then click Create access token under Integration details.
  1. A new token will be created. Copy the token and click Done.

InfoInfo: Make sure to copy and paste the access token in your system's desired location (e.g., Notes). The token will only be visible once, and you will need it later.

Import your data to Zoho Cliq

Run the code  

  1. Navigate to your Zoho Cliq's admin panel. Under Data Administration, select Import External Data, then click Meta workplace.
  1. Review the requirements and steps provided.
Add data to the script and save it   
  1. Copy the script from the previous step in the admin panel and save it as a .py file.
  1. Make sure to add the access token you copied within the .py file.
  2. Save the script in a directory (e.g., Desktop) as a file named "metaworkplaceexport.py".

Open terminal and run the script   

How to open terminal in MacOS:

  1. Open Launchpad and type "Terminal."
  1. In the terminal, navigate to the directory where the Python file is saved. For example, cd ~/Desktop/
  1. In the next line, type "python3 metaworkplaceexport.py".
  1. Click Enter to run the script. 

How to open terminal in Windows:

  1. Click on the Start Menu in Windows, then search for 'Command Prompt.' This will open the terminal.
  1. Navigate to the Python script located on the desktop within the terminal and type "python3 $pythonscriptfilename.py".
  1. Click Enter to run the script.

Upload zip folder to import data to Cliq   

  1. A zip folder will be generated with the data fetched from Meta workplace after the script runs. Drag and drop the zip folder or upload it from your system and click Upload.
  1. Once your data has been successfully imported, you will be able to view the count of users and channels imported. You can also import the direct messages and group chats of your organization users.
An email will be sent to the users inviting them to join Cliq.
Notes
Note:
Importing data more than once can result in data duplication, which may be difficult to clean up. Please ensure that data is imported only once to avoid complications.
 

Post-Migration Requirements 

  1. For any Python-related issues after the migration is initiated, users must share the demo.log file for debugging. This will help reduce back-and-forth communication.
  2. Users must provide valid inputs and scripts. If migrating using Python and running the migration a second time, users must generate a new script from the admin panel and must not reuse an existing script.