Skip to content

Commit 0d8b853

Browse files
drobnikjCopilot
andauthored
feat(integrations): Update make.com documentation (#1373)
Address several issue and missing part in documentation. --------- Co-authored-by: Copilot <[email protected]>
1 parent 6b81bd8 commit 0d8b853

File tree

8 files changed

+77
-52
lines changed

8 files changed

+77
-52
lines changed
Loading
Loading
Loading
Loading
Loading
Loading
Loading

sources/platform/integrations/workflows-and-notifications/make.md

+77-52
Original file line numberDiff line numberDiff line change
@@ -19,98 +19,123 @@ To use the Apify integration on Make, you will need:
1919
- An [Apify account](https://console.apify.com/).
2020
- A Make account (and a [scenario](https://www.make.com/en/help/scenarios/creating-a-scenario)).
2121

22-
## Step 1: Add the Apify module to your Make scenario
22+
### Add the Apify module to scenario
2323

2424
Add the Apify module to your scenario. You can find this module by searching for "Apify" in the module search bar.
2525

2626
Next, select one of the available options under Triggers, Actions and Searches, then click on the Apify module to open its configuration window.
2727

2828
![Apify module](../images/apify-module.png)
2929

30-
## Step 2: Create a connection to your Apify account
30+
### Create a connection to Apify
3131

3232
In the Connection configuration window, you will need to provide your Apify API token.
3333

3434
![API token](../images/apify-token.png)
3535

36-
You can find the token in the Apify Console by navigating to **Settings > Integrations**.
36+
You can find the token in the Apify Console by navigating to **[Settings > API & Integrations](https://console.apify.com/settings/integrations)**.
3737

3838
![Integrations token](../images/apify-integrations-token.png)
3939

4040
Finally, copy your API token to the Make module and save it to create a connection.
4141

4242
Congratulations! You have successfully connected the Apify app and can now use it in your scenarios.
4343

44-
## Triggers
44+
## Run an Actor or task with Output
4545

46-
### Watch Actor Runs
46+
We have two methods to run an Actor or task and retrieve its data in Make.com, depending on your needs and the complexity of the Actor:
4747

48-
> Triggers when a selected Actor run is finished.
48+
- **Synchronous run using the action module**
49+
- **Asynchronous run using the trigger module**
4950

50-
<img src={require("../images/apify-make-trigger.png").default} width="50%" />
51+
:::info
52+
Make.com imposes a hard timeout for synchronous runs, the timeout varies based on your plan. If the Actor or task takes longer than the timeout to complete, the data will not be fully returned.
53+
If you anticipate that the Actor run will exceed the timeout, use the asynchronous method with a trigger module instead.
54+
:::
5155

52-
| Input | Description |
53-
| :----------- | :--------------------------------------------------------------------- |
54-
| Webhook name | Enter the desired name for the webhook. E.g. Finished Web Scraper Run. |
55-
| Connection | [Create an Apify connection](#connect-apify-to-make). |
56-
| Actor | Select the Actor you want to monitor for finished runs. |
56+
The primary difference between the two methods is that the synchronous run waits for the Actor or task to finish and retrieves its output using the "Get Dataset Items" module. By contrast, the asynchronous run watches for the run of an Actor or task (which could have been triggered from another scenario, manually from Apify console or elsewhere) and gets its output once it finishes.
5757

58-
### Watch Task Runs
58+
### Synchronous run using the action module
5959

60-
> Triggers when a selected task run is finished.
60+
In this example, we will demonstrate how to run an Actor synchronously and export the output to Google Sheets.
61+
The same principle applies to module that runs a task.
6162

62-
| Input | Description |
63-
| :----------- | :--------------------------------------------------------------------- |
64-
| Webhook name | Enter the desired name for the webhook. E.g. Finished Web Scraper Run. |
65-
| Connection | [Create an Apify connection](#connect-apify-to-make). |
66-
| Actor | Select the Actor you want to monitor for finished runs. |
63+
#### Step 1: Add the Apify "Run an Actor" Module
6764

68-
## Actions
65+
First, ensure that you have [connected your Apify account to Make.com](#create-a-connection-to-apify).
66+
Next, add the Apify module called "Run an Actor" to your scenario and configure it.
6967

70-
### Run a task
68+
For this example, we will use the "Google Maps Review Scraper" Actor.
69+
Make sure to set the "Run synchronously" option to "Yes," so the module waits for the Actor to finish run.
7170

72-
> Runs a selected Actor task.
71+
![make-com-sync-2.png](../images/make-com/make-com-sync-2.png)
7372

74-
<img src={require("../images/apify-make-run-task.png").default} width="50%" />
73+
#### Step 2: Add the Apify "Get Dataset Items" module
7574

76-
| Input | Description |
77-
| :------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------- |
78-
| Task | Select or map the task you want to run. |
79-
| Run synchronously | Make will wait until the task run is finished. Beware that the maximum timeout for the run is 120 seconds. |
80-
| Input JSON overrides | Here you can enter a JSON object to override the task input configuration. Only the provided fields will be overridden, the rest will be left unchanged. |
75+
In the next step, add the "Get Dataset Items" module to your scenario, which is responsible for retrieving the output data from the Actor run.
8176

82-
### Run an Actor
77+
In the "Dataset ID" field, provide the default dataset ID from the Actor run.
78+
You can find this dataset ID in the variables generated by the previous "Run an Actor" module. If the variables do not appear, run the scenario first, then check again.
8379

84-
> Runs a selected Actor.
80+
![make-com-sync-3.png](../images/make-com/make-com-sync-3.png)
8581

86-
<img src={require("../images/apify-make-run-actor.png").default} width="50%" />
82+
#### Step 3: Add the Google Sheets "Create Spreadsheet Rows" module
8783

84+
Finally, add the Google Sheets "Bulk Add Rows" module to your scenario. This module will automatically create new rows in a Google Sheets file to store the Actor's output.
8885

89-
| Input | Description |
90-
| :------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
91-
| Actor | Select or map the ID of the Actor you want to run. |
92-
| Run synchronously | Make will wait until the task run is finished. Beware that the maximum timeout for the run is 120 seconds. |
93-
| Input JSON overrides | Here you can enter a JSON object to override the task input configuration. Only the provided fields will be overridden, the rest will be left unchanged. |
94-
| Build | Specify the Actor build to run. It can be either a build tag or build number. By default, the run uses the build specified in the default run configuration for the Actor (typically 'latest'). |
95-
| Timeout | Enter the timeout for the run in seconds. By default, the run uses a timeout specified in the default run configuration for the Actor. |
96-
| Memory | Select or enter memory limit for the run, in megabytes. By default, the run uses a memory limit specified in the default run configuration for the Actor. |
86+
In the "Spreadsheet ID" field, provide the ID of the target Google Sheets file, which you can find in its URL. Configure the column range (e.g., "A-Z") and map the data retrieved from the "Get Dataset Items" module to the row values.
9787

98-
## Searches
88+
![make-com-sync-4.png](../images/make-com/make-com-sync-4.png)
9989

100-
### Get Dataset Items
90+
You’re all set! Once the scenario is started, it will run the Actor synchronously and export its output to your Google Sheets file.
10191

102-
> Retrieves items from a [dataset](/platform/storage/dataset).
92+
### Asynchronous run using the trigger module
10393

104-
<img src={require("../images/apify-make-dataset.png").default} width="50%" />
94+
In this example, we will demonstrate how to run an Actor asynchronously and export its output to Google Sheets.
95+
Before starting, decide where you want to initiate the Actor run. You can do this manually via the Apify console, on a schedule, or from a separate Make.com scenario.
10596

97+
#### Step 1: Add the Apify "Watch Actor Runs" Module
10698

107-
| Input | Description |
108-
| :------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
109-
| Connection | [Create an Apify connection](#connect-apify-to-make). |
110-
| Dataset ID | Enter the ID of the dataset you want to retrieve items from. |
111-
| Data transformation | **Clean** - it returns only non-empty items and skips hidden fields (fields starting with the # character).<br/>**Simplified** - it formats items to emulate simplified results provided by the Legacy Apify Crawler product. |
112-
| Format | Select the format of the dataset items. |
113-
| Limit | Set the maximum number of items Make will return during one execution cycle. |
114-
| Offset | Enter the number of items to skip. |
99+
First, ensure that you have [connected your Apify account to Make.com](#create-a-connection-to-apify).
100+
Next, add the Apify module called "Watch Actor Runs" to your scenario. This module will set up a webhook to listen for the finished runs of the selected Actor.
115101

116-
If you have any questions or need help, feel free to reach out to us on our [developer community on Discord](https://discord.com/invite/jyEM2PRvMU).
102+
For this example, we will use the "Google Maps Review Scraper" Actor.
103+
104+
![make-com-async-1.png](../images/make-com/make-com-async-1.png)
105+
106+
#### Step 2: Add the Apify "Get Dataset Items" module
107+
108+
Add the "Get Dataset Items" module to your scenario to retrieve the output of the Actor run.
109+
110+
In the "Dataset ID" field, provide the default dataset ID from the Actor run. You can find the dataset ID in the variables generated by the "Watch Actor Runs" module.
111+
112+
![make-com-async-2.png](../images/make-com/make-com-async-2.png)
113+
114+
#### Step 3: Add the Google Sheets "Create Spreadsheet Rows" module
115+
116+
Finally, add the Google Sheets "Bulk Add Rows" module to your scenario, which will create new rows in the specified Google Sheets file to store the Actor's output.
117+
118+
In the "Spreadsheet ID" field, enter the ID of the target Google Sheets file, which you can find in its URL. Configure the column range (e.g., "A-Z") and map the data retrieved from the "Get Dataset Items" module to the row values.
119+
120+
![make-com-async-3.png](../images/make-com/make-com-async-3.png)
121+
122+
That’s it! Once the Actor run is complete, its data will be exported to the Google Sheets file.
123+
You can initiate the Actor run via the Apify console, a scheduler, or from another Make.com scenario.
124+
125+
## Available modules and triggers
126+
127+
### Triggers
128+
129+
- **Watch Actor Runs:** Triggers when a selected Actor run is finished.
130+
- **Watch Task Runs:** Triggers when a selected task run is finished.
131+
132+
### Actions
133+
134+
- **Run a Task:** Runs a selected Actor task.
135+
- **Run an Actor:** Runs a selected Actor.
136+
- **Scrape Single URL:** Runs a scraper for the website and returns its content as text, markdown and HTML.
137+
- **Make an API Call:** Makes an arbitrary authorized API call.
138+
139+
### Searches
140+
141+
- **Get Dataset Items:** Retrieves items from a [dataset](/platform/storage/dataset).

0 commit comments

Comments
 (0)