Hírlevél és várólista a saját weboldalról

Ha a weboldaladnak saját hírlevél-feliratkozása vagy „értesítést kérek” várólistája van (például egy induló kurzusra), azt nem kell lecserélned a PolyOS űrlapjára. A weboldal minden új feliratkozásnál szól a PolyOS-nek, és a feliratkozó ugyanúgy bekerül, mintha a PolyOS-ben iratkozott volna fel.

Melyik út a tiéd #

A weboldalad	Mit csinálj	Kell hozzá fejlesztő?	Idő
WordPress	Telepítsd a PolyOS for WordPress bővítményt, és tedd ki az űrlapot egy shortcode-dal	Nem	kb. 15 perc
Bármi más (saját fejlesztésű, Next.js, Shopify-sablon…)	A weboldal egy POST kérést küld a PolyOS webhookjára	Igen	kb. 30 perc
Még nincs feliratkozó-űrlapod	Használd a Hírlevél modul beágyazható űrlapját — de előbb olvasd el a korlátait lent	Nem	5 perc

Mi lesz a végeredmény #

Hírlevél-feliratkozásnál a feliratkozóból:

• kontakt lesz a CRM-ben,
• rögzül a hozzájárulása (a feliratkozás időpontjával),
• feliratkozott jelölést kap, így a következő kampány már neki is megy,
• és megjelenik a CRM Hírlevél-feliratkozók pipeline-jában.

Várólistás feliratkozásnál a feliratkozóból kontakt lesz várólista: <kurzus neve> címkével, és megjelenik a Kurzus-várólista pipeline-ban. Hírlevélre nem iratkozik fel: aki egy kurzus indulásáról kért értesítést, az nem kért rendszeres levelet.

Mire lesz szükséged #

• A PolyOS-ben tulajdonosi vagy admin jog
• Hozzáférés a weboldal adminfelületéhez (WordPressnél), vagy a kódjához és beállításaihoz (egyéb esetben)

---

1. lépés — Kód kiadása (PolyOS) #

Bal menü → Integrációk → Minden integráció → Marketing e-mail. Ha több egységed van, fent válaszd ki azt, amelyikhez a weboldal tartozik. Görgess a Weboldal-feliratkozások (webhook) kártyához → Kód kiadása.

Két értéket kapsz, mindkettő mellett Másolás gombbal:

• Webhook-cím (POLYOS_WEBHOOK_URL) — ide küldi a weboldal a feliratkozást
• Titkos kód (POLYOS_WEBHOOK_SECRET) — a fiókodhoz kötött titok

Hogyan add át a fejlesztődnek #

Ezt az oldalt nyugodtan küldd át — nincs benne titok. A kódot viszont ne tedd chatbe, e-mailbe vagy képernyőképre: azok a csatornák megmaradnak, és sokan látják.

Három járható mód, ebben a sorrendben:

1. A fejlesztő maga másolja be. Ha van hozzáférése a PolyOS-hez, add meg neki a kártyán az Új kód kiadása jogot — így a kód sosem megy át rajtad.
2. Jelszókezelőn át (1Password, Bitwarden, KeePass): egyszer használatos, lejáró megosztás.
3. Ha egyik sem: add át szóban vagy telefonon, és utána azonnal adj ki újat, amint beállította.

---

2/a. lépés — WordPress (bővítmény, kódolás nélkül) #

A PolyOS for WordPress bővítmény mindent elvégez: űrlapot ad, és ő küldi a feliratkozást a PolyOS-nek.

1. Töltsd le a bővítményt a PolyOS-ből: Integrációk → Minden integráció → Marketing e-mail → Weboldal-feliratkozások (webhook) → PolyOS for WordPress (.zip).

:::info Egy bővítmény, két helyen kínáljuk Ugyanez a csomag tölthető le a Webshop oldalról is (az egység sorában: WooCommerce (PolyOS plugin) → Bekötés). Ugyanaz a fájl — ha már fent van az oldalon, ne telepítsd újra, elég frissíteni. A csomag két modulból áll: a hírlevél mindig működik, a webshop-szinkron csak WooCommerce mellett kapcsol be. :::

1. WordPress → Bővítmények → Újdonság telepítése → Bővítmény feltöltése → válaszd ki a .zip-et → Telepítés, majd Aktiválás.
2. Bal menü → PolyOS. Illeszd be a webhook-címet és a titkos kódot, majd Mentés.
3. Tedd ki az űrlapot oda, ahova szeretnéd:

[polyos_newsletter]

Ez működik oldalon, bejegyzésben, szöveg-widgetben és a blokkszerkesztő „Shortcode” blokkjában is.

Amit beállíthatsz a PolyOS menüpont alatt:

Beállítás	Mire jó
Név a hozzájárulás szövegében	„Feliratkozom a(z) … hírlevelére.” Üresen az oldal neve.
Kiemelő szín	A gomb és a fókusz színe. Üresen a téma saját színét örökli.
Adatkezelési tájékoztató (magyar / angol)	A hozzájárulás melletti link. Üresen a WordPress beállított adatvédelmi oldala.

