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.
   

3. Go to Integrations and click the Create custom integration button.

4. Enter a name and description of your integration, then click Create.

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.

• 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

3. Click Confirm in the Profile template updated pop-up.

1. Select Details, then click Create access token under Integration details.

2. A new token will be created. Copy the token and click Done.

Info: 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.

2. Review the requirements and steps provided.

1. Copy the script from the previous step in the admin panel and save it as a .py file.

2. Make sure to add the access token you copied within the .py file.
3. 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."

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

2. Navigate to the Python script located on the desktop within the terminal and type "python3 $pythonscriptfilename.py".

3. Click Enter to run the script.

Note:

• Python versions 3 or above are strongly recommended to avoid errors. Here are the links to install Python: MacOS and Windows.
• 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.  
3. def check_module(module_name):
4.     try:
5.         module = importlib.import_module(module_name)
6.         print(f"{module_name} module is installed")
7.     except ModuleNotFoundError:
8.         print(f"{module_name} module is not installed")
9.     print()
10. # List of modules to check
11. modules_to_check = ['os', 'urllib', 'ssl', 'certifi', 'requests', 'json', 'logging', 'queue', 'threading']
12.  
13. # Check each module
14. for module_name in modules_to_check:
15.     check_module(module_name)

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

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.

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

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.