# Űrlap: hírlevélszolgáltatók összekötése (Brevo, Kit, GetResponse, Mailchimp, MailerLite, Drip, Active Campaign)

> Az űrlapot kitöltők automatikus felvétele a hírlevélszolgáltatód listájára: API-kulcs és azonosító beszerzése, a művelet beállítása, korlátozások.

Az **Űrlap** widget minden kitöltőt fel tud venni a hírlevélszolgáltatód listájára. Ezek a műveletek a Pro változatban érhetők el (az ingyenes bővítmény nem listázza őket), és az **Űrlap** widgetet be kell kapcsolni a **The Plus Addons → Widgets** oldalon.

## Mindegyik szolgáltatónál közös

- A **Küldési műveletek** szakasz **Művelet hozzáadása** mezőjében vedd fel a szolgáltató nevét. A kiválasztás után a panelen megjelenik a szolgáltató saját szakasza.
- A mezők **Egyedi ID**-ját (a mező **Haladó** lapján) pontosan úgy kell elnevezni, ahogy a szolgáltatónál lent szerepel. Csak ezek az adatok jutnak el a szolgáltatóhoz, a többi mező az űrlapban marad.
- Ha a szolgáltató elutasítja a kérést, a látogató a „There was an error in submitting the form.” üzenetet látja. Ilyenkor másold ki újra a kulcsot és az azonosítót szóközök nélkül, ellenőrizd, hogy az e-mail mező **Egyedi ID**-ja `email`, és próbáld újra. Amíg ez a hiba látszik, az **Átirányítás** művelet nem fut le.

![A Küldési műveletek szakasz több hírlevél-művelettel, alattuk a szolgáltatók szakaszai](./kepek/urlap-builder-panel-muveletek-sok.webp)