Shortcode-paraméterek:

• [polyos_newsletter title="0"] — a cím és a bevezető sor nélkül (ha a téma már ad címet)
• [polyos_newsletter source="lablec"] — honnan jött; a CRM-ben a forrás mellett látszik
• [polyos_newsletter lang="en"] — nyelv kényszerítése. Alapból magától igazodik: Polylang, WPML, különben az oldal nyelve.

A betűt, a hátteret és a szövegszínt a témádtól örökli, tehát nem üt el az oldaltól.

---

2/b. lépés — Minden más weboldal (webhook) #

A két értéket tedd a weboldal környezeti változói közé, és telepítsd újra az oldalt (Vercelen: Settings → Environment Variables, majd Redeploy) — különben a futó oldal még nem látja őket.

A weboldal minden új feliratkozásnál egy POST kérést küld a webhook-címre, JSON tartalommal, és az X-Webhook-Secret fejlécben a titkos kóddal.

Hírlevél-feliratkozás:

{
  "event": "newsletter.signup",
  "email": "hello@pelda.hu",
  "name": "Minta Péter",
  "consent_at": "2026-10-15T10:15:00Z",
  "source": "lablec-urlap"
}

Várólista:

{
  "event": "waitlist.signup",
  "email": "hello@pelda.hu",
  "name": "Minta Péter",
  "course": { "id": "k-01", "slug": "minta-kurzus", "title": "Minta kurzus" },
  "consent_at": "2026-10-15T10:15:00Z",
  "source": "kurzus-oldal"
}

• email — kötelező. Érvénytelen címre nem jön létre feliratkozás (de a válasz akkor is 200, lásd lent).
• consent_at — mikor adta a hozzájárulást (a beküldés pillanata). Ezt rögzítjük bizonyítékként.
• source — szabad szöveg arról, honnan jött. Legfeljebb 60 karakter.

Próba parancssorból #

Mielőtt kódot írsz, ezzel ellenőrizheted, hogy a cím és a kód jó:

curl -i -X POST "$POLYOS_WEBHOOK_URL" \
  -H "Content-Type: application/json" \
  -H "X-Webhook-Secret: $POLYOS_WEBHOOK_SECRET" \
  -d '{"event":"newsletter.signup","email":"hello@pelda.hu","consent_at":"2026-10-15T10:15:00Z","source":"curl-proba"}'

PHP-példa #

<?php
$res = wp_remote_post( POLYOS_WEBHOOK_URL, array(
    'timeout' => 12,
    'headers' => array(
        'Content-Type'     => 'application/json',
        'X-Webhook-Secret' => POLYOS_WEBHOOK_SECRET,
    ),
    'body'    => wp_json_encode( array(
        'event'      => 'newsletter.signup',
        'email'      => $email,
        'name'       => $name,
        'consent_at' => gmdate( 'Y-m-d\TH:i:s\Z' ),
        'source'     => 'lablec-urlap',
    ) ),
) );

$code = is_wp_error( $res ) ? 0 : (int) wp_remote_retrieve_response_code( $res );
// 2xx = átvettük. Minden más esetben naplózz, és a látogatónak mondd, hogy próbálja újra.

WordPressen kívül ugyanez curl-lel vagy bármely HTTP-klienssel megy; csak a két fejléc és a JSON-törzs számít.

Mit válaszol a PolyOS #

HTTP	Törzs	Mit jelent	Mi a teendő
200	{"ok":true,"result":"ok:newsletter:new"}	Új feliratkozó létrejött	—
200	{"ok":true,"result":"ok:newsletter:existing"}	Meglévő kontakt frissült	—
200	{"ok":true,"result":"skipped:unsubscribed"}	A cím korábban leiratkozott, ezért nem tettük vissza	Semmi. A látogatónak ne mondd meg — ez az ő adata.
200	{"ok":true,"result":"skipped:invalid_email"}	A cím nem érvényes	Ellenőrizd az űrlap validálását
200	{"ok":true,"ignored":"…"}	Ismeretlen event érték	Javítsd az esemény nevét
400	{"error":"bad_json"}	A törzs nem érvényes JSON	Nézd meg a Content-Type-ot és a JSON-t
401	{"error":"missing_secret"}	Nincs X-Webhook-Secret fejléc	Add hozzá a fejlécet
401	{"error":"invalid_secret"}	A kód hibás vagy visszavonták	Adj ki új kódot, és cseréld a weboldalon
405	{"error":"method_not_allowed"}	Nem POST-tal küldted	Használj POST-ot
500	{"ok":false,"result":"error:…"}	Nálunk hibázott a feldolgozás	Próbáld újra később; ha marad, szólj nekünk

Ha a PolyOS nem elérhető (hálózati hiba, időtúllépés): a kérés eldobódik, nem próbáljuk újra magunktól. A weboldalad felelőssége eldönteni, mi legyen — a legegyszerűbb, ha naplózod és a látogatónak hibát jelzel. A WordPress-bővítmény ezt már így csinálja, és a legutóbbi beküldés eredményét ki is írja a beállító oldalon.

