Feliratkozók importálása CSV-ből vagy API-n keresztül

Háromféleképpen adhatsz hozzá feliratkozókat

A Yaplet támogatja a tömeges CSV-feltöltést, a REST API-t és az egyenkénti manuális bevitelt. Mindhárom útvonal ugyanazt a deduplikációs logikát alkalmazza: ha egy e-mail-cím már szerepel a listán, a Yaplet frissíti az adott rekordot, nem hoz létre másolatot.

1. lehetőség — CSV-fájl feltöltése

Menj a Hírlevél → Feliratkozók oldalra, és kattints a Feliratkozó hozzáadása gombra. Ez megnyitja az importálási oldalt, ahol alapértelmezetten az Import from CSV/TXT fül van kiválasztva. Letölthető sablonfájl nincs — az oldal két beépített CSV-példát mutat (Template Example 1 és Template Example 2), amelyeket átmásolhatsz és szerkeszthetsz.

1. Készítsd elő a fájlt legalább egy email oszloppal. Az email oszlopfejlécet a rendszer automatikusan felismeri (kis- és nagybetű érzéketlenül). A névoszlopot is automatikusan felismeri olyan fejlécekből, amelyek tartalmazzák a name, firstname vagy lastname szót — ha a firstname és a lastname is jelen van, a rendszer egyetlen névvé fűzi össze őket.
2. Adj hozzá bármilyen egyéni mezőhöz tartozó oszlopot is. Csak az egyéni mezők oszlopainak kell pontosan egyezniük a taggel — az ismeretlen oszlopokat a rendszer figyelmen kívül hagyja.
3. Töltsd fel a fájlt. Az importálás gombon megjelenik a beolvasott sorok száma — ez az egyetlen visszajelzés a beküldés előtt.
4. Kapcsold be a Visszaigazoló e-mail küldése opciót, ha azt szeretnéd, hogy minden importált névjegy erősítse meg a feliratkozását, mielőtt kampányokat kap. Kapcsold ki, ha azonnal Hitelesített állapotba szeretnéd importálni őket (egy háttérben futó e-mail-formátum ellenőrzés után).
5. Kattints az Importálás gombra. Az importálás két perc után időtúllépéssel leáll — bontsd több fájlra, ha néhány ezer sornál nagyobb az állomány.

Minden olyan sor, amelynek e-mail-címe már szerepel a listán, össze lesz vonva: a név és az egyéni mező értékei frissülnek, csoporttagságok hozzáadódnak, a feliratkozó meglévő állapota viszont megmarad. Egy meglévő Leiratkozott névjegyet az újraimportálás nem aktivál újra.

A Yaplet importálás közben ingyen szűri a címeket. Minden olyan sor, amely duplikált, érvénytelen formátumú, eldobható vagy átmeneti tartományhoz tartozik, vagy rendszer-/szerepcím (mint a no-reply@, postmaster@ vagy abuse@), kihagyásra kerül a beszúrás előtt. 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.

A Yaplet emellett 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: a levelezőszolgáltató úgyis visszautasítaná az üzenetet, a kísérlet pedig csak a küldési reputációdba kerülne. Ez fordítva is működik — ha egy cím a Yapleten bárhol véglegesen visszapattan, minden listán Visszapattant állapotba kerül, amelyen szerepel, így egy feliratkozó akkor is Visszapattant lehet, ha te sosem küldtél neki. 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.

Amit a Yaplet nem tud ellenőrizni, az az, hogy egy jó formátumú cím mögött valóban létezik-e postafiók. 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: Figyeld az e-mail-kézbesíthetőségedet). Ha egy lista nagy része használhatatlannak bizonyul, a Yaplet jelzi, és javasolja, hogy előbb ellenőrizd egy olyan szolgáltatással, mint a ZeroBounce, a Kickbox vagy a 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 tartománya már nem fogad levelet, és értesít arról, hogy a kézbesíthetetlen címeket eltávolította.

2. lehetőség — Tömeges upsert API-n keresztül

Küldj hitelesített POST kérést a /api/newsletter/contacts/bulk-upsert végpontra. A hitelesítés a munkaterületed API-kulcsával történik a Y-API-Key fejlécben.

POST /api/newsletter/contacts/bulk-upsert
Y-API-Key: a-munkateruleted-api-kulcsa
Content-Type: application/json

{
  "contacts": [
    {
      "email": "[email protected]",
      "name": "Jane Smith",
      "state": "VERIFIED",
      "fields": { "plan": "pro", "country": "HU" },
      "group_add": ["group-uuid-here"],
      "group_remove": ["other-group-uuid"]
    }
  ]
}

Az egyes névjegyobjektumok mezői:

