Chats Export

The Chat Export is offered by TimelinesAI support under specific terms and conditions, tailored to each customer. To discuss pricing (if applicable), please reach out to our support team at hello@timelines.ai

The TimelinesAI Chat Export is an executable file that needs to be run locally on a Windows or Mac OS. Upon execution it generates a collection of folders and files containing messages from WhatsApp chats synced into your TimelinesAI workspace. Once obtained, executable file can be used unlimited number of times (e.g., monthly or as needed).

How to use the script



Extract obtained script into a folder in your local environment ( ex: PC running on Windows OS).
Open the command line and navigate to the folder with your file
Execute the file. Sample format: export.exe --api_token XXX [other optional supported arguments] , where XXX is your own Public API token from https://app.timelines.ai/integrations/api/

Other supported arguments:

--download_attachments - download attachments. Example: export.exe --api_token XXX --download_attachments
-- start_date START_DATE - export messages AFTER the specified date (format: YYYY-MM-DD). Example: export.exe --api_token XXX --start_date 2024-10-16
--end_date END_DATE - export messages BEFORE the specified date (YYYY-MM-DD). Example: export.exe --api_token XXX --end_date 2024-10-16
--whatsapp_account WHATSAPP_ACCOUNT - export messages from specific WhatsApp account phone number (e.g., +972501111111 or 972501111111). Example: export.exe --api_token XXX --whatsapp_account +972501111111 ,
-h - shows the help message with supported arguments. Example: export.exe --api_token XXX -h
Successful script execution will start with following output:

Chat ID: XXX, Chat Name: YYYY, Messages Exported: ZZZ, Attachments Downloaded: ZZZ, API Errors: 0

and end with:
Export Completed!

Number of API requests made: X
Total running time: X seconds
Total number of WA accounts exported: X
Total number of Chats exported: X
Total number of Messages exported: X
Total number of attachments downloaded: X
Total size of attachments downloaded: X.XX MB


Execution time depends on amount of chats/messages in your workspace. It might take from several minutes to several hours

Execution results



Open the folder with the script
When script has been executed successfully it will contain folder/s with chat exports. If you have multiple WhatsApp accounts and executed export for several of them, each WhatsApp account will be represented by it's own folder.


Open the desired folder
Each folder will have an overview Excel spreadsheet and subfolders.



Overview Excel Spreadsheet will contain the list of chats and their chatIDs with following additional chat information:

Subfolders represent a single chat and are named after corresponding chatID. Each subfolder, in turn, will have one more Messages Excel file with all the messages from the particular chatID. This Excel file will contain following information:

Updated on: 16/10/2024

Was this article helpful?

Share your feedback

Cancel

Thank you!