docs: update Bubble integration images and content

Author: daveomri

sources/platform/integrations/images/bubble/auto_run_preview.png

@@ -1,194 +1,116 @@
 ---
 title: Bubble integration
-description: Learn how to integrate your Apify Actors with Bubble. This article guides you from installation through to automating your workflow in Bubble.
+description: Learn how to integrate your Apify Actors with Bubble for automated workflows and notifications.
 sidebar_label: Bubble
 sidebar_position: 7
 slug: /integrations/bubble
 ---
 
-**Learn how to integrate your Apify Actors with Bubble. This article guides you from installation through to automating your workflow in Bubble.**
+**Learn how to integrate your Apify Actors with Bubble for automated workflows and notifications.**
 
 ---
 
-[Bubble](https://bubble.io/) is a no-code platform that allows you to build web applications without writing code. With the Apify integration for Bubble, you can easily connect your Apify Actors to your Bubble applications, enabling you to scrape data, process it, and display it in your Bubble app.
+[Bubble](https://bubble.io/) is a no-code platform that allows you to build web applications without writing code. With the Apify integration for Bubble, you can easily connect your Apify Actors to your Bubble applications to automate workflows and display scraped data.
 
-## Prerequisites
+## Get started
 
-Before using the Apify integration with Bubble, you need:
+To use the Apify integration for Bubble, you will need:
 
 - An [Apify account](https://console.apify.com/)
 - A [Bubble account](https://bubble.io/)
 - A Bubble application where you want to use the integration
 
-## Get started
-
-The Apify plugin for Bubble allows you to run Actors, fetch data from datasets, manage key-value stores, and more, all without writing any code.
-
-## Demo Application
-
-We've created a comprehensive demo application that showcases various use cases of the Apify plugin for Bubble. This demo app includes examples of:
-
-- Scraping data from websites
-- Running Actors and displaying results
-- Managing Actor tasks
-- Working with webhooks
-- Interacting with key-value stores
-- Listing available Actors and tasks
-
-You can explore the demo app to see real-world implementations and get inspiration for your own projects. The demo app provides practical examples that you can adapt for your specific needs.
-
 ## Step 1: Install the Apify plugin for Bubble
 
 To integrate Apify with your Bubble application, you first need to install the Apify plugin from the Bubble plugin marketplace.
 
-![Apify Plugin Download](../images/bubble/install_plugin.png)
+![Apify Plugin Download](../images/bubble/plugin_install_preview.png)
 
 1. Go to your Bubble application dashboard.
 2. Navigate to the "Plugins" tab.
 3. Click the "Add plugins" button.
 4. Search for "Apify" in the plugin marketplace.
 5. Click on the Apify plugin and then click "Install".
 
-## Step 2: Use the Apify plugin
-
-After installing the plugin, it's ready to be used in your Bubble application. Unlike some other plugins, the Apify plugin doesn't require global configuration. Instead, you'll provide your API token each time you use an Apify action in your workflow:
-
-1. When setting up an Apify action in your workflow, you'll be prompted to enter your API token.
-2. You can find your API token in the Apify Console under **Settings > Integrations**.
-3. For security reasons, it's recommended to store your API token in a Bubble workflow's private field or a custom state that's not exposed to the frontend, rather than entering it directly in each action.
-
-## Step 3: Understanding Data Calls vs. Actions
-
-The Apify plugin for Bubble provides two types of API integrations: Data Calls and Actions. Understanding the difference is crucial for effective implementation:
-
-### Data Calls
-
-Data calls are used to retrieve information from Apify and display it in your Bubble application. These calls can be used as data sources for elements like repeating groups, inputs, or any component that displays data. Data calls don't modify anything - they only fetch and display information.
-
-![Using Data of Apify plugin ](../images/bubble/plugin_data_options_preview.png)
+## Step 2: Configure the Apify plugin
 
-![Using Apify data calls](../images/bubble/data_preview.png)
-
-The Apify plugin provides the following data calls:
-
-- **Dataset Operations**
-  - Fetch Data From Dataset Text As Data
-  - Fetch Data From Dataset File As Data
-  - Fetch Data From Dataset Json As Data
-  - List User Datasets
-
-- **Key-Value Store Operations**
-  - List Key-Value Stores
-  - List Store Keys
-  - Get Record As File
-  - Get Record As Image File
-
-- **Actor and Task Operations**
-  - List Store Actors
-  - List User Actors
-  - List User Tasks
-  - List Actor Runs
-  - List Specific Actor Runs
-
-- **Web Scraping**
-  - Scrape Single URL As File As Data
-  - Scrape Single URL As Json As Data
-
-- **Webhook Management**
-  - List Webhooks
-
-### Actions
+After installing the plugin, you'll need to provide your API token when setting up Apify actions:
 
-Actions are used to perform operations that change data or trigger processes. In Bubble, actions are used in workflows that are triggered by events like button clicks, page loads, or scheduled events.
+1. You can find your API token in the Apify Console under **Settings > Integrations**.
+2. For security, store your API token in a Bubble workflow's private field rather than entering it directly in each action.
 
-![Using Actions of Apify plugin](../images/bubble/plugin_options_preview.png)
+## Step 3: Set up automated workflows
 
-![Using Apify action calls](../images/bubble/action_preview.png)
+### Trigger Actor runs from Bubble events
 
-The Apify plugin provides the following actions:
+Create workflows that automatically run Apify Actors when certain events occur in your Bubble app:
 
-- **Dataset Operations**
-  - Fetch Data From Dataset Text As Action
-  - Fetch Data From Dataset File As Action
+1. Create a workflow triggered by your preferred event (form submission, button click, page load, etc.)
+2. Add the "Run Actor" or "Run Actor Task" action to your workflow
+3. Configure the Actor parameters and input data
+4. Set up follow-up actions to handle the results
 
-- **Key-Value Store Operations**
-  - Get Record As Text
+### Display Apify data in your application
 
-- **Actor and Task Operations**
-  - Run Actor
-  - Run Actor Task
+Use Apify data sources to populate your Bubble app with Actor information and results:
 
-- **Web Scraping**
-  - Scrape Single URL As File As Action
-  - Scrape Single URL As Json As Action
+1. Use data calls like "List User Tasks", "List Actor Runs", or "List Store Actors" as data sources for repeating groups
+2. Configure the specific Actor or task you want to display
+3. Use "Fetch Data From Dataset Json As Data" to show actual scraped results from your Actor runs
 
-- **Webhook Management**
-  - Create Webhook
-  - Delete Webhook
-
-## Step 4: Use Apify in your Bubble application
-
-With the plugin installed, you can start using Apify in your Bubble application through the various data calls and actions provided. Here are some common ways to use the plugin:
-
-- Use data calls to display scraped data in your application
-- Set up workflows that trigger Apify Actors using actions
-- Create automated processes that fetch and process data regularly
+![Using Apify data calls](../images/bubble/data_preview.png)
 
-## Step 5: Example use cases
+### Automate data collection workflows
 
-Here are some examples of how you can use the Apify integration in your Bubble application:
+Set up recurring data collection that updates your Bubble app automatically:
 
-### Scraping data for your application
+1. Create a scheduled workflow or API workflow
+2. Use the "Run Actor Task" action to collect fresh data
+3. Process and store the results in your Bubble database
+4. Update your app's display elements with new data
 
-Use Apify Actors to scrape data from websites and then display that data in your Bubble application. For example, you could scrape product information from e-commerce sites and display it in your own marketplace.
+## Step 4: Example use cases
 
-1. Use the "Run Actor" action to trigger a scraping Actor
-2. Use the "Fetch Data From Dataset Json As Data" data call to display the results in a repeating group
+### E-commerce price monitoring
 
-### Automating workflows
+1. Set up a workflow that triggers daily or weekly
+2. Use the "Run Actor" action to scrape competitor prices
+3. Display the results in your Bubble app's dashboard
+4. Set up notifications when prices change significantly
 
-Set up workflows in your Bubble application that trigger Apify Actors based on certain events. For example, you could run a scraper every time a user submits a form.
+### Lead generation automation
 
-1. Create a workflow triggered by a form submission
-2. Add the "Run Actor Task" action to start your scraping task
-3. Process the results using additional actions or workflows
+1. Create a form submission workflow
+2. Use scraped data to enrich lead information automatically
+3. Store enriched data in your Bubble database
+4. Trigger follow-up actions based on the enriched data
 
-### Enriching user data
+### Content aggregation
 
-Use Apify Actors to enrich your user data with additional information from external sources. For example, you could use an Actor to get social media profiles based on email addresses.
+1. Schedule regular Actor runs to collect content from multiple sources
+2. Use "Fetch Data From Dataset Json As Data" to display aggregated content
+3. Create filtered views based on content categories or dates
 
-1. Create a workflow that triggers when new user data is added
-2. Use the "Run Actor" action with appropriate parameters
-3. Store the enriched data back in your Bubble database
+## Available Apify actions and data sources
 
-## Summary of available features
+The Apify plugin provides two main types of operations:
 
-### Data Calls
-- Retrieve data from Apify datasets in various formats (text, file, JSON)
-- List available datasets, key-value stores, actors, and tasks
-- Get records from key-value stores
-- List actor runs and webhooks
-- Scrape web pages directly
+**Actions** (for workflows):
+- Run Actor
+- Run Actor Task
+- Scrape Single URL
+- Manage webhooks and data stores
 
-### Actions
-- Run Actors and Actor tasks
-- Fetch data from datasets
-- Get records from key-value stores
-- Scrape web pages
-- Manage webhooks
+**Data Sources** (for displaying information):
+- Fetch data from datasets in various formats
+- List Actors, tasks, and runs
+- Access key-value store records
 
 ## Troubleshooting
 
-Here are some common issues you might encounter when using the Apify plugin for Bubble:
-
-- **Authentication errors**: Make sure your API token is correct, in this format "Bearer <api_token>", and has the necessary permissions
-- **Data format issues**: When using JSON data, ensure it's properly formatted
-- **Performance concerns**: For large datasets, consider pagination or filtering data on the Apify side
-- **Missing Actors or tasks**: If you can't find your Actor or task in the dropdown, try running it at least once in the Apify Console
-- **Timeout errors**: For actions that take longer to complete, consider using asynchronous runs
-
-## Detailed implementation guide
-
-For a detailed guide on how to implement specific features using the Apify plugin for Bubble, including code examples and best practices, please refer to the next section of this documentation.
+- **Authentication errors**: Ensure your API token is in the format "Bearer <api_token>" and has necessary permissions
+- **Missing Actors or tasks**: Run your Actor at least once in the Apify Console to make it appear in Bubble dropdowns
+- **Timeout errors**: For long-running Actors, consider using asynchronous runs
+- **Data format issues**: Ensure JSON data is properly formatted when working with datasets
 
 If you have any questions or need help, feel free to reach out to us on our [Discord channel](https://discord.com/invite/jyEM2PRvMU).