|
4 | 4 |
|
5 | 5 | This plugin adds the ability to manage “webhooks” in Craft CMS, which will send GET or POST requests when certain events occur.
|
6 | 6 |
|
7 |
| -It can be used to integrate your Craft project with task automation tools like [Zapier](https://zapier.com) and [IFTTT](https://ifttt.com). |
| 7 | +It can be used to integrate your Craft project with task automation tools like [Zapier](https://zapier.com) or [Netlify](https://www.netlify.com) build hooks. |
8 | 8 |
|
9 | 9 | ## Requirements
|
10 | 10 |
|
@@ -186,37 +186,48 @@ Only enabled webhooks will send webhook requests when their corresponding events
|
186 | 186 |
|
187 | 187 | ## Integrating with Task Automation Tools
|
188 | 188 |
|
| 189 | +### Netlify |
| 190 | + |
| 191 | +To trigger a [Netlify](https://www.netlify.com) build using Webhooks, follow these steps: |
| 192 | + |
| 193 | +1. Within your Netlify dashboard, go to **Settings** → **Build & deploy** → **Continuous deployment** → **Build hooks**. |
| 194 | +2. Select **Add build hook**. |
| 195 | +3. Fill out the build hook settings and save it. |
| 196 | +4. Copy the build hook URL. |
| 197 | +5. Within your Craft control panel, go to **Webhooks** → **New webhook**. |
| 198 | +6. Paste the build hook URL into the **Webhook URL** field, fill out the remaining settings, and save the webhook. |
| 199 | + |
189 | 200 | ### Zapier
|
190 | 201 |
|
191 | 202 | To integrate Webhooks with [Zapier](https://zapier.com), follow these steps:
|
192 | 203 |
|
193 |
| -1. Create a new zap by clicking the “Make a Zap!” button on your [Zapier dashboard](https://zapier.com/app/dashboard). |
194 |
| -2. Select “Webhooks” under “Built-in Apps”. |
195 |
| -3. Select “Catch Hook” and click “Save + Continue”. |
196 |
| -4. Click “Continue” without entering anything in the “Pick off a Child Key” field. |
| 204 | +1. Within your [Zapier dashboard](https://zapier.com/app/dashboard), click **Make a Zap!**. |
| 205 | +2. Select **Webhooks** under **Built-in Apps**. |
| 206 | +3. Select **Catch Hook** and click **Save + Continue**. |
| 207 | +4. Click **Continue** without entering anything in the **Pick off a Child Key** field. |
197 | 208 | 5. Copy the webhook URL.
|
198 |
| -6. Go to Webhooks in your Control Panel and click “New webhook”. |
199 |
| -7. Paste the webhook URL into the “Webhook URL” field, fill out the remaining fields, and save the webhook. |
| 209 | +6. Within your Craft control panel, go to to **Webhooks** → **New webhook**. |
| 210 | +7. Paste the webhook URL into the **Webhook URL** field, fill out the remaining settings, and save the webhook. |
200 | 211 | 8. Perform an action in Craft that will trigger your webhook.
|
201 |
| -9. Back in Zapier, click the “Ok, I did this” button. |
202 |
| -10. Ensure that Zapier pulled in the webhook, and click “Continue”. |
| 212 | +9. Back in Zapier, click the **Ok, I did this** button. |
| 213 | +10. Ensure that Zapier pulled in the webhook, and click **Continue**. |
203 | 214 | 11. Finish setting up the zap and make sure it’s enabled.
|
204 | 215 |
|
205 | 216 | ### IFTTT
|
206 | 217 |
|
207 | 218 | To integrate Webhooks with [IFTTT](https://ifttt.com), follow these steps:
|
208 | 219 |
|
209 |
| -1. Create a new applet by clicking the “New Applet” button on your [My Applets](https://ifttt.com/my_applets) page. |
210 |
| -2. Click on “+this”. |
211 |
| -3. Search for “webhooks” and select “Webhooks” below. |
212 |
| -4. Click “Connect”. |
213 |
| -5. Click on the “Receive a web request” box. |
| 220 | +1. Within your [My Applets](https://ifttt.com/my_applets) page in IFTTT, click **New Applet**. |
| 221 | +2. Click on **+this**. |
| 222 | +3. Search for “webhooks” and select **Webhooks** below. |
| 223 | +4. Click **Connect**. |
| 224 | +5. Click on the **Receive a web request** box. |
214 | 225 | 6. Give your trigger an event name based on your Craft webhook name, but in `snake_case`.
|
215 | 226 | 7. Finish setting up the applet.
|
216 |
| -8. Go to your [Webhooks page](https://ifttt.com/maker_webhooks) on IFTTT, and click the “Documentation” link. |
| 227 | +8. Go to your [Webhooks page](https://ifttt.com/maker_webhooks) on IFTTT, and click the **Documentation** link. |
217 | 228 | 9. Type the event name you entered in step 6 into the `{event}` text box.
|
218 | 229 | 10. Copy the URL beginning with `https://maker.ifttt.com/trigger/`.
|
219 |
| -11. Go to Webhooks in your Control Panel and click “New webhook”. |
220 |
| -12. Paste the webhook URL into the “Webhook URL” field, fill out the remaining fields, and save the webhook. |
| 230 | +6. Within your Craft control panel, go to to **Webhooks** → **New webhook**. |
| 231 | +12. Paste the webhook URL into the **Webhook URL** field, fill out the remaining settings, and save the webhook. |
221 | 232 |
|
222 | 233 | **Note:** Unfortunately IFTTT’s webhooks API is pretty limited, so no webhook data will be available to your applet action.
|
0 commit comments