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