You can back up your existing WhatsApp chat history and upload it to SleekFlow to keep past conversations in one place. This is useful when connecting to SleekFlow or when you want your team to access historical customer interactions.

The process includes two steps:

1. Export chat history from WhatsApp and WhatsApp Business App
2. Upload the backup file to SleekFlow

Once uploaded, the chat history will appear in the corresponding contact’s conversation timeline.

Step 1: Export WhatsApp chat history

Install the WhatsApp Backup App

Download and install the WhatsApp Backup tool using the correct link for your device:

• MacOS M-series: Backup 1.6.0 (MacOS M-series)
• MacOS Intel: Backup 1.6.0 (MacOS Intel)
• Windows: Backup 1.6.0 (Windows)

Make sure you choose the correct version based on your device.

Open the Backup tool and sign in

After installation, go to your computer’s Downloads folder, then double-click the downloaded file to unzip it.

Add a command in Terminal for macOS

1. Right-click the unzipped app.
2. Click “New Terminal at Folder”.
   
3. Paste the following command into Terminal, then press Enter:
   xattr -c '../WhatsApp Backup.app'
   

4. Once the command finishes running, close Terminal.  
   

Open the WhatsApp Backup App

Double-click WhatsApp Backup to launch the app

Enter the passcode

Enter the passcode to access the app. 

The passcode is based on the current date using the first four digits in MDDY-style order shown in the source examples, such as:

• 2025/4/25 → 5425
• 2025/12/31 → 1231
• 2025/1/1 → 2511  

Scan the QR code with WhatsApp App

After you enter the passcode, a QR code will appear. Open WhatsApp Business App or WhatsApp App on your phone and scan the QR code to log in. The source article includes separate screenshots for iOS and Android. 

IOS version

Android Version

Choose backup options and start downloading

You can choose one of these backup options:

• All messages
• A specific date range

After selecting an option, click “Start Download”.

When downloading, make sure:

• Your desktop has a stable internet connection
• The phone hosting WhatsApp and WhatsApp Business App also has a stable internet connection
• Your screen is always on and auto sleep is turned off on your desktop, otherwise the WhatsApp Web session may expire and cause the extraction to fail.  

Save the backup file

When the download is complete, click “Save to Files” to download the .ZIP file.  

Check the exported files

Open your “Downloads” folder and unzip the downloaded file. Then open a conversation folder and check the .JSON file to confirm that the messages match what appears in your WhatsApp Business App.  

Step 2: Upload backup chat file to SleekFlow

After exporting your WhatsApp chat history, you can upload the backup file to SleekFlow and import the chat records into the selected WhatsApp Official API channel. Make sure you have a WhatsApp channel connected in SleekFlow before uploading the backup file.

1. Go to chat history import

1. Go to Channels by clicking on the icon on the left navigation bar
2. Click “WhatsApp Official API”on the left-sided panel
3. Select “Import Chat History” on the top right corner
   

2. Enter the phone number and upload the file

In the “Import WhatsApp chat history” modal:

1. Enter the phone number from the backup chat history
2. Select the channel you want to import the chat history into
3. Upload the exported .ZIP file you downloaded from Step 1
4. Click “Continue”

3. Track the import progress

After the upload starts, a progress bar appears in the bottom-left corner so you can track the import status.

You can continue using SleekFlow while the chat history is being uploaded.

When the import is complete, a green notification appears when you click the “Background Task” icon.

4. View the imported chat history

To check the imported chat history:

1. Click on the icon to go to Contacts
2. Click on “All contacts” on the left-sided panel
   
    
3. Find the imported contact
4. Click the contact name
5. Click “Send message” to view the chat history