Skip to content

Commit 116a2ef

Browse files
jakcinmarinajakcinmarina
committed
docs: update documentation per suggestions
1 parent c69db2b commit 116a2ef

File tree

1 file changed

+83
-75
lines changed
  • sources/platform/integrations/workflows-and-notifications

1 file changed

+83
-75
lines changed

‎sources/platform/integrations/workflows-and-notifications/ifttt.md‎

Lines changed: 83 additions & 75 deletions
Original file line numberDiff line numberDiff line change
@@ -1,123 +1,131 @@
11
---
22
title: IFTTT integration
3-
description: Connect Apify Actors with IFTTT to automate workflows using actor run events, data queries, and task actions.
3+
description: Connect Apify Actors with IFTTT to automate workflows using Actor run events, data queries, and task actions.
44
sidebar_label: IFTTT
55
sidebar_position: 6
66
slug: /integrations/ifttt
77
---
88

9-
**Learn how to integrate your Apify Actors in IFTTT Applets.**
10-
11-
This guide explains how to use the Apify integration in IFTTT to build automations (Applets) triggered by actor or task runs and start new runs automatically.
12-
13-
An Applet is built from three key parts: a trigger that kicks off the workflow, optional queries that fetch the data, and one or more actions that execute when the Applet runs.
9+
**Connect Apify Actors with IFTTT to automate workflows using Actor run events, data queries, and task actions.**
1410

1511
---
1612

