Importálás / Exportálás

Tudd meg, hogyan importálhatsz feliratkozókat tömegesen fájlokból vagy API-n keresztül, és hogyan exportálhatod a feliratkozói adataidat külső felhasználásra.

Feliratkozók importálása

Adj hozzá feliratkozókat a hírlevéledhez tömegesen CSV fájlokkal, egyéni bevitelekkel vagy az API-n keresztül.

Tölts fel egy CSV vagy TXT fájlt több feliratkozó egyszerre történő importálásához.

Fájl követelmények:

  • Kötelező mezők: email*, name* (a csillag jelöli a kötelezőt)
  • Egyéni mezők: Bármilyen további mező, amelyet a feliratkozóidhoz hoztál létre
  • Formátum: Vesszővel elválasztott értékek, soronként egy feliratkozó

Sablon példák:

Basic Template
email*,name*,custom_field1,custom_field2
[email protected]*,John Doe*,Value1,Value2
[email protected]*,Jane Smith*,Value3,Value4
Advanced Template
email*,firstname*,lastname*,custom_field1,custom_field2
[email protected]*,John*,Doe*,Value1,Value2
[email protected]*,Jane*,Smith*,Value3,Value4

A kötelező oszlopok csillaggal (*) vannak jelölve. A rendszer automatikusan felismeri és kombinálja a névvel kapcsolatos oszlopokat (name, firstname, lastname) egyetlen teljes név mezővé.

Importálási lehetőségek:

  • Hozzáadás csoportokhoz: Válassz meglévő csoportokat az importált feliratkozók hozzáadásához
  • Hitelesítő e-mail küldése: Megerősítő e-mailek küldése az új feliratkozóknak
