A Webhook integráció lehetővé teszi, hogy összekapcsold az OptiMonkot bármilyen rendszerrel. Akkor ajánljuk, ha az OptiMonknak nincs közvetlen integrációja az általad használt eszközzel, vagy ha több adatot szeretnél elküldeni, mint amennyit egy standard integráció továbbít.

Fontos, hogy egy webhookhoz szükség van valakire a te oldaladon, aki képes fogadni az adatokat — egy általad kezelt oldalra vagy végpontra. Ha nincs fejlesztőd, használd inkább a Zapiert: ugyanezt a feladatot kód nélkül elvégzi.

Mielőtt elkezded: a popupnak elkészültnek kell lennie, mert a mezőhozzárendelést a popup beviteli mezőiből olvassuk ki.

Hogyan működik a Webhook integráció?

Amikor egy látogató kitölt egy űrlapot egy olyan popupban, amelyhez Webhook integráció van beállítva, az OptiMonk elküldi a beküldött adatokat a megadott URL-re, a POST metódussal.

A payload mindig tartalmazza:

  • a látogató e-mail címét, keresztnevét, vezetéknevét és telefonszámát — ezek az OptiMonk négy beépített lead mezője;
  • az URL-t amelyen a popup megjelent;
  • a kampány nevét és kampány azonosítóját.

Minden más, amit a popupod összegyűjt — legördülő listák, jelölőnégyzetek és választógombok, szövegmezők, felmérési és visszajelzési válaszok, ország / város / irányítószám mezők, adatvédelmi jelölőnégyzet — egy egyéni mező formájában halad, az alatt az azonosító alatt, amellyel az adott mező rendelkezik az OptiMonk fiókodban. Nem kell ezeket az azonosítókat kézzel létrehoznod: amikor a popup elkészül, az OptiMonk automatikusan hozzáadja minden új meződet a fiók mezőkatalógusához, és ugyanez az azonosító az, amelyet a varázslóban hozzárendelsz, és amelyet a payloadban is látsz.

Fontos:

  • Webhook esetén nincs szükség extra taggelésre — a legegyszerűbb megoldás az, hogy a mezőt az OptiMonkban pontosan úgy nevezed el, ahogyan a saját rendszered elvárja.
  • A webhook nem tudja kezelni a késleltetett küldést. Ha egy többlépéses popup egyik lépésén e-mail címet, egy későbbi lépésén pedig telefonszámot gyűjtesz, az OptiMonk integrációs hibát fog jelezni, még akkor is, ha az adatok valójában megérkeznek. Ennek elkerüléséhez tartsd az e-mail és a telefonszám mezőket ugyanazon a lépésen.
  • Egy többlépéses popup minden lépéshez külön hívást hoz létre, így egy adott látogatóhoz több bejegyzést is látni fogsz — például a 3. lépésen megjelenő kuponkód a harmadik hívásban érkezik meg.

A Webhook integráció beállítása

  1. Nyisd meg a Kampányok menüpontot a bal oldali menüben, majd kattints arra a kampányra, amelyet össze szeretnél kapcsolni.

  2. Nyisd meg az Integrációk fület.

  3. Kattints az Integráció hozzáadása gombra. Ha ez az első integrációd, ugyanez a lépés Kösd össze az email vagy SMS eszközöddel néven jelenik meg.

  4. Szolgáltató lépés: válaszd a Webhook opciót — ez a Népszerű sorban található. Ha a lista hosszú, írj a Szolgáltató keresése… mezőbe.

  5. Fiók lépés: kattints az Új fiók csatlakoztatása gombra, majd add meg azt az URL-t, amelynek fogadnia kell az adatokat. Az űrlap elmondja, mire szolgál: The data (firstname, lastname, e-mail address) will be sent to this URL. (Az adatok (keresztnév, vezetéknév, e-mail cím) erre az URL-re lesznek elküldve.) A kapcsolatot el is nevezheted a Név (opcionális) mezőben, hogy később felismerd. Kattints a Csatlakoztatás gombra.

    Ha korábban már beállítottál egy webhookot, az a kapcsolat itt felkínálásra kerül — válaszd ki, hogy újra felhasználd ugyanazt az URL-t.

  6. Mezők összerendelése lépés: add meg, hogy az egyes popup mezőket minek hívják a te oldaladon, majd kattints az Integráció mentése gombra.

Vázlat vagy élő: ha a kampány még nincs publikálva, az integráció egy Piszkozat jelölést és a Piszkozatként mentve — a kampány publikálásakor lép élesbe. Egy publikált kampányon azonnal érvénybe lép, és úgy jelenik meg, mint Aktív.

Mezőhozzárendelés

A hozzárendelési táblázatnak két oszlopa van: Popup mező a bal oldalon (minden beviteli mező, amelyet a popupod összegyűjt), és a Webhook mező a jobb oldalon.

A webhook bármilyen nevet elfogad, így a jobb oldali oszlop egy szabadszöveges mező, és a táblázat alatti súgó is ezt jelzi: Type the exact Webhook field or property name (e.g. first_name). Leave empty to skip a field. (Írd be a pontos Webhook mező- vagy tulajdonságnevet (pl. first_name). Hagyd üresen, ha ki szeretnél hagyni egy mezőt.)

  • Hagyj egy sort üresen (Ne szinkronizálja) minden olyan popup mezőnél, amelyet nem szeretnél elküldeni.
  • A Statikus mezők alatt minden beküldéssel elküldhetsz egy rögzített értéket is — például egy forrás- vagy kampányjelölést. Kattints a Statikus mező hozzáadása gombra, írd be az értéket a bal oldalon, és a mező nevét a jobb oldalon.

Az integráció tesztelése

A leggyorsabb módja annak, hogy lásd, mi érkezik, egy webhook inspector használata:

  1. Nyisd meg a https://webhook.site/ oldalt, és másold ki az általa adott egyedi URL-t.
  2. Állítsd be az integrációt ezzel az URL-lel, a fentebb leírt lépéseket követve.
  3. Publikáld a kampányt, majd indítsd el a popupot az oldaladon, és töltsd ki. Ha több kampány is fut az oldaladon, ügyelj arra, hogy azt indítsd el, amelyet éppen beállítottál.
  4. Frissítsd az inspectort. A POST kérésnek meg kell jelennie; az OptiMonk által elküldött adatok a Törzs részben találhatók.

Amint látod, hogy megérkeznek az adatok, irányítsd az integrációt a valódi végpontodra: nyisd meg az Integrációk fület, kattints az Összerendelés szerkesztése gombra a sorban — vagy távolítsd el a teszt kapcsolatot, és adj hozzá egy újat az éles URL-lel.

Az integráció módosítása vagy eltávolítása

Az Integrations fül felsorolja a kampányon található minden integrációt.

  • Összerendelés szerkesztése újra megnyitja a beállítást a hozzárendelési lépésnél.
  • A kuka ikon eltávolítja az integrációt ebből a kampányból: Eltávolítod ebből a kampányból? A fiók-kapcsolat megmarad, és később újra hozzáadható. Az általad csatlakoztatott URL nem törlődik, így felhasználhatod egy másik kampányon is.