*A Küldési műveletek szakasz több hírlevél-művelettel, alattuk a szolgáltatók szakaszai* (https://minta-bolt.hu/wp-admin/post.php?post=355&action=elementor)

A képen jól látszik, hogy az **Automatikus válasz e-mail**, a **Brevo**, a **ConvertKit**, a **GetResponse**, a **Mailchimp**, a **MailerLite** és a **Drip** külön szakaszt kap.

## Brevo

Szükséged van egy Brevo-fiókra, egy API-kulcsra és a feltöltendő lista azonosítójára. Az Egyedi ID-k: `email` az e-mail-címhez és `first_name` a keresztnévhez.

**API-kulcs a Brevóban:**

1. Jelentkezz be a Brevóba, kattints a profilod nevére jobb felül, és válaszd az **SMTP & API** lehetőséget.
2. Nyisd meg az **API Keys** fület, és kattints a **Generate a new API key** gombra.
3. Adj nevet a kulcsnak, és kattints a **Generate** gombra.
4. Másold ki a kulcsot, és tárold biztonságos helyen: a Brevo csak egyszer mutatja meg.

**A lista azonosítója:**

1. A Brevóban nyisd meg a **Contacts → Lists** oldalt.
2. Hozz létre listát a **Create a List** gombbal, vagy válassz egy meglévőt.
3. Jegyezd fel a lista azonosító számát.

![A Brevo szakasz az API-kulcs és a Lista ID mezővel](./kepek/urlap-builder-panel-brevo.webp)

*A Brevo szakasz az API-kulcs és a Lista ID mezővel* (https://minta-bolt.hu/wp-admin/post.php?post=355&action=elementor)

A képen a két mező látszik: **API-kulcs** és **Lista ID**.

| Beállítás | Mit írj bele |
|---|---|
| **API-kulcs** | A Brevo API-kulcsod |
| **Lista ID** | Csak a lista száma, például `2`. Ne tegyél elé #-ot. |

Működés: minden beküldés Brevo-kapcsolatot hoz létre az e-mail-címmel és a keresztnévvel. Ha a kapcsolat már létezik, a Brevo frissíti a keresztnevet, és felveszi a listára. Ha a **Lista ID** üres, a kapcsolat listára kerülés nélkül jön létre. Csak az e-mail-cím és a keresztnév megy át, a többi mező (például a telefonszám vagy az üzenet) az űrlapban marad. A Brevo kétlépcsős feliratkozás-megerősítése (double opt-in) nem használt: a kapcsolat közvetlenül bekerül.

Ha a kapcsolatok létrejönnek, de nem kerülnek a listádra, a **Lista ID** mezőben egyszerű szám álljon: a # az azonosítót érvénytelenné teszi.

## Kit (korábbi nevén ConvertKit)

Szükséged van egy Kit-fiókra, az API-kulcsra és egy Kit-űrlap azonosítójára. Az Egyedi ID-k: `email` az e-mail-címhez, `first_name` a keresztnévhez és `phone` a telefonszámhoz.

**API-kulcs a Kitben:**

1. Jelentkezz be a Kitbe, kattints a profilodra jobb felül, és válaszd a **Settings** pontot.
2. A bal oldali menüben kattints a **Developer** elemre.
3. Másold ki az **API Key**-t. A widget a Kit v3 API-ját használja.

**Kit-űrlap és azonosítója:**

1. A Kitben nyisd meg a **Grow → Landing Pages & Forms** oldalt, és kattints a **Create a Form** gombra.
2. Válassz űrlaptípust és sablont, majd tedd közzé.
3. Másold ki a Kit által az űrlaphoz mutatott **Form ID**-t.
4. Ha megerősítő e-mail nélkül szeretnéd felvenni a feliratkozókat, a Kit űrlapjának beállításaiban kapcsold ki a kétlépcsős feliratkozást (double opt-in).

![A ConvertKit szakasz az API-kulcs és az Űrlap ID mezővel](./kepek/urlap-builder-panel-convertkit.webp)

*A ConvertKit szakasz az API-kulcs és az Űrlap ID mezővel* (https://minta-bolt.hu/wp-admin/post.php?post=355&action=elementor)

A képen az **API-kulcs** és az **Űrlap ID** mező látszik.

| Beállítás | Mit írj bele |
|---|---|
| **API-kulcs** | A Kit API-kulcsod |
| **Űrlap ID** | Annak a Kit-űrlapnak az azonosítója, amelyre a feliratkozók kerülnek |

Működés: minden beküldés feliratkoztatja az e-mail-címet a Kit-űrlapra, a keresztnévvel és a telefonszámmal együtt. Csak ez a három adat megy át.

## GetResponse

Szükséged van egy GetResponse-fiókra, egy API-kulcsra és a lista tokenjére (List Token). Az Egyedi ID-k: `email` az e-mail-címhez és `first_name` a névhez.

**API-kulcs a GetResponse-ban:**

1. A felső menüben nyisd meg a **Tools → Integrations and API** oldalt.
2. Nyisd meg az **API** fület, és kattints a **Generate API Key** gombra.
3. Nevezd el a kulcsot, kattints a **Generate** gombra, és másold ki.

**A lista tokenje:**

1. A felső menüben kattints a **Contacts** pontra.
2. Kattints a listád melletti három pontra, és válaszd a **Settings** lehetőséget.
3. A **General** fülön a lista neve alatt másold ki a **List Token** értékét.

![A GetResponse szakasz az API-kulcs és a Lista tokenje mezővel](./kepek/urlap-builder-panel-getresponse.webp)

*A GetResponse szakasz az API-kulcs és a Lista tokenje mezővel* (https://minta-bolt.hu/wp-admin/post.php?post=355&action=elementor)

A képen az **API-kulcs** és a **Lista tokenje** mező látszik.

| Beállítás | Mit írj bele |
|---|---|
| **API-kulcs** | A GetResponse API-kulcsod |
| **Lista tokenje** | Annak a listának a tokenje, amelyre a kapcsolatok kerülnek |

Működés: minden beküldés felveszi az e-mail-címet és a nevet a listára. Ha az e-mail-cím már kapcsolat, az űrlap akkor is a sikerüzenetet mutatja. Csak az e-mail-cím és a név megy át.

## Mailchimp

Szükséged van egy Mailchimp-fiókra, egy API-kulcsra és a közönséged azonosítójára (Audience ID). Az Egyedi ID-k: `email` az e-mail-címhez és `first_name` a keresztnévhez.

**API-kulcs a Mailchimpben:**

1. Jelentkezz be a Mailchimpbe, kattints a profilodra jobb felül, és válaszd az **Account & billing** pontot.
2. Nyisd meg az **Extras → API keys** oldalt.
3. Kattints a **Create A Key** gombra, nevezd el, és kattints a **Generate Key** gombra.
4. Másold ki a teljes kulcsot, a kötőjel utáni részt is (például `-us21`).

**A közönség azonosítója:**

1. Nyisd meg az **Audience → All contacts** oldalt. Ha több közönséged van, előbb válaszd ki a megfelelőt.
2. Kattints a **Settings** gombra.
3. Másold ki a beállítások oldalon látható **Audience ID**-t.

![A Mailchimp szakasz az API-kulcs és a Közönség ID-ja mezővel](./kepek/urlap-builder-panel-mailchimp.webp)

*A Mailchimp szakasz az API-kulcs és a Közönség ID-ja mezővel* (https://minta-bolt.hu/wp-admin/post.php?post=355&action=elementor)

A képen az **API-kulcs** és a **Közönség ID-ja** mező látszik.

| Beállítás | Mit írj bele |
|---|---|
| **API-kulcs** | A teljes Mailchimp API-kulcs, a végén lévő `-us…` résszel együtt |
| **Közönség ID-ja** | Annak a közönségnek az azonosítója, amelyre a kapcsolatok kerülnek |

Működés: minden beküldés a közönséghez adja az e-mail-címet feliratkozott (subscribed) státusszal, a keresztnevet pedig az `FNAME` mezőbe. A Mailchimp kétlépcsős megerősítő e-mailje nem megy ki: a kapcsolat közvetlenül feliratkozik. Csak az e-mail-cím és a keresztnév megy át. Mivel a látogatók azonnal feliratkoznak, az űrlapon tájékoztasd őket arról, hogy a levelezőlistádra kerülnek.

Ha semmi sem érkezik meg a Mailchimpbe, másold ki újra az API-kulcsot a kötőjel utáni résszel együtt: a widget ebből találja meg a Mailchimp szerveredet, a megrövidített kulcs nem működik.

## MailerLite

Szükséged van egy MailerLite-fiókra, egy API-tokenre és egy meglévő csoport azonosítójára (Group ID). Az Egyedi ID: `email` az e-mail-címhez.

**API-token a MailerLite-ban:**

1. A bal oldali sávban kattints az **Integrations** pontra.
2. A **MailerLite API** alatt kattints a **Use** gombra.
3. Kattints a **Generate new token** gombra, adj nevet, fogadd el a feltételeket, és kattints a **Create token** gombra.
4. Másold ki a tokent. A MailerLite csak egyszer mutatja meg.

**A csoport azonosítója:**

Ha még nincs csoportod, előbb hozz létre egyet. Utána:

1. Nyisd meg az **Integrations** oldalt, és kattints ismét a **Use** gombra a **MailerLite API** alatt.
2. Görgess az API-oldal aljára, és másold ki a **Group ID**-t.

![A MailerLite szakasz az API-kulcs és a Csoport ID mezővel](./kepek/urlap-builder-panel-mailerlite.webp)

*A MailerLite szakasz az API-kulcs és a Csoport ID mezővel* (https://minta-bolt.hu/wp-admin/post.php?post=355&action=elementor)

A képen az **API-kulcs** és a **Csoport ID** mező látszik.

| Beállítás | Mit írj bele |
|---|---|
| **API-kulcs** | A MailerLite API-tokened |
| **Csoport ID** | Annak a csoportnak az azonosítója, amelyhez a feliratkozók tartoznak. Kötelező. |

Működés: minden beküldés feliratkozóként adja az e-mail-címet a megadott csoporthoz. Csak az e-mail-cím megy át: a keresztnév jelenleg nem jut el a MailerLite-hoz, akkor sem, ha az űrlapban van `first_name` mező. A **Csoport ID** kötelező, nélküle a művelet nem sikerül.

## Drip

Szükséged van egy Drip-fiókra, az API-kulcsra és a fiókod azonosítójára (Account ID). Az Egyedi ID-k: `email` az e-mail-címhez, `first_name` a keresztnévhez és `phone` a telefonszámhoz.

**API-kulcs a Dripben:**

1. Jelentkezz be a Dripbe, kattints a felhasználónevedre jobb felül, és válaszd a **User Settings** pontot.
2. A **User Info** alatt másold ki az **API Token**-t.

**A fiók azonosítója:**

1. A bal oldali sávban nyisd meg a **Settings → Account** oldalt.
2. Görgess lefelé, és a **General Info** alatt másold ki az **Account ID**-t.

![A Drip szakasz az API-kulcs és a Fiók-ID mezővel](./kepek/urlap-builder-panel-drip.webp)

*A Drip szakasz az API-kulcs és a Fiók-ID mezővel* (https://minta-bolt.hu/wp-admin/post.php?post=355&action=elementor)

A képen az **API-kulcs** és a **Fiók-ID** mező látszik.

| Beállítás | Mit írj bele |
|---|---|
| **API-kulcs** | A Drip API-tokened |
| **Fiók-ID** | A Drip-fiókod azonosítója |

Működés: minden beküldés feliratkozóként küldi el a Dripnek az e-mail-címet, a keresztnevet és a telefonszámot. Csak ez a három adat megy át, és a feliratkozó nem kerül kampányba, és címkét sem kap.

## Active Campaign

Szükséged van egy ActiveCampaign-fiókra, az API-kulcsra és az API URL-re. Az Egyedi ID-k: `email` az e-mail-címhez, `first_name` a keresztnévhez és `phone` a telefonszámhoz. Más mező nem megy át.

**API-kulcs és API URL az ActiveCampaignben:**

1. Jelentkezz be az ActiveCampaignbe, és kattints a bal alsó sarokban a **Settings** pontra.
2. A bal oldali menüben kattints a **Developer** elemre.
3. Másold ki az API URL-t és a kulcsot erről az oldalról.

![Az Active Campaign szakasz az API-kulcs és az API URL mezővel](./kepek/urlap-builder-panel-activecampaign.webp)

*Az Active Campaign szakasz az API-kulcs és az API URL mezővel* (https://minta-bolt.hu/wp-admin/post.php?post=356&action=elementor)

A képen az **API-kulcs** és az **API URL** mező látszik.

| Beállítás | Mit írj bele |
|---|---|
| **API-kulcs** | A **Settings → Developer** oldalon látható kulcs |
| **API URL** | Az ugyanott látható URL, például `https://fiokod.api-us1.com` |

Működés: minden beküldés kapcsolatként elküldi az e-mail-címet, a keresztnevet és a telefonszámot az ActiveCampaignnek. A kapcsolat nem kerül listára, és címkét sem kap, ezt az ActiveCampaignben kell rendezned.