https://github.com/pv-bhat/lw-chrome-extension
A lightweight Chrome extension to quickly and easily export conversations from Meta Business Suite into JSON format. Designed for simplicity, the tool requires minimal setup and offers a seamless way to save interaction data for further use.
https://github.com/pv-bhat/lw-chrome-extension
browser-extension chrome-extension conversation-export data-extraction json meta-business-suite simple-tools
Last synced: about 1 month ago
JSON representation
A lightweight Chrome extension to quickly and easily export conversations from Meta Business Suite into JSON format. Designed for simplicity, the tool requires minimal setup and offers a seamless way to save interaction data for further use.
- Host: GitHub
- URL: https://github.com/pv-bhat/lw-chrome-extension
- Owner: PV-Bhat
- License: gpl-3.0
- Created: 2024-12-12T13:28:59.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-10T18:39:59.000Z (over 1 year ago)
- Last Synced: 2025-03-31T14:18:25.253Z (about 1 year ago)
- Topics: browser-extension, chrome-extension, conversation-export, data-extraction, json, meta-business-suite, simple-tools
- Language: JavaScript
- Homepage:
- Size: 55.7 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# LW Chrome Extension
[]()
[]()
[](https://www.gnu.org/licenses/gpl-3.0)
[](https://doi.org/10.5281/zenodo.14846469)
LW Chrome Extension is a simple browser-based tool that enables users to export conversations from Meta Business Suite into JSON files, making it easy to analyze and process customer interaction data. This extension seamlessly integrates with Meta platforms, ensuring a smooth data extraction process.
## Features
- **Automated Data Extraction:** Extracts conversations from Meta Business Suite directly into JSON format.
- **Timestamped Exports:** Each export is saved with a unique timestamped filename for easy identification.
- **Pre-Packaged Files:** Includes all necessary files in a pre-structured `/Download-Package` folder for easy setup.
- **Error Handling:** Provides detailed feedback on missing messages or errors during export.
- **Compatibility:** Supports all major Meta platforms, including Facebook and Business Suite.
## Installation
### Download the Extension Files
1. Clone or download the repository:
```bash
git clone https://github.com//LW-Chrome-Extension.git
```
2. Navigate to the `/Download-Package` folder in the repository. It contains all necessary files, including:
- `manifest.json`
- `background.js`
- `content.js`
- `popup.js`
- `popup.html`
- Required icon files (e.g., `icon16.png`, `icon48.png`, `icon128.png`)
3. Extract the `/Download-Package` folder to a preferred location on your computer.
### Load the Extension into Chrome
1. Open Google Chrome and navigate to `chrome://extensions/`.
2. Enable **Developer Mode** using the toggle switch in the top-right corner.
3. Click **Load unpacked** and select the `/Download-Package` folder.
4. The LW Chrome Extension icon should appear in your browser's toolbar.
## Usage
1. Navigate to the conversation page within Meta Business Suite.
2. Click on the LW Chrome Extension icon in your browser's toolbar.
3. In the popup, click **Export Conversations**.
4. JSON files will automatically be saved to your browser's default Downloads directory. If the directory requires adjustment, see customization steps below.
5. The status message will indicate progress and completion.
## Integration with Meta-Labeler
The LW Chrome Extension integrates seamlessly with [Meta-Labeler](https://github.com/PV-Bhat/Meta-Labeler/blob/main/README.md), a lightweight tool for labeling and analyzing conversation data. Here's how they work together:
### Workflow
1. **Export Conversations**: Use LW Chrome Extension to download conversations from Meta Business Suite as JSON files.
2. **Process Data**: Import the exported JSON files into Meta-Labeller for labeling and analysis.
3. **Export Results**: Generate structured insights (e.g., Excel files) for business workflows like lead scoring or customer support optimization.
### Leads Wizard Ecosystem
Both the LW Chrome Extension and Meta-Labeler are part of the evolving **[Leads Wizard](https://github.com/PV-Bhat/LeadsWizard/tree/main)** ecosystem, which aims to streamline lead management and conversational insights. Stay tuned for updates!
## Customizing the Export Folder
If you need to save JSON files in a specific location:
1. Open the `background.js` file from the `/Download-Package` folder.
2. Locate the line that specifies the download path.
3. Update it to your desired directory.
```javascript
const downloadPath = "Your/Preferred/Path/Conversations";
```
## File Structure
### Manifest File (`manifest.json`)
- **Purpose:** Defines the extension's permissions, host settings, and background scripts.
- **Key Permissions:**
- Active Tab
- Downloads
- Tabs
### Content Script (`content.js`)
- Extracts conversation data by parsing DOM elements on the page.
- Cleans and structures data into JSON format.
- Sends the structured data to the background script for downloading.
### Background Script (`background.js`)
- Handles communication between the content script and the browser's download API.
- Initiates downloads and provides error handling for failed attempts.
### Popup Script (`popup.js`)
- Manages user interactions with the extension popup.
- Triggers the content script to parse and export data.
### Popup HTML (`popup.html`)
- Provides the user interface for the extension popup, allowing users to trigger exports.
## Development and Contribution
### Local Setup
- Ensure you have a working installation of Google Chrome.
- Use `console.log` in scripts for debugging and reviewing functionality.
### Contributions
Contributions are welcome! To contribute:
1. Fork the repository.
2. Create a feature branch (`feature/your-feature-name`).
3. Commit your changes.
4. Push the branch and submit a Pull Request.
## Known Issues
- **Selectors May Vary:** If the DOM structure of Meta Business Suite changes, updates to `content.js` may be required.
- **Customization Required:** Users must manually edit the `background.js` file to change the default export folder.
## License
This project is licensed under the GNU General Public License v3.0. See `LICENSE` for details.