Forms and Form Webhooks
Working with html forms and utilizing Webhooks in Zesty.io WebEngine
HTML pages rendered in WebEngine have access to a few ways to capture form data, render form data, or to send form data.
Capturing Form Data to an Instance's Leads Feature
#Zesty.io Leads is feature of zesty that lets you capture user submitted data through an HTML form. Data is captured through <form> POSTs. Here is an example:
Upon POST submission, Zesty.io will look for an input named zlf
(Zesty Lead Form), and if it finds it, it will capture the form data to the leads table which can be viewed ini the Zesty.io Manager app of the instance the submission occurred on. The value you set for zlf
is captures as the form name, you can use this value to organize your leads into groups.
If you want to learn more about leads, have a look at the leads api https://instances-api.zesty.org/?version=latest#6ba715eb-485f-4a4b-8e8a-f2f3fa81e9a1
Sending Form Data to an Email or Through a Webhook
#There is built in functionality to send form data to an email address that is set in Zesty.io Manager Settings, under contact form. Alternatively you can have a payload sent to any remote server using a Webhook. That is often used for custom integrations or used with systems like Zapier.
Sending Form Data to an Email
In your HTML form, you can add an input with the name zcf
, (Zesty Contact Form) when that exists, Zesty.io WebEngine will detect it and send an email to the email set in contact form settings or the optional email_override
input.
email_override
is often used for dynamic forms that change who the need to email. This value could be changed dynamically by Javascript based on user input. A good example is changing the email based on the department like support or billing, or based upon the location like state.
Sending Form Data via Webhook
In your HTML form you can add an input with the name _zesty_webhook
(Zesty Webhook), which WebEngine will look for. If WebEngine see _zesty_webhook
it will attempt to send a POST request to the value of _zesty_webhook
which should be the url of the remote service you wish to send a payload too. Let's look at a code:
Upon submission Zesty WebEngine will capture that post and send a payload to the _zesty_webhook
value, which in our example is a Zapier url. The payload will look like this:
The verification key is an MD5 hash of your Instance ZUID, you can use this to prevent spam from hitting your endpoints.
Using All Three Capture Methods
#It possible to use all three methods in conjunction, so go nuts, but don't hurt yourself!
Handling Form Data with Parsley
#Sometimes its nice to customize your page base on the user's input. You can access values of a form post in parsley like this:
Connect with Content Experts
Book a free 15-minute consultation with a content expert. Discuss your application, pain points and requirements. Understand how Zesty's lower total cost of ownership, features, functionality can elevate your business by creating extraordinary digital experiences.
Trusted By
G2 MOMENTUM LEADER