17-
With [Apify integration for IFTTT](https://ifttt.com/apify), you can connect your Apify Actors to hundreds of services like Twitter, Gmail, Google Sheets, Slack, and more.
18-
19-
Your Applets can start Apify Actors or tasks, fetch items from a dataset and get records from key-value stores.
20-
21-
## Connect Apify with IFTTT
22-
23-
To use the Apify integration on IFTTT, you will need to:
24-
25-
- Have an [Apify account](https://console.apify.com/).
26-
- Have an [IFTTT account](https://ifttt.com/).
27-
28-
To connect to Apify service:
29-
30-
- visit [Apify service page](https://ifttt.com/apify)
31-
- click "Connect" button
32-
- you will be redirected to the Apify login page
33-
- login to your Apify console
34-
35-
![Apify Connect Service](../images/ifttt-connect-service.png)
36-
37-
### Step 1: Create an Applet with Apify service
38-
39-
To create an Applet, go to the [Explore](https://ifttt.com/explore) section and find the "Create" button.
40-
41-
In the create Applet form, you can choose whether you want to use Apify as the trigger or action.
42-
43-
Click on "Add" button in "If This" part of the applet and find Apify using the search box.
13+
[IFTTT](https://ifttt.com) is a service that helps you create automated workflows called Applets. With the [Apify integration for IFTTT](https://ifttt.com/apify), you can connect your Apify Actors to hundreds of services like Twitter, Gmail, Google Sheets, Slack, and more.
4414

45-
![Apify Choose Service](../images/ifttt-choose-service.png)
15+
This guide shows you how to integrate Apify Actors with IFTTT to build automated workflows. You'll learn how to create IFTTT Applets that can be triggered by Apify events or that can execute Apify tasks.
4616

47-
Then select which trigger you want to use.
17+
An IFTTT Applet consists of three key parts:
18+
- A _trigger_ that starts the workflow
19+
- Optional _queries_ that retrieve data
20+
- One or more _actions_ that execute when the Applet runs
4821

49-
![Apify Choose Trigger](../images/ifttt-choose-trigger.png)
22+
The Apify integration lets you trigger workflows when an Actor or task run finishes, start Actor or task runs from other triggers, or retrieve data from datasets and key-value stores.
5023

51-
In case you didn't connect to the Apify account, you will be prompted to do so when you select a trigger.
52-
53-
### Step 2: Set up your Apify action in an Applet
24+
## Prerequisites
5425

55-
You are able to use any action to follow your Apify trigger. For example, you can use Gmail to send an email about a finished Actor run.
26+
Before using the Apify integration with IFTTT, you need:
5627

57-
In this guide we'll show you how to use Apify as an action to start an Actor run.
28+
- An [Apify account](https://console.apify.com/)
29+
- An [IFTTT account](https://ifttt.com/)
5830

59-
After you select Apify as an action in the "Then That" part of the applet, you need to select the action you want to use. Let's use the "Run Actor" action for this example.
31+
## Connect Apify with IFTTT
6032

61-
![Apify Choose Action](../images/ifttt-choose-action.png)
33+
To connect your Apify account to IFTTT:
34+
1. Visit the [Apify service page](https://ifttt.com/apify) on IFTTT.
35+
2. Click the **Connect** button.
36+
3. When redirected to the Apify login page, sign in to your Apify account.
6237

63-
In the next step, you need to select the Actor you want to use. You can choose one by selecting it from the dropdown. You can choose between your recently used Actors and Actors from the store. IFTTT only displays up to 50 items in a dropdown at a time. If the actor or item you're looking for doesn't show up, it's not necessarily missing — it just might not be in the top 50 results yet.
38+
![Apify Connect Service](../images/ifttt-connect-service.png)
6439

65-
>To make an Actor appear in the dropdown, try using it at least once via API or in the console.
40+
## Create an Applet with Apify
6641

67-
We will use the Google Search Results Scraper Actor in this example.
42+
### Create an Applet
6843

69-
![Apify Actor Customization](../images/ifttt-actor-config.png)
44+
To create an Applet that starts when Apify event occurs:
7045

71-
You can customize how the Actor runs by filling out the following parameters:
46+
1. Go to the [Explore](https://ifttt.com/explore) section on IFTTT.
47+
1. Click the **Create** button.
48+
1. In the **If this** section, click **Add**.
49+
1. Search for and select **Apify** in the service list.
7250

73-
| Field | Description | Example Values |
74-
| ------------- | --------------------------------------------------------------------------- | ------------------------- |
75-
| `Wait until run finishes` | Defines how the actor should be executed. | `yes`, `no` |
76-
| `Input overrides` | JSON input that will override actor's default input. | `{"key": "value"}` |
77-
| `Build` | Specifies the Actor build to run. Can be build tag or build number. | `0.2.10`, `version-0` |
78-
| `Memory` | Memory limit for the run in megabytes. | `256mb` |
51+
![Apify Choose Service](../images/ifttt-choose-service.png)
7952

80-
Once you're happy with the Actor customization, continue by pressing "Create action" button.
53+
1. Select a trigger from the available options:
54+
- **Actor Run Finished**: Triggers when a selected Actor run completes
55+
- **Task Run Finished**: Triggers when a selected Actor task run completes
8156

82-
![Apify Actor Customization](../images/ifttt-applet-overview.png)
57+
![Apify Choose Trigger](../images/ifttt-choose-trigger.png)
8358

84-
Once the applet is created, wait for you trigger to run and inspect the results by pressing the "View activity" button in the Applet overview page.
59+
1. Configure the trigger by selecting the specif Actor or task.
60+
1. Click **Create trigger** to continue.
8561

86-
![Apify Actor Customization](../images/ifttt-applet-inspect.png)
62+
In case you didn't connect to the Apify account, you will be prompted to do so when you select a trigger.
8763

88-
## Triggers
64+
### Set up an Apify Action
8965

90-
### Actor Run Finished
66+
To use Apify as an action in your Applet:
9167

92-
> Triggers when a selected Actor run is finished.
68+
1. In the **Then That** section of your Applet, click **Add**.
69+
1. Search for and select **Apify**.
70+
1. Choose an action:
71+
- **Run Actor**: Starts an Actor run
72+
- **Run Task**: Starts an Actor Task run
73+
74+
![Apify Choose Action](../images/ifttt-choose-action.png)
75+
76+
1. Select the Actor or task you want to use from the dropdown menu.
77+
:::note
78+
79+
IFTTT displays up to 50 recent items in a dropdown. If your Actor or task isn't visible, try using it at least once via API or in the Apify Console to make it appear in the list.
80+
81+
:::
82+
83+
![Apify Actor Customization](../images/ifttt-actor-config.png)
84+
85+
1. Configure the action parameters:
9386

94-
### Task Run Finished
87+
| Parameter | Description | Example Values |
88+
|-----------|-------------|----------------|
89+
| **Wait until run finishes** | Defines how the Actor should be executed. | `yes`, `no` |
90+
| **Input overrides** | JSON input that overrides the Actor's default input. | `{"key": "value"}` |
91+
| **Build** | Specifies the Actor build to run. Can be a build tag or build number. See [Builds](/platform/actors/running/runs-and-builds#builds) for more information. | `0.2.10`, `version-0` |
92+
| **Memory** | Memory limit for the run in megabytes. See [Memory](/platform/actors/running/usage-and-resources#memory) for more information. | `256` |
93+
94+
1. Click **Create action** to finish setting up the action.
9595

96-
> Triggers when a selected Actor task run is finished.
96+
![Apify Actor Customization](../images/ifttt-applet-overview.png)
9797

98-
## Actions
98+
1. Give your Applet a name and click **Finish** to save it.
9999

100-
### Run Actor
100+
## Monitor your Applet
101101

102-
> Runs a selected Actor.
102+
To check if your Applet is working properly:
103+
1. Go to your Applet's detail page.
104+
1. Clicke the **View activity** button to see the execution history.
103105

104-
### Run Task
106+
![Apify Actor Customization](../images/ifttt-applet-inspect.png)
105107

106-
> Runs a selected Actor task.
108+
## Available triggers, actions, and queries
107109

110+
### Triggers
108111

109-
## Queries
112+
- **Actor Run Finished**: Activates when a selected Actor run completes
113+
- **Task Run Finished**: Activates when a selected Actor task run completes
110114

111-
### Get Dataset Items
115+
### Actions
112116

113-
> Retrieves items from a [dataset](/platform/storage/dataset).
117+
- **Run Actor**: Starts a specified Actor with customizable parameters
118+
- **Run Task**: Executes a specified Actor task
114119

115-
### Scrape Single URL
120+
### Queries
116121

117-
> Runs a scraper for the website and returns its content.
122+
- **Get Dataset Items**: Retrieves items from a [dataset](/platform/storage/dataset)
123+
- **Scrape Single URL**: Runs a scraper for a specified website and returns its content
124+
- **Get Key-Value Store Record**: Retrieves a value from a [key-value store](/platform/storage/key-value-store)
118125

119-
### Get Key-Value Store Record
126+
## Troubleshooting
120127

121-
> Retrieves value from a [Key-value store](/platform/storage/key-value-store).
128+
- Ensure your JSON inputs in the "Input overrides" field are valid and properly formatted.
129+
- If an Applet fails to trigger, check your Apify API token permissions.
122130

123131
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).

0 commit comments

Comments
 (0)