Mező	Típus	Kötelező	Megjegyzések
email	string	Igen	Az egyedi kulcs a szervezeted azonosítójával együtt. A meglévő névjegyek frissülnek.
name	string	Nem	Csak új névjegyek esetén esik vissza az e-mail-cím @ jel előtti részére, ha üres. A meglévő névjegyek megtartják a jelenlegi nevüket, ha nem küldesz nevet.
state	string	Nem	Elfogadott értékek: VERIFIED, UNVERIFIED, REMOVED. Bármely más értéket a rendszer csendben eldob. A VERIFIED csak akkor érvényesül, ha egy meglévő REMOVED névjegyet léptetsz vissza aktívvá; vadonatúj névjegyeknél hagyd el ezt a mezőt, és bízd a háttérellenőrzésre a döntést.
verification_id	UUID	Nem	A küldendő visszaigazoló e-mail-változat. Az új névjegyek először NEW állapotba kerülnek; a háttérellenőrzés ezután Nem hitelesített (az e-mail elküldésével) vagy Hitelesített állapotba lépteti őket a visszaigazolási kapcsoló és az e-mail-formátum érvényessége alapján.
fields	object	Nem	Kulcs-érték objektum, az egyéni mezőtagokkal kulcsolva. A típusok a mező definíciójához vannak ellenőrizve.
group_add	UUID[]	Nem	Csoportazonosítók tömbje, amelyekhez a névjegyet hozzá kell adni.
group_remove	UUID[]	Nem	Csoportazonosítók tömbje, amelyekből a névjegyet el kell távolítani.
created_at	ISO string	Nem	A névjegy létrehozási időbélyegének felülírása (hasznos másik platformról való átköltözéskor).

A sikeres válasz { "success": true, "results": [...] } formátumú, és tartalmazza a beillesztett vagy frissített névjegyeket. Hibák:

• 401 — hiányzó vagy érvénytelen Y-API-Key.
• 400 — a csomagod névjegy-limitje túllépve. Egyedül ez az állapot vált ki 400-as hibát.

Az érvénytelen state értékek és az ismeretlen egyéni mezőtagek nem váltanak ki hibát — a rendszer csendben kiszűri őket az upsert előtt. Az eldobások észleléséhez hasonlítsd össze a válasz results.length értékét az elküldött contacts tömb méretével.

A meglévő névjegyeket az (email, org_id) páros alapján azonosítja: a név, a mezők és a csoporttagságok frissülnek; a meglévő állapot megmarad, kivéve, ha kifejezetten új állapotértéket küldesz.

3. lehetőség — Feliratkozó manuális hozzáadása

Egyetlen névjegy esetén kattints a Feliratkozó hozzáadása gombra a Feliratkozók oldalon — ez megnyitja az importálási oldalt —, majd válts át az Add Single Subscriber fülre. Add meg az e-mail-címet, opcionálisan egy nevet, az egyéni mező értékeit, és a csoportokat, amelyekhez hozzá szeretnéd adni. Kattints a Mentés gombra.

Feliratkozói állapotok importálás után

Minden importált sor először Új állapotba kerül. Egy háttérfeladat ezután ellenőrzi az e-mail formátumát, és a választott Visszaigazoló e-mail küldése beállítás alapján lépteti tovább a névjegyet:

Állapot	Jelentése
Új	Átmeneti állapot közvetlenül az importálás után. A háttérellenőrzés másodperceken belül felveszi a sort, és az alábbi állapotok valamelyikébe lépteti.
Hitelesített	Kampányokat kap. Akkor állítódik be, ha az importáláskor a visszaigazolás ki volt kapcsolva és az e-mail formátuma érvényes, vagy ha a feliratkozó rákattint a megerősítő linkre.
Nem hitelesített	Az importáláskor a visszaigazolás be volt kapcsolva és az e-mail formátuma érvényes. A rendszer megerősítő e-mailt küld; a névjegy addig nem kap kampányokat, amíg rá nem kattint a linkre.
Leiratkozott	Leiratkozott. Az újraimportálás nem aktiválja újra.
Visszapattant	Visszapattanó (hard bounce) rögzítve az e-mail-szolgáltató részéről — vagy egy olyan cím, amelyről tudjuk, hogy véglegesen kézbesíthetetlen, akkor is, ha te sosem küldtél rá. Az újraimportálás nem aktiválja újra.
Panaszkodott	A címzett spamnek jelölte az üzenetet (SES vagy Hyvor webhook jelzi). Az újraimportálás nem aktiválja újra.
Eltávolítva	Manuálisan el lett távolítva a listáról, vagy a háttérellenőrzés érvénytelennek minősítette az e-mail formátumát és automatikusan eltávolította.

Miután a feliratkozók bekerültek a listádba, mindegyikük rendelkezik egy Engagement pontszámmal, amely a Feliratkozók tábla egyik oszlopaként jelenik meg — automatikusan emelkedik, ahogy a feliratkozó interakcióba lép (+1 megnyitásonként, +3 linkkattintásonként, idővel halmozódva), és a magasabb pontszámú feliratkozók kerülnek előbb sorba minden kampányban.

Mi a következő lépés?

Most, hogy megvannak a feliratkozóid, rendezd őket dinamikus szegmensekbe vagy statikus csoportokba, hogy a kampányokban meghatározott közönséget célozz meg.