Migrate from Google Chat to Zoho Cliq

Migrate from Google Chat to Zoho Cliq

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


This 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. Prerequisite

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. No module error


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 Google Chat to Zoho Cliq, do the following:

  1. Export your data from Google Chat    
  2. Download the data export file 
  3. Navigate to the Admin panel (admin.google.com)
  4. Go to the Data section, select Data import & export, and click Data Export.

  • On the Data export page, click the Set up new export button.

  • Enter the details for your export, such as the name of your export and the specific data you want to export, then click Start export.

  • The export process will be completed, at which point you can download the export file.

  • To download the export file, click Actions and select View Archive. This opens the cloud storage

  • Browse for the 'Customer owned data' node and download each takeout file zip individually, saving them to a folder on your desktop. You can name the folder 'Google chat export' for easy reference. 

 

Notes

Note: If your organization has FedRAMP Authorization or more than 1,000 users, contact Google Workspace support before using the Data Export tool.


Info

Limitations in Google Chat Import

  1. Certain items shared directly from Google services like Drive and Calendar cannot be imported, as Google does not provide public URLs for them.

  2. Assigned tasks cannot be migrated.

  3. Only chats, conversations, and shared files will be imported.

Import your data to Zoho Cliq

  1. Navigate to your Zoho Cliq's admin panel. Under Data Administration, select Import External Data, then click Google Chat.

  1. Review the requirements and steps provided.

Add data to the script and save it     

  1. Copy the script and save it as a .py file, making sure to add your Google Chat admin email address within the .py file.
  2. ​Save the script (as a file named "googlechatexport.py") and the zip files downloaded from Google Chat in a folder (e.g., Desktop).

Open the terminal and run the script  

How to open terminal in MacOS:

  1. Open Launchpad and type "Terminal."

  2. In the terminal, navigate to the directory where the Python file is saved. For example, cd ~/Desktop/

  3. In the next line, type "python3 googlechatexport.py".

  4. 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. Navigate to the Python script located on the desktop within the terminal and type "python3 $pythonscriptfilename.py".

  2. Click Enter to run the script.

Upload zip folder to import data to Cliq  

  1. A zip folder will be downloaded after the script runs. Drag and drop the zip folder or upload it from your system and click on 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.

 


  1. 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
  

  • 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.

  • 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. 


Notes
Note: Uncheck the Open "safe" files after downloading option in Safari settings to prevent auto-extraction if you face any problems after the download is complete.