Get started
Get started

Using Webhooks In Intelastel

A webhook is a method of activating or updating a destination application from a source application. It is a configurable data link between source and destination applications, used to convey a message or instruction.

Within Intelastel applications, webhooks are primarily used for triggering Integromat scenarios following some form of event in Intelastel.

This may be because you want your application to interact with other third party services when a new record is created or updated.


Explanation

Any webhook in your Intelastel application will send a message containing the information that is configured in the Data To View part of an Event to the destination configured to use said webhook.

Below is a brief explanation of the methodology behind webhooks – this information is not needed to use them but may help with your understanding of the processes involved:

This webhook message is called a request and uses HTTP – a common language used in web applications – to instruct the destination application.

The form of the request is called a POST command. POST will tell the destination application to accept the data contained within the message. This is called the ‘body’ of the request.

You do not need to configure this yourself – this is default behaviour for most webhooks, and any webhook in your Intelastel application will behave accordingly.

When your Intelastel application uses a webhook, the recipient application (such as Integromat, or any API) will process the content of the message and send a response back to your application. Think of it like a dedicated phone line between your house and a friend’s house – when you ring the phone, the friend knows to answer it and listen for your message, then send a reply.

The ‘body’ of the request – the message content – can be any data that the recipient application will understand. In other words, you will need to configure it to convey the data or action you want sent from your Intelastel application to the destination application.

You can use the same webhook with multiple parts of your Intelastel applications.

By setting up a webhook to work in our integration partner, Integromat, you can then trigger events and actions in other applications.


How To Use A Webhook

Output data from your Intelastel application to a third party application via Integromat.

First create the webhook in your destination application – in this example, we’ll assume you are familiar with using our integration partner, Integromat.

Create a scenario in Integromat that will update your third party application, then add a module to the start (left hand side of the module chain).


Example scenario – a simple Random Number Generator connected to a ‘Gmail Send Email’ module, triggered by a Webhook in Intelastel.

Search for webhooks then select and configure an appropriate webhook module. See this page of the Integromat help centre for more information.

The module will now ‘listen’ for the data coming from the source.

Copy the automatically generated address from that module and paste it into the relevant part of your Intelastel application – for example in a Create Record event.


Click ‘Copy address to clipboard’ on the Webhooks configuration to get the address of the webhook for your scenario.

See this page of the Intelastel User Guide for more information.

In the Integromat scenario, click ‘Run Once’ to test the scenario. Integromat will now wait for the webhook – the signal sent from your Intelastel application.

In Intelastel, switch to the Client view, go to the tab you created for the Event containing your new webhook and activate it.

If you have set this up correctly, you will be able to see the output on your third party application.

Create a manual trigger to use the webhook

You may wish to add a button in your Intelastel application that allows users to manually trigger a scenario using a webhook.

Create a new Entity attribute in your application, and label it accordingly; e.g. Scenario Name Webhook Trigger. Set the Field Type to be the data output you want to send to the Integromat scenario – this is going to form the webhook message body described above.

Note – for a simple action trigger such as activating an Integromat scenario, put 200 in the Default Value box.

Click on Update Field to save the new attribute.

In the Integromat scenario, click ‘Run Once’ to test the scenario. Integromat will now wait for the webhook – the signal sent from your Intelastel application.

In Intelastel, switch to the Client view, go to the tab you created for the Event containing your new webhook and run it.

If you have set this up correctly, you will be able to see the output on your third party application.


Intelastel User Guide
Integromat Webhooks guide

Back to tutorials

Share this