Skip to content

docs: Add Bubble integration docs for workflows and notifications #1721

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 6 commits into
base: master
Choose a base branch
from

Conversation

daveomri
Copy link

@daveomri daveomri commented Jul 24, 2025

Summary

Created new Bubble integration documentation for the workflows-and-notifications directory, enabling users to automate workflows and set up notifications using Apify Actors within Bubble applications.

What's Added

  • New Bubble integration guide: Complete documentation covering installation, configuration, and workflow automation
  • Structured workflow examples: Practical use cases including price monitoring, lead generation, and content aggregation
  • Proper scope alignment: Focused on workflow automation and notifications to match the directory's purpose
  • Consistent formatting: Follows the same structure and length as other integration docs in the directory (90 lines, matching the 44-143 line range)
  • Technical accuracy:
    • Correct API token storage practices (User data type with Privacy rules)
    • Accurate data call descriptions (List User Tasks, List Actor Runs, List Store Actors)
    • Proper Bubble development terminology and best practices

Key Features Documented

  • Plugin installation from Bubble marketplace
  • API token configuration and security
  • Automated workflow triggers (form submissions, scheduled events, etc.)
  • Data display and management
  • Troubleshooting common issues

Context

This documentation is being created by DXHeroes and Applifting as part of developing the official Bubble plugin for Apify. The guide enables no-code developers to integrate Apify's web scraping and automation capabilities directly into their Bubble applications.

Testing

  • Verified all internal links work correctly
  • Confirmed image references point to existing files
  • Reviewed content accuracy for Bubble development practices
  • Ensured consistency with other workflow integration docs

@daveomri daveomri requested a review from TC-MO as a code owner July 24, 2025 14:15
@daveomri daveomri changed the title Add Bubble integration docs for workflows and notifications docs: Add Bubble integration docs for workflows and notifications Jul 24, 2025
Copy link
Contributor

@TC-MO TC-MO left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reformatted the text
Changed structure slightly
Lowered reliance on ordered & unordered lists

Comment on lines +29 to +33
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".
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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".
1. Go to your Bubble application dashboard and navigate to the **Plugins** tab.
1. Click the **Add plugins** button.
1. Search for "Apify" in the plugin marketplace.
1. Click on the Apify plugin and then click **Install**.

1. You can find your API token in the Apify Console under **Settings > API & Integrations**.
2. For security, store your API token in your User data type with Privacy rules applied rather than entering it directly in each API call.

## Step 3: Set up automated workflows
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## Step 3: Set up automated workflows
## Using the integration
Once the plugin is configured, you can start building automated workflows.

Comment on lines +46 to +53
Create workflows that automatically run Apify Actors when certain events occur in your Bubble app:

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

![Using Apify run Actor](../images/bubble/auto_run_preview.png)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Create workflows that automatically run Apify Actors when certain events occur in your Bubble app:
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
![Using Apify run Actor](../images/bubble/auto_run_preview.png)
Create workflows that run Apify Actors in response to events in your Bubble app, such as button clicks or form submissions. In the **Workflow** tab, set up a new workflow with your chosen trigger event. Add a new action and select **Run Actor** or **Run Actor Task** from the Apify plugin. Configure the Actor or Task, including any input data, and include follow-up actions to process the returned data.
![Using Apify run Actor](../images/bubble/auto_run_preview.png)

Comment on lines +57 to +63
Use Apify data sources to populate your Bubble app with Actor information and results:

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

![Using Apify data calls](../images/bubble/data_preview.png)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Use Apify data sources to populate your Bubble app with Actor information and results:
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
![Using Apify data calls](../images/bubble/data_preview.png)
Populate elements in your Bubble application with information from your Apify account or Actor run data. Apply data sources like **List User Tasks**, **List Actor Runs**, or **List Store Actors** to repeating groups. To show actual scraped data, use **Fetch Data From Dataset Json As Data** to retrieve results from your run's dataset.
![Using Apify data calls](../images/bubble/data_preview.png)

Comment on lines +65 to +72
### Automate data collection workflows

Set up recurring data collection that updates your Bubble app automatically:

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
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### Automate data collection workflows
Set up recurring data collection that updates your Bubble app automatically:
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
### Automate data collection workflows
Maintain fresh data in your Bubble app by setting up recurring workflows. Create a backend workflow with a schedule, such as daily runs. Incorporate the **Run Actor Task** action to trigger a pre-configured Actor for data collection. Follow this with steps to process the results, save them to your Bubble database, and update your app's display elements automatically.

Comment on lines +78 to +83
### E-commerce price monitoring

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
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### E-commerce price monitoring
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
### E-commerce price monitoring
Schedule a daily workflow to run a price-scraping Actor on competitor sites. Store the results in your Bubble database, display them in a dashboard, and set up alerts for significant price changes.

Comment on lines +85 to +90
### Lead generation automation

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
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### Lead generation automation
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
### Lead generation automation
Trigger a workflow on form submission to run an Actor that enriches lead data, such as pulling company details from a domain. Save the enriched information to your database and automate follow-up actions like email campaigns.

Comment on lines +92 to +96
### Content aggregation

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
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### Content aggregation
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
### Content aggregation
Configure regular Actor runs to gather articles or posts from multiple sources. Use the **Get Dataset Items** data call to display the content in your app, and enable user filters by category, date, or source.

Comment on lines +115 to +118
- **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
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- **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
#### Authentication errors
Ensure your API token is correctly formatted as `Bearer <your_api_token>` in the Authorization header and has the necessary permissions.
####Missing Actors or tasks
If an Actor or task doesn't appear in a dropdown, make sure you have run it at least once from the Apify Console.
####Timeout errors
Bubble workflows have a timeout limit. For long-running Actors, use the **Run Actor** action and a separate backend workflow triggered by a webhook to process the results asynchronously when the Actor finishes.
####Data format issues
Check that your JSON input is correctly formatted when providing input to an Actor. Verify the structure of the dataset output when displaying it in your app.

Comment on lines +113 to +114
## Troubleshooting

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## Troubleshooting
## Troubleshooting
<!-- markdownlint-disable MD001 -->

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants