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.
Prior to getting started, you will need to have the following:
-
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.
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" }
-
-
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.
-
-
2. Creating A Real Endpoint.
This should be an endpoint on your server where you want to capture Webhook Events.
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.
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.
