Webhooks with POST requests

From PlanFix
Jump to: navigation, search

In order to understand how webhooks work with POST requests, let's look at a simple example of creating a contact in Planfix for a person who has filled out a feedback form on your site.

Sample webhook with a POST request:

https://ваш_аккаунт.planfix.ru/webhook/POST/create_contact


Let's set up the webhook that will create contacts:

  • Specify POST request as the type:

bYcWdL.png


  • Webhook links contain a unique code, but we can replace it as needed with something more informative:

T2bvZX.png


  • In the webhook parameters, add field names from the feedback form:

tI7hsl.png


  • We specify the name of the person to whom the action will be attributed in Planfix after the webhook has been triggered:

pozSoU.png


  • We select the type of operation and configure it. Ultimately, Planfix will create a new contact using the specified template, add a Name from the name parameter in the link and a Phone Number from the phone parameter in the link, and then notify the required employee about the new contact:

HBHNtp.png


  • Then add additional operations as needed, and in the last step specify what kind of response you would like to receive from the webhook: JSON, transition to Planfix, or transition to your website:

IzZ5Bn.png


  • Then add the webhook link to the code for the feedback form on your site:

<form method="post" action="https://own_account.planfix.ru/webhook/POST/create_contact">
  <input type="text" name="name" placeholder="First name">
  <input type="text" name="phone" placeholder="Phone">
  <input type="submit" name="submit" value="Submit">
</form>


  • When a customer fills out the feedback form with their name and phone number and then clicks the Submit button:

zy4i3F.png


  • The values from the form fields are added to the webhook and sent to Planfix, where a new contact is automatically created:

NF5Cyy.png


Go To