---

3. lépés — Ellenőrzés #

Iratkozz fel a weboldalon a saját címeddel, majd nézd meg a Weboldal-feliratkozások kártyát:

• ⏳ Kód kiadva, de még nem érkezett feliratkozás — a weboldal még nem küldött, vagy rossz kóddal küldött.
• ✅ Működik — mellette az utolsó feliratkozás ideje és fajtája.

Ezután a CRM Hírlevél-feliratkozók (vagy Kurzus-várólista) pipeline-jában is ott kell lennie a kártyának.

---

A beágyazható űrlap korlátai #

Ha nincs saját űrlapod, a Hírlevél modul ad egy beágyazhatót (Hírlevél → Beágyazás). Egy <iframe>-et kapsz, ami a PolyOS-en futó űrlapot mutatja.

Amit beállíthatsz: melyik egységhez tartozzon, és milyen magas legyen a keret.

Amit ma nem tudsz beállítani:

• színt, betűtípust, elrendezést — az űrlap a PolyOS saját kinézetével jelenik meg, és nem veszi át a weboldalad témáját;
• nyelvet — magyarul jelenik meg;
• a mezőket (csak név + e-mail + hozzájárulás).

Ezért ha a megjelenés számít, vagy angol oldalad is van, WordPressen a bővítmény a jobb választás (ott a téma színeit örökli, és magyarul-angolul is tud), máshol pedig a saját űrlap + webhook.

---

Ami a háttérben történik #

• Aki korábban maga iratkozott le, azt nem írjuk vissza. Ha a leiratkozott cím újra beérkezik, a PolyOS nem teszi vissza a hírlevél-listára, mert a leiratkozás a címzett kifejezett kérése volt.
• Egy feliratkozó egy kártya. Ugyanarról a címről érkező újabb feliratkozás a meglévő kártyát frissíti. Várólistánál kurzusonként egy kártya van. A kézzel beállított szakaszt és felelőst nem írjuk felül.
• A lead-workflow-k nem indulnak el. A feliratkozás nem lead: a leadekre beállított automatizmusok (pl. ajánlatküldés) a feliratkozókra nem futnak le.

Kód cseréje és visszavonás #

• Új kód kiadása — a régi azonnal érvényét veszti. Amíg a weboldal beállításában ki nem cseréled, a feliratkozások 401-gyel elutasításra kerülnek.
• Visszavonás — ezután a weboldal hiába küld, semmit nem dolgozunk fel. Akkor használd, ha a kód kiszivárgott, vagy a weboldalt megszünteted.

---

Brevo-feliratkozók átvétele #

Ha a feliratkozókat a Brevo saját űrlapján gyűjtöd, nem kell kódot írni: a Brevo maga szól a PolyOS-nek, amikor valaki listára kerül. Az eredmény ugyanaz, mint fent a hírlevél-feliratkozásnál.

Előfeltétel: a Brevo be van kötve küldőként, és a Kézbesítési visszajelzés (webhook) címet már kikérted. Ezt a Marketing e-mail oldalon, a Küldő szerver / app bekötése blokkban találod, a Webhook-cím kérése gombbal.

1. Brevo → Settings → Webhooks → Marketing fül → új webhook.
2. URL: ugyanaz a cím, amit a kézbesítési visszajelzéshez kaptál, teljes egészében.
3. Események közül csak a List addition (listára kerülés) legyen bekapcsolva.
4. Mentés.

Ezután aki a Brevo-űrlapon feliratkozik, a PolyOS-ben is kontakt lesz, hozzájárulással, a Hírlevél-feliratkozók pipeline-ban.

Gyakori elakadások #

A kártyán „Még nincs bekötve” áll, pedig kiadtam a kódot. Valószínűleg másik egység van kiválasztva — vagy másik fiók. A kód egységenként külön van; nézd meg azt az egységet, amelyikre kiadtad.

401 invalid_secret. A kód hibás vagy visszavonták. Tipikus okok: elgépelés, a kód elejéről/végéről lemaradt karakter, vagy közben új kódot adtál ki. Adj ki újat, és cseréld a weboldalon is.

401 missing_secret. A fejléc neve pontosan X-Webhook-Secret legyen. Néhány tárhely a nem szabványos fejléceket kiszűri — ilyenkor a tárhelyszolgáltatót kell kérdezni.

Kód kiadva, de sosem lesz „Működik”. A weboldal nem küld. WordPressen nézd meg a PolyOS menüpontban az Utolsó beküldés sort — ott látszik a HTTP-kód és a hibaüzenet.

A feliratkozó nem jelenik meg a hírlevél-listán. Nézd meg, nem iratkozott-e le korábban. Leiratkozott címet szándékosan nem írunk vissza (skipped:unsubscribed).

Mi jön ezután #

• Hírlevél — kampány a feliratkozóknak
• Űrlapok és feliratkozások — áttekintés