Choose your language: 

Ready to boost your sales?

Start your free account today!

Choose your language:

Webhook integrations

Webhook integrations

To use Soproof optimally, you can send conversion data from your CMS to Soproof. This data can then be used within the notifications. To make this happen Soproof uses Webhooks. This allows conversion data to be sent to Soproof without the need for additional plugins.

Setting up webooks seems technical and complicated but it is far more simple than it seems.

What are webhooks?

Webhooks is a universal way to send data between systems. Most CMSs have support for webhooks. Some well-known examples are Woocommcerce, Shopify, Magento and squarespace.

To send the data you need a CMS that supports webhooks a webhook URL. This webhook-url can be found in Soproof. It is then a matter of setting this webhook in the right place after which conversion data will be sent to Soproof. It is important to note that the conversion data will be sent from your website to the webhook URL. So no special access needs to be given.

This example will cover Woocommerce and Elementor Forms but there are many other CMSs suitable for Webhooks.

Example: Woocommerce

Get the webhook-URL

To get started, we need the right webhook url. Create a campaign if you hadn’t already done so and choose an appropriate notification. In this example we use ‘latest conversion’ but you can basically use any type of notification for this.

Go to Campaigns / Notifications and select the notification you want to use. Click on the lower option ‘Data’ in the left menu. There you will find the webhook url under ‘Webhook trigger’. Copy this entire URL.

Paste the webhook URL in the Woocommerce settings

Log in to the WordPress installation where you want to set up the webhook. Go to the Woocommerce settings:

Left menu: Woocommerce / Settings / Advanced / Webhooks

Here you click on ‘Add webhook‘.
Give the webhook a clear name and set it to active. Choose for topic ‘order created’. The webhook will be sent when the order is created which is in almost all cases after the payment.

For the Delivery URL you paste the webhook URL that was created in the Soproof notification. This URL always starts with https://app.soproof.io/pixel-webhook/…

The secret can be left blank. This is only used if you want to send data to Woocommerce and that’s not what we are doing today. Save the webhook. Now it’s time to test it!

 

Test if it works!

Now comes the fun part: testing whether everything works! To check this you will need to do a test conversion. Go to your online store, throw something in your shopping cart and complete the checkout.

After this, go to Soproof dashboard and select ‘Data’ from the tabs at the top. Here you will see all the conversions that are registered. Click on a conversion to view the data. If all goes well, you’ll see something like the screenshot on the right (or above it on mobile). We can start using this data in the notifications.

Creating notifications with conversion data

You can use any field from the conversion data in a notification (see screenshot). First, see which field you want to use and then put that field between curly-braces, for example: {billing.first_name}. You can be as creative as you want: any field from the conversion data can be used.

In the notification you can fill the fields for the image URL and the notification URL with conversion data. For example: with Woocommerce you can use the product_id. Then fill in as notification URL:

/?p={line_items.0.product_id}.

Woocommerce will then redirect the visitor to the correct product when clicked.

Tip: make sure the data shown is not too personal. Most visitors don’t appreciate being shown their first name, last name and place of residence in a notification.

Do you still need help?

Need help? We’ll come to the rescue! You can contact us for simple and more complex integrations. Ofcourse free of charge!

Contact and support

Do you have questions about Soproof or cannot figure something out? Fill in your details and we will contact you as soon as possible!