Ingyenes listatisztítás. Importálás közben a Yaplet automatikusan kidobja azokat a sorokat, amelyekről már tudja, hogy nem kézbesíthetők — a duplikált, hibás formátumú, eldobható/ideiglenes domainű és rendszer-/szerepcímeket (mint a no-reply@, postmaster@ vagy abuse@). A duplikátumok kimaradnak — a meglévő feliratkozó változatlan marad. Kapsz egy Lista megtisztítva összegzést, okonkénti bontással, például „42 kézbesíthetetlen cím kihagyva: 30 érvénytelen, 5 eldobható, 7 rendszer/no-reply.” Ugyanez a szűrő fut a bulk-upsert API-n is, amely a kihagyott darabszámokat a válaszában adja vissza.
Már ismerten halott címek. A Yaplet nyilvántartja azokat a címeket, amelyek a platformon bárhol véglegesen visszapattantak — vagyis a postafiók már nem létezik. Ha a fájlod ilyet tartalmaz, a feliratkozó bekerül a listádra, de azonnal Visszapattant állapotban, és soha nem kap levelet. Ez szándékos: a levelezőszolgáltató úgyis visszautasítaná az üzenetet, a kísérlet pedig csak a küldési reputációdba kerülne. Csak a végleges visszapattanás működik így — a leiratkozás és a spam-panasz egy adott feladóról szóló döntés, ezért soha nem kerül át más fiókok közé. Sem te nem tudsz meg semmit más Yaplet-fiókokról, sem ők a tiédről.
Ami egyszer „nem”, az „nem” marad. Ha egy leiratkozott, visszapattant vagy spampanaszt tett feliratkozót újra importálsz, attól nem lesz újra feliratkozott — akkor sem, ha előtte törölted. A Yaplet megjegyzi, mely címek mondtak nemet a fiókodban, így az újra importált feliratkozó a régi állapotával (leiratkozott, spampanasz vagy visszapattant) érkezik, és nem kap levelet. Újra feliratkozni csak maga a személy tud — lásd: Feliratkozó hitelesítés.
A Yaplet nem tudja megerősíteni, hogy egy valódi postafiók létezik-e — csak azt, hogy a cím jó formátumú és nem eldobható. Meg nem erősített, vásárolt vagy elavult lista importálása visszapattanásokat és spam-panaszokat okoz, a magas arány pedig automatikusan leállítja a küldésedet (lásd: Email kézbesíthetőség). Ha egy lista nagy része használhatatlan, a Yaplet jelzi, és javasolja, hogy küldés előtt futtasd át egy ellenőrző szolgáltatáson — például ZeroBounce, Kickbox vagy MillionVerifier. Csak olyan listákat importálj, amelyek a tiéd, és van engedélyed őket emailezni.
A Yaplet importálás után is tisztán tartja a listát: egy háttérellenőrzés eltávolítja azokat a kontaktokat, amelyek domainje már nem fogad levelet. Fájlimport után a Newsletter jogosultsággal rendelkező tagok importonként egy értesítést kapnak a vezérlőpulton arról, hogy a kézbesíthetetlen címek eltávolításra kerültek. Az API-n vagy munkafolyamaton keresztül hozzáadott kontaktokat ugyanígy ellenőrzi és eltávolítja, de értesítés nélkül.
Amikor hitelesítő e-mailek kerülnek kiküldésre, a feliratkozók "UNVERIFIED" állapotba kerülnek, és nem kapnak hírlevél e-maileket, amíg nem kattintanak a hitelesítő linkre az e-mailjükben.
name
string
A feliratkozó teljes neve. Opcionális - ha nincs megadva, az e-mail felhasználónév részt használja.
verification_id
string
A saját hitelesítő e-mail variánsaid egyikének azonosítója — bármilyen más azonosító esetén az egész hívás 400 "Unknown verification_id" hibával leáll. Egy új vagy eltávolított kontakt megkapja ezt a hitelesítő e-mailt, az állapota pedig "NEW" lesz. Egy leiratkozott kontakt legfeljebb 30 naponta egyszer kap új hitelesítő e-mailt, és leiratkozott marad, amíg a személy meg nem erősíti. A visszapattant vagy spampanaszt tett kontaktok soha nem kapnak ilyet. Opcionális - elhagyása esetén egy új kontakt automatikusan hitelesítettként lesz jelölve.
state
string
Kontakt állapot. Érvényes értékek: "VERIFIED", "UNVERIFIED", "REMOVED". A "VERIFIED" csak új vagy eltávolított kontaktnál működik: "NEW"-ként mentjük, és a Yaplet szokásos háttérellenőrzésén megy át, amely hitelesíti (vagy előbb elküldi a verification_id-ben megadott hitelesítő e-mailt). A visszapattant vagy spampanaszt tett kontaktok megtartják az állapotukat — a többi mezőjük ettől még frissül. Egy leiratkozott kontaktot a state nem hoz vissza, csak egy új hitelesítő e-mail megerősítése (lásd verification_id). Opcionális - alapértelmezett a hitelesítési beállítások alapján.
fields
object
Egyéni mező adatok kulcs-érték párokként. Az értékek a meglévő mezőkkel összefésülésre kerülnek (nem lecserélésre). A mezőtípusok automatikusan konvertálódnak (dátumok, számok). Szám mezőnél null vagy "" küldésével törölheted az értéket; minden más, nem szám érték kimarad, és a feliratkozó megtartja a jelenlegi értékét. Opcionális.
group_add
string[]
Csoport azonosítók tömbje, amelyekhez a kontaktot hozzá kell adni. A csoportoknak léteznie kell és a szervezetedhez kell tartozniuk. Opcionális.
group_remove
string[]
Csoport azonosítók tömbje, amelyekből a kontaktot el kell távolítani. A csoportoknak léteznie kell és a szervezetedhez kell tartozniuk. Opcionális.

Kódpélda magyarázat:

  • URL: https://yaplet.com/api/newsletter/contacts/bulk-upsert - A teljes API végpont URL
  • Fejlécek:
    • Content-Type: application/json - JSON payload-hoz szükséges
    • Y-API-Key: your_api_key_here - Cseréld ki a tényleges API kulcsodra a vezérlőpultról
  • Kérés törzs: Egy contacts tömböt tartalmaz feliratkozó objektumokkal
  • Helyettesítők cseréje:
    • your_api_key_here → A tényleges API kulcsod
    • [email protected] → A feliratkozó e-mailje
    • verification_variant_id → Azonosító a hitelesítő e-mail variánsaidból (ha hitelesítő e-maileket küldesz)
    • group_id_1, group_id_2 → Tényleges csoport azonosítók a szervezetedből
    • custom_field_1, custom_field_2 → Az egyéni mező tag neveid
    • value_1, value_2 → Az egyéni mezők tényleges értékei

