Connect a third party service in a couple of clicks 🪝
Webhooks are automated messages sent from apps when something happens. They have a message—or
payload(in json format)—and are sent to a unique URL. You can create such URLs in Directual to receive those messages.
Go to API section → Webhooks → + New webhook and enter system name of a new webhook. In 99% of cases you will need a scenario for parsing incoming objects. Such a scenario can be created automatically right here.
Copy Webhook URL to your external service to send messages to Directual.
If you create a webhook, data structure for it is created automatically in
Integrations/Webhooks/folder (you can also find a link to it right here, in webhooks table). The first object is created by Directual itself — that one is for test purposes.
There are the following fields in webhook data structure:
id— usual unique field
body, headers, urlData— fields in JSON format. One or a few of them contain data (depending on a specific third party service).
Objects coming via Webhooks contain data in JSON-format. The best way to deal with them is to apply JSON-step or to apply templating techniques for parsing JSON.
The default response is:
Sometimes a third-party system requires another response, in JSON or even in XML format. So, that is not a problem, you can compose any API-response you need! Here is how:
Note, that scenario have to be published and started.
Have a look at the tutorial how to update existing data table having incoming data in JSON: