-
Notifications
You must be signed in to change notification settings - Fork 117
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
base: master
Are you sure you want to change the base?
Conversation
…token storage instructions
There was a problem hiding this 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
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". |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
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 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
## Step 3: Set up automated workflows | |
## Using the integration | |
Once the plugin is configured, you can start building automated workflows. |
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 | ||
|
||
 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
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 | |
 | |
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. | |
 |
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 | ||
|
||
 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
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 | |
 | |
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. | |
 |
### 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 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
### 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. |
### 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 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
### 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. |
### 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 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
### 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. |
### 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 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
### 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. |
- **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 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- **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. | |
## Troubleshooting | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
## Troubleshooting | |
## Troubleshooting | |
<!-- markdownlint-disable MD001 --> |
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
Key Features Documented
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