API megjegyzések:

  • Csak az email mező kötelező minden kontakthoz, minden más opcionális
  • verification_id nélkül az új feliratkozók automatikusan hitelesített állapotba kerülnek — egy leiratkozott kontakt, amelyet verification_id nélkül küldesz el újra, leiratkozott marad
  • verification_id megadásával az új és az eltávolított kontaktok "NEW" állapotban indulnak, majd a hitelesítő e-mail kiküldésekor "UNVERIFIED" állapotba kerülnek, és ott is maradnak, amíg rá nem kattintanak
  • Egy leiratkozott, visszapattant vagy spampanaszt tett kontaktot az API soha nem állít vissza feliratkozottra vagy hitelesítettre — akkor sem, ha törölted, és újra elküldöd
  • A válasz minden kontaktot azzal az állapottal sorol fel, amelyben a hívás után ténylegesen van, így látod, melyik tartotta meg az állapotát
  • A fields objektumból hiányzó értékek nem kerülnek frissítésre/beszúrásra
  • A szervezetedhez nem tartozó csoport azonosítókat a rendszer figyelmen kívül hagyja — a kontakt így is mentésre kerül, csak az adott csoportba nem kerül be, illetve onnan nem kerül ki

Feliratkozók exportálása

Töltsd le a feliratkozói adataidat CSV fájlként külső felhasználásra vagy biztonsági mentésre.

Exportálási lehetőségek

Összes exportálása

Hely: Jobb felső "Összes exportálása" gomb
Hatókör: A szervezeted összes feliratkozójának letöltése
Felhasználási eset: Teljes feliratkozói biztonsági mentés vagy migráció

Szűrt exportálás

Hely: Jobb felső "Szűrt exportálás" gomb (csak szűrők alkalmazásával) Hatókör: Az aktuális szűrőknek megfelelő összes feliratkozó
Felhasználási eset: Specifikus szegmensekből vagy csoportokból származó feliratkozók exportálása

Kijelöltek exportálása

Hely: Csoport műveletek menü → "CSV exportálás"
Hatókör: Csak a kijelölt feliratkozók az aktuális nézetből
Felhasználási eset: Szűrt vagy manuálisan kiválasztott feliratkozók exportálása

Exportálási viselkedés

Oszlop kiválasztás:

  • Csak a látható oszlopok kerülnek bele az exportba
  • Használd az oszlop láthatósági vezérlőket mezők megjelenítéséhez/elrejtéséhez exportálás előtt
  • Az alapmezők (E-mail, Név, Hozzáadva, Állapot) alapértelmezetten láthatók
  • Az Aktivitás és az aktivitási oszlopok (E-mail-szolgáltató, Utolsó aktivitás, Utolsó megnyitás, Utolsó kattintás, Kattintások, Kapott e-mailek, Utolsó kapott e-mail) szerepeltethetők exportoszlopként — csak exportálhatók, így nem használhatók importoszlopként. A nulla pontszám vagy darabszám 0-ként kerül az exportba, nem üres cellaként
  • Az egyéni mezők alapértelmezetten rejtettek, hacsak nem engedélyezed

Fájl formátum:

  • Formátum: Vesszővel elválasztott értékek (.csv)
  • Kódolás: UTF-8
  • Fejlécek: Oszlopnevek az első sorban
  • Adatok: Soronként egy feliratkozó
Exportálás előtt állítsd be az oszlop láthatósági beállításokat, hogy csak a szükséges adatmezőket tartalmazza a CSV fájlod.

Exportálási folyamat

Exportálási módszer kiválasztása

  • Kattints az "Összes exportálása" gombra a teljes feliratkozói listához
  • Vagy alkalmazz szűrőket, jelölj ki feliratkozókat, majd használd a "CSV exportálás" opciót a csoport műveletekből

Oszlopok konfigurálása

Használd az oszlop láthatósági vezérlőket a mezők megjelenítéséhez/elrejtéséhez az exportban

Exportálás megerősítése

Tekintsd át a megerősítő párbeszédablakot nagy exportálásoknál

Fájl letöltése

A CSV fájl automatikusan letöltődik az alapértelmezett letöltési mappádba :::

Nagy exportálások (10 000+ feliratkozó) feldolgozása több percet vehet igénybe. Értesítést kapsz, amikor az exportálás megkezdődik.

Tömeges műveletek és exportálás

Csoport műveletek használatakor exportáláshoz:

  • Összes kijelölése: Az aktuális szűrt nézetben lévő összes feliratkozó exportálása
  • Egyéni kijelölés: Csak a bejelölt feliratkozók exportálása (legfeljebb 10 000)
  • Szűrt eredmények: Az aktuális lekérdezésszerkesztő szűrőket alkalmazza az exportálásra
Az exportálás figyelembe veszi az összes aktív szűrőt, szegmenst és csoportkorlátozást. Csak az aktuális nézetedben látható feliratkozók kerülnek bele a CSV-be.

© 2026 Yaplet HU. All rights reserved.