Receiving leads with a web form, webhook or API

Leads don't only come from Instagram/Facebook ad forms. Piyzi has three more ways; in each, the lead lands on the Leads screen, is matched to your customer list by phone number and runs the same automations:

• Web form: Piyzi's ready-made lead form. Share its link or embed it on your own website.

• Webhook: connect a form in another tool (Zapier, Make, Typeform, Jotform, Tally, Google Forms…) through a private address.

• Piyzi API: your developer sends leads straight from your website or system.

You manage them on the Leads › Forms and sources tab. Viewing needs Can view leads; adding and changing needs Can set up integrations (the business owner always has both).

Creating a web form

1. 1

   New form

   On the Forms and sources tab, click New web form.

2. 2

   Name and title

   Form name is shown in the panel and on leads; automation messages use it as the form name. Page title and the optional Description are what visitors see above the form.

3. 3

   Choose the fields

   Name and Phone are on every form and required. The e-mail field can be off, optional or required. With Add question add up to 10 questions: short answer, long answer or multiple choice (one option per line). Reorder them with the arrows and make them required.

4. 4

   Finishing touches

   Optionally change the button text and the thank-you message, then click Create.

Sharing the form and embedding it

When the form is created the Share window opens (later, use the Share button on its row):

• Form link: your site address followed by /basvuru/…. Put it in your Instagram bio, an ad, a WhatsApp message or a QR code.

• Embed code: paste it where the form should appear on your own website. The form adjusts its own height inside your page.

• Below the form, visitors read that their details are used to contact them about the application, with a link to your privacy notice (Settings › Other settings › Agreements).

• To prevent abuse, at most 30 leads an hour are accepted from the same internet connection and 5 an hour from the same number; submissions filled in by bots are not saved.

• A business can have up to 20 web forms.

Connecting another tool with a webhook

1. 1

   New webhook

   Click New webhook and give it a name (e.g. "Typeform campaign form").

2. 2

   Copy the address

   Your private address is shown only once; copy it right away. If you lose it, create a new one with Renew address in the row menu (the old address stops working immediately).

3. 3

   Paste it into your tool

   In Zapier, Make or your form tool, add a Webhook step, choose POST and paste the address. Send the data as JSON or form data.

• Field names are free. Name, phone and e-mail are recognised by their Turkish or English names (ad_soyad, isim, name, telefon, cep, phone, email, e-posta…); every other field becomes an answer and is saved to the customer's note.

• Send at least a name, phone number or e-mail address.

• If your tool may resend the same lead, send an externalId (or submission_id, event_id) field: a second request with the same ID does not create a new lead.

• To try it, send test: true: the lead is saved as "Test", no customer is created and no automation runs.

• A webhook accepts up to 600 leads an hour. A business can have up to 10 webhooks.

• Google Forms: in the form's Apps Script, a form-submit trigger can POST the answers to this address.

Sending with the Piyzi API

If Piyzi API is on in Pi Store, your developer can send leads to the POST /v1/leads endpoint. Authentication and the IP allow list are as described in the Piyzi API article; the body rules are the same as for the webhook. The response gives the lead ID, whether it is new or was sent before, and whether a customer was created or linked.

After the first API lead arrives, a Piyzi API row appears on the Forms and sources tab; there you can stop creating customer cards or disable receiving leads through the API.

What happens when a lead arrives?

• If the phone is a Turkish mobile number a customer is created. Their channel is Web Form and the form or webhook name is shown as the detail.

• If the number is already registered no new customer is created; the lead is linked to that customer. The customer's name is not changed; a different name shows Name differs on the lead.

• If there is no phone or the number is foreign no customer is created; the lead stays on the Leads screen only.

• The answers are saved to the customer's Notes tab with the "Lead form" source.

• If you turn off the source's Create a customer card from the lead setting, no customers are created for new people.

• The When a Form Lead Arrives automation runs: with the "Form leads" category in Ready-made automations you can set up a notification to the owner and an "application received" message to the applicant. The limits are the same as for Meta forms (one message to the same number in 24 hours, 200 a day per form).

Disabling and deleting

• Disable: the web form says "Form not available", the webhook and the API reject new leads. Enable it again to continue.

• Delete: the link or address stops working for good. Leads and customers already received are not deleted.