Dokumentáció›Bekötések›Külső űrlap → CRM (webhook-URL)

Külső űrlap → CRM (webhook-URL)

🕘 4 perc olvasás

A weboldaladon maradó űrlap (vagy Zapier/Make) kitöltéseit egy pipeline-hoz kötött címre küldöd, és leadként érkeznek a CRM-be.

Ez az út akkor kell, ha az űrlap a saját weboldaladon marad, és csak annyit szeretnél, hogy minden kitöltése leadként megjelenjen a CRM-ben. Az űrlapot nem kell a PolyOS-be áttenni: a PolyOS ad egy címet, és az űrlap (vagy egy Zapier/Make-folyamat) oda küldi a kitöltést.

Számolj kb. 15 perccel, ha a beküldést te vagy a fejlesztőd tudja állítani.

ℹ️Mikor nem ez kell

Ha a kész űrlapod egy önálló .html fájl, és még nincs kint sehol, egyszerűbb a Saját űrlapok: ott semmit nem kell beállítanod a beküldésen. Ha pedig a kitöltő hírlevelet kér, nem leadet, akkor a weboldal-feliratkozás kell. Lásd az áttekintést.

Mi lesz a végeredmény #

Az űrlap minden kitöltése egy kártya a választott pipeline első oszlopában: a kitöltő kontaktként, az általa megadott adatokkal. Ugyanarra a leadre induló workflow-k is lefutnak, ahogy bármelyik más leadnél.

Mire lesz szükséged #

  • A PolyOS-ben egy pipeline, ahova a leadek érkezzenek
  • Hozzáférés ahhoz, ami az űrlap beküldését intézi: a weboldal kódja, egy WordPress-űrlapbővítmény webhook-beállítása, vagy egy Zapier/Make-fiók

1. lépés — Válaszd ki a pipeline-t #

Bal menü → CRM. Fent válaszd ki azt a pipeline-t, ahova a leadeket kéred. Ha még nincs, a + Új pipeline gombbal hozz létre egyet.

⚠️Konkrét pipeline kell

Az „összes pipeline” nézetben nincs Beállítások gomb, mert a cím mindig egyetlen pipeline-hoz tartozik. Előbb válassz ki egyet.

2. lépés — Másold ki a webhook-címet #

Beállítások → Webhook fül → a Webhook URL mező mellett Másolás.

A cím a pipeline-hoz és a fiókodhoz van kötve: amit erre küldenek, az ennek a pipeline-nak az első oszlopába kerül, máshova nem.

3. lépés — Állítsd be a beküldést #

Az űrlap a kitöltést POST kéréssel, JSON formában küldje a kimásolt címre. A Webhook fülön ugyanez a minta látszik:

{
  "lead": {
    "name": "Minta Péter",
    "email": "hello@pelda.hu",
    "phone": "+36 30 123 4567",
    "message": "…",
    "external_id": "a-sajat-azonositod",
    "fields": { "Időpont": "2026-10-20 19:00" }
  }
}

Mit jelentenek a mezők:

  • name, email, phone — ezekből lesz a kontakt. Legalább egyik kötelező, különben a kérés hibával visszajön.
  • message — a kitöltő üzenete, a kártyán szövegként látszik.
  • external_id — ha a te rendszeredben van saját azonosító, add meg: ugyanazzal az azonosítóval érkező újabb beküldés a meglévő kártyát frissíti. Ha nincs, az e-mail-cím vagy a telefonszám alapján párosítunk.
  • fields — minden további mező, olvasható címkével: „Cégnév”, „Létszám”, „Időpont”. Ezek a kártyán és a workflow-levelekben is megjelennek.
✅Az elterjedt mezőnevek maguktól működnek

A lead burok el is maradhat, és sok űrlapbővítmény szokásos mezőneveit is felismerjük (pl. your-name, your-email, first_name + last_name, phone_number). Ha a bővítményed csak „nyersen” tud küldeni, előbb próbáld ki átalakítás nélkül.

Zapier vagy Make esetén: a webhook-lépésben a módszer POST, a tartalom típusa JSON, a cím a kimásolt URL, a mezőket pedig a fenti nevekre képezd le.

4. lépés — Teszteld egyszer #

Töltsd ki az űrlapot a saját e-mail-címeddel. Pár másodperc múlva meg kell jelennie a kártyának a pipeline első oszlopában.

A sikert a válasz "ok": true mezője jelzi. Ha az űrlapod kódját te írod, ezt ellenőrizd, és hiba esetén mutass a kitöltőnek hibaüzenetet: különben a látogató „Köszönjük”-öt lát, a lead pedig nem érkezik meg.

⚠️A tesztet töröld ki

A próba-lead ugyanolyan lead, mint a többi: beleszámít a statisztikába, és workflow is indulhat rá.

Biztonság — amit érdemes tudni #

  • A cím nem jelszó, de ne terjeszd. Aki ismeri, leadet küldhet a pipeline-odba. Olvasni vagy törölni nem lehet rajta keresztül. Ha a beküldés a böngészőből megy, a cím a weboldal forrásában látszik. Ez rendben van, de akkor az űrlapodon legyen bot-védelem (pl. rejtett spamcsapda-mező).
  • Ha a fiók nem egyértelmű, a beküldést elutasítjuk. Inkább visszadobjuk, mint hogy egy másik fiók CRM-jébe írjuk.

Gyakori elakadások #

„Nem sikerült lekérni a címet” a Webhook fülön. A pipeline még nincs elmentve, vagy nem a te fiókodhoz tartozik. Mentsd el a pipeline-t, és nyisd meg újra.

Hibával jön vissza: empty_lead. Se név, se e-mail, se telefon nem érkezett. Nézd meg, a mezőnevek egyeznek-e a fentiekkel.

Minden beküldés új kártyát hoz létre. Nincs external_id, és az e-mail-cím vagy a telefonszám is hiányzik vagy minden alkalommal más. Küldj legalább egy állandó azonosítót.

A mezők nem látszanak a kártyán. Valószínűleg a fields-en kívül, technikai néven mentek (pl. utm_source, form_id, submit). Ezeket szándékosan nem tesszük a kártyára, mert nem ügyfél-adatok.

Mi jön ezután #