Funnel Creation & Management
Need to send your customer’s event information to an external source using Webhooks? This article will explain how Webhooks work and how to create a Webhook in ClickFunnels. This is only recommended for those with Webhook experience.
*Important Note: The Customer Support Team at ClickFunnels is unable to assist with Webhook implementation. If you need assistance, please contact a qualified developer.
By the end of this document, you should be able to answer:
- What is a Webhook?
- Why would I need to use Webhooks in ClickFunnels?
- How do I create a Webhook in ClickFunnels?
Prior to getting started, you will need to have the following:
- An active ClickFunnels account
-
Previous knowledge about webhooks
Webhooks In ClickFunnels
A Webhook is an event-driven communication method between two apps. It allows you to send real-time data from one application to another whenever a given event occurs. For example, it can notify every time a customer opts-in or makes a purchase in your funnel as it is happening.
Please watch the video below, in full screen:
Step 1: Creating An Endpoint
This is done on your external source, not in ClickFunnels. You will need to have the endpoint set up before you can create a Webhook in ClickFunnels.
1. Creating A Test Endpoint.
First, you will need to create a test endpoint at <your-domain/funnel_webhooks/test>
And it should include the headers below.
-
-
- Content-Type as application/json
- X-Clickfunnels-Webhook-Delivery-Id as an MD5 of the URL and Payload.
- The payload (HTTP message body) will be a JSON object with a key of "time" and value of the current time in UTC as follows:
{ "time": "YYYY-MM-DD HH:MM:SS UTC" }
- Content-Type as application/json
-
This is done to verify that your Webhook meets these criteria.
-
-
- Must be a URL to an external resource not hosted by clickfunnels.com.
- Must return a response within 3 seconds.
- If we receive a response back with a status code less than 400 within the allowable response time we will accept the Webhook URL.
- Must be a URL to an external resource not hosted by clickfunnels.com.
-
*Important Note: If Clickfunnels doesn't get a 200 response from /funnel_webhook/test, then Webhooks will not be sent to that server.
2. Creating A Real Endpoint.
This should be an endpoint on your server where you want to capture Webhook Events.
*Important Note: URLs created on http://hookbin.com/ and http://webhook.site are accepted by default.
Step 2: Creating A Webhook
This is done in ClickFunnels after you have created your endpoint on your external source.
1. Creating A Test Webhook.
a. Access the Funnels Page by hovering over the ClickFunnels drop-down menu from your dashboard and clicking on Funnels.
b. Choose the funnel you want to edit by clicking on the Funnel Name.
c. Click on the Settings tab.
d. Scroll down to Webhooks and click on the Manage Your Funnel Webhooks button to access the Funnel Webhooks Page.
e. Click on the + New Webhook button.
f. Enter your Webhook URL. This should be the test URL. For example, www.yourdomain.com/funnel_webhooks/test
g. Select the Event(s) you want to trigger your Webhook from the Event drop-down menu.
-
- All Events
- contact_created
- contact_updated
- contact_destroyed
- purchase_created
- purchase_updated
- purchase_destroyed
h. Select the Webhook version from the Version drop-down menu. We recommend choosing the default option.
The version is just an internal attribute that you can use to reference which Webhook you’re using.
i. Select the adapter from the Adapter drop-down menu. We recommend choosing the default option.
The adapter refers to how the Webhook will deliver the data or payload to the configured Webhook URL.
j. Click on the Create Funnel Webhook button.
2. Creating A Real Webhook
a. Access the Funnels Page by hovering over the ClickFunnels drop-down menu from your dashboard and clicking on Funnels.
b. Choose the funnel you want to edit by clicking on the Funnel Name.
c. Click on the Settings tab.
d. Scroll down to Webhooks and click on the Manage Your Funnel Webhooks button to access the Funnel Webhooks Page.
e. Click on the + New Webhook button.
f. Enter your Webhook URL. This should be the real URL. For example, www.yourdomain.com/webhook_events
g. Select the Event(s) you want to trigger your Webhook from the Event drop-down menu.
-
-
-
-
- All Events
- contact_created
- contact_updated
- contact_destroyed
- purchase_created
- purchase_updated
- purchase_destroyed
-
-
-
h. Select the Webhook version from the Version drop-down menu. We recommend choosing the default option.
The version is just an internal attribute that you can use to reference which Webhook you’re using.
i. Select the adapter from the Adapter drop-down menu. We recommend choosing the default option.
The adapter refers to how the Webhook will deliver the data or payload to the configured Webhook URL.
j. Click on the Create Funnel Webhook button.
Funnel Webhooks Page
When accessing the Funnel Webhooks Page, you will be able to see your Active and Archived Funnel Webhooks. For both Active and Archived Funnel Webhooks, you will see the Webhook information.
- URL - Webhook URL.
- Events - The Event(s) the Webhook triggered.
Archiving An Active Webhook
1. Click the Archive button.
2. Click OK to confirm.
Restoring An Actived Webhook
1. Click the Restore button.
2. Click OK to confirm.
Funnel Webhook Deliveries Page
If you want to see whether your Webhook was delivered or not, you can click on the Deliveries button.
Here, you will be able to see the delivery information.
- Created - When was the Webhook sent.
- Payload - The information that was sent via the Webhook.
- Attempts - How many times it took for the Webhook to be delivered.
- Success? - If the Webhook was delivered or not.
*Important Note: After two weeks, the data may not be available on the Funnel Webhook Deliveries Page.
Here are the key takeaways for this document:
- A Webhook is an event-driven API that sends information to an external source. It allows you to send real-time data from one application to another whenever a given event occurs. For example, it can notify every time a customer opts-in or makes a purchase in your funnels as it is happening.
- The Customer Support Team at ClickFunnels is unable to assist with Webhook implementation. If you need assistance, please contact a qualified developer.
- You will need to have a Webhook URL from your external source before you can create a Webhook in ClickFunnels. If Clickfunnels doesn't get a 200 response from /funnel_webhook/test, then Webhooks will not be sent to that server.
If you have any questions about this, please contact our support team by clicking the support icon in the bottom right-hand corner of this page.