Automatizálás-építő

Első lépések a triggerekkel

Minden automatizálás egy triggerrel kezdődik — ez az az esemény, amely elindítja a sorozatot. A trigger határozza meg, mikor fut az automatizálás, és kinek. Amíg nem állítasz be egyet, a vásznon az első csomópont felirata Automatizálás trigger beállítása.

Elérhető trigger típusok

Manuális triggerek

A manuális trigger nem igényel további beállítást — te indítod el az automatizálást a feliratkozó oldaláról.

Dátum alapú triggerek

A dátum trigger a feliratkozó egyik dátum mezőjéhez időzíti az automatizálást. A beállításához válaszd ki:

• Címzettek: a bevonandó csoportokat vagy szegmenseket — a kettő közül az egyiket, két fülön
• Dátum mező: melyik dátumot figyelje (alapmező, mint a „Hozzáadva”, vagy bármely egyéni dátum / dátum-idő mező)
• Időzítés: a dátum előtt, azon a napon vagy utána fusson-e
• Napszak: sima dátum mezőnél az UTC időpont, amikor fusson

Esemény alapú triggerek

• Amikor egy felhasználó leiratkozik: azonnal elsül, amikor egy feliratkozó kijelentkezik
• Amikor egy felhasználó feliratkozik: akkor sül el, amikor egy új feliratkozó a regisztráció után hitelesíti az e-mail címét

API triggerek

Az API trigger lehetővé teszi, hogy egy külső rendszer indítsa el az automatizálást. Kiválasztásakor a trigger panel egy kész kódpéldát mutat, amelyben már benne van a saját automatizálásod azonosítója.

await fetch("https://yaplet.com/api/newsletter/workflow/start", {
    method: "POST",
    headers: {
        "Content-Type": "application/json",
        "Y-API-Key": "your_api_key",
    },
    body: JSON.stringify({
        email: "[email protected]",
        workflow_id: "your-workflow-id",
        key1: "value1",
        key2: "value2",
    }),
});

curl -X POST "https://yaplet.com/api/newsletter/workflow/start" \
  -H "Content-Type: application/json" \
  -H "Y-API-Key: your_api_key" \
  -d '{
    "email": "[email protected]",
    "workflow_id": "your-workflow-id",
    "key1": "value1",
    "key2": "value2"
  }'

<?php
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://yaplet.com/api/newsletter/workflow/start");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
    "Y-API-Key: your_api_key"
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    "email" => "[email protected]",
    "workflow_id" => "your-workflow-id",
    "key1" => "value1",
    "key2" => "value2"
]));

$response = curl_exec($ch);
curl_close($ch);

import requests

response = requests.post(
    "https://yaplet.com/api/newsletter/workflow/start",
    headers={
        "Content-Type": "application/json",
        "Y-API-Key": "your_api_key"
    },
    json={
        "email": "[email protected]",
        "workflow_id": "your-workflow-id",
        "key1": "value1",
        "key2": "value2"
    }
)

Az egyéni adatmezők legfelső szintű mezőkként kerülnek elküldésre az email és workflow_id mellett. Elérhetővé válnak a későbbi EMAIL és WEBHOOK csomópontokban {{key1}}, {{key2}} helyettesítőkkel.

A teljes API dokumentációért, beleértve a hibakódokat, mezőhivatkozást és integrációs legjobb gyakorlatokat, lásd az Automatizálás API dokumentációt.

Az automatizálás felépítése

A trigger beállítása után csomópontok hozzáadásával építsd fel a sorozatot. A Következő lépés hozzáadása az automatizáláshoz hét csomóponttípust kínál: E-mail, Késleltetés, Feltétel, Művelet, Webhook, Adat lekérés és Másik automatizálás.

E-mail csomópontok

Az e-mail csomópontok a sorozat magját képezik — üzeneteket küldenek a feliratkozóknak a sorozat adott pontjain.

E-mail tartalom beállítása

Elérhető e-mail létrehozási opciók

A nulláról: Kezdj üres vászonnal és építsd fel az e-mail dizájnt a vizuális szerkesztővel.

Sablonból: Válassz professzionálisan tervezett sablonokból, amelyek az elköteleződésre és konverzióra vannak optimalizálva.

Korábbi e-mailből: Használd a korábbi kampányaid sikeres e-mail tartalmát a konzisztencia fenntartásához.

E-mail szerkesztő funkciók

Az e-mail szerkesztő teljes funkcionalitású tervezési felületet biztosít meggyőző tartalom létrehozásához. Az e-mail szerkesztő képességeiről részletes információkért lásd az E-mail dizájn és sablonok dokumentációt.

Késleltetés csomópontok

A késleltetés csomópontok várakozási periódusokat adnak a lépések közé, hogy tudatosan oszthasd el a kommunikációidat.

Konfigurációs opciók:

• Várakozási idő: 1–60 perc, 1–24 óra, 1–31 nap, 1–52 hét vagy 1–12 hónap
• Minden egységnek saját felső határa van, így egyetlen csomópont nem tud 90 percet várni — a perc 60-nál megáll. Ehelyett fűzz össze két késleltetés csomópontot: egy 1 órásat, majd egy 30 percest

Felhasználási esetek:

• Adj időt a feliratkozóknak az elköteleződésre a nyomon követő üzenetek küldése előtt
• Oszd el az oktatási tartalmat a gondozó sorozatokban
• Tartsd be a kézbesíthetőségi legjobb gyakorlatokat megfelelő időzítéssel

Feltétel csomópontok

A feltétel csomópontok elágazási logikát hoznak létre, különböző útvonalakra irányítva a feliratkozókat adataik és jellemzőik alapján.

Elérhető feltétel típusok

Feltételek építése

Használd a lekérdezésszerkesztőt logikai kifejezések létrehozásához, amelyek eldöntik, melyik ágra kerül a feliratkozó:

Mező operátorok

Különböző mezőtípusok különböző összehasonlításokat támogatnak:

Művelet csomópontok

A művelet csomópontok módosítják a feliratkozói adatokat vagy csoporttagságokat, amikor a sorozat elér hozzájuk.

Elérhető műveletek

Egyéni mezők frissítése: Feliratkozó információk módosítása

• Szöveges mező értékek beállítása
• Szám mezők növelése/csökkentése
• Dátum mezők beállítása specifikus értékekre vagy relatív dátumokra

Csoport kezelés:

• Másolás csoportokba: Feliratkozók hozzáadása további csoportokhoz
• Áthelyezés csoportokba: Feliratkozók áthelyezése csoportok között
• Eltávolítás csoportokból: Feliratkozók eltávolítása megadott csoportokból

Feliratkozás kezelés:

• Leiratkozottként jelölés: A feliratkozó azonnali leiratkozása

Webhook csomópontok

A webhook csomópontok adatokat küldenek külső szolgáltatásoknak, amikor a sorozat elér hozzájuk, lehetővé téve az integrációkat CRM-ekkel, elemzési platformokkal és egyéni alkalmazásokkal.

Konfiguráció

Hitelesítés

A webhookok Signature fejlécet tartalmaznak a titkos kulcsod HMAC SHA-256 hash-ével. Ellenőrizd a kéréseket a szerveren ugyanazon kulcs hash-elésével és az aláírások összehasonlításával.

Elérhető mező tagek

Használd ezeket a helyettesítőket webhook URL-ekben és törzs értékekben:

Alapmezők:

• {{email}} - Feliratkozó e-mail cím
• {{name}} - Feliratkozó neve
• {{created_at}} - Mikor lett a feliratkozó hozzáadva
• {{state}} - Feliratkozó állapota

Egyéni mezők: {{your_custom_field_tag}} bármely egyéni mezőhöz, amelyet létrehoztál

Dinamikus adatok: Bármely egyéni adat, amelyet API triggereken keresztül küldtek vagy Adat lekérés csomópontokon keresztül szereztek be

Minden helyettesítő elfogad egy opcionális tartalék értéket egy függőleges vonal után — {{name|kedves olvasó}} —, amely akkor kerül felhasználásra, ha az érték hiányzik vagy üres.

Adat lekérés csomópontok

Az Adat lekérés csomópontok információkat kérnek le külső API-kból a későbbi e-mail és webhook csomópontokban való felhasználáshoz.

Konfiguráció

Válasz formátum követelmények

Az API válaszoknak JSON objektumoknak kell lenniük:

• Csak szöveges kulcsok
• Szöveges vagy számértékek
• Maximum 20 mező válaszonként

Példa válasz formátum:

{
    "user_id": "12345",
    "account_type": "premium",
    "last_login": "2024-01-15"
}

Hitelesítés

A webhookokhoz hasonlóan a lekérési kérések Signature fejlécet tartalmaznak HMAC SHA-256 hitelesítéssel.

Váltás másik automatizálásra

Ez a csomópont átadja a feliratkozót egy második automatizálásnak, így a közös logikát egy helyen tarthatod ahelyett, hogy másolgatnád. A vászonra helyezett csomópont felirata Váltás automatizálásra: {name}.

Felhasználási esetek

• Közös belépési sorozatok: Kezdj egy univerzális üdvözlő folyamattal, majd elágazz speciális gondozó útvonalakra
• Újra-elköteleződési kampányok: Irányítsd az inaktív feliratkozókat különböző visszaszerző automatizálásokba
• Szegmentációs logika: Különböző feliratkozó típusokat optimalizált sorozatokon keresztül vezess

Automatikus elrendezés

Ahogy egy automatizálás több ággal és feltétellel bővül, a csomópontok átfedhetik egymást vagy nehézzé válhat a követésük. Az Automatikus elrendezés gomb azonnal átszervezi a teljes fát egy tiszta, kiegyensúlyozott struktúrába.

Kattints az Automatikus elrendezés gombra a jobb felső eszköztárban az összes csomópont átszervezéséhez. A szerkesztő automatikusan zoomol és panorámáz, hogy minden látható legyen.

Az elrendezési motor:

• A triggert középre helyezi felül, és az összes gyermek csomópontot alatta rendezi el
• Ágakat kiegyensúlyoz — a feltétel csomópontok (igen/nem útvonalak) egyenlő vízszintes helyet kapnak
• Egyenletesen eloszt — konzisztens függőleges és vízszintes távolság az összes csomópont között
• Beágyazást kezel — a mélyen elágazó automatizálások átfedés nélkül kerülnek elrendezésre

Generálás AI-val

Teljes automatizálást generálhatsz szöveges leírásból. Ahelyett, hogy egyenként adnád hozzá és kötnéd össze a csomópontokat, írd le, mit szeretnél, és az AI felépíti a csomópont struktúrát neked.

Hogyan használd

Mi kerül generálásra

Az AI a teljes struktúrát létrehozza, beleértve:

• Trigger konfiguráció a megfelelő beállításokkal
• E-mail csomópontok tárgysorokkal és előnézeti szövegekkel (az e-mail tartalmat külön tervezed az e-mail szerkesztővel)
• Késleltetés csomópontok megfelelő várakozási időkkel
• Feltétel csomópontok elágazási logikával a leírásod alapján
• Művelet csomópontok csoportkezeléshez, mező frissítésekhez vagy leiratkozásokhoz
• Webhook és lekérés csomópontok amikor a leírásod külső integrációkat tartalmaz

Generálás után

Miután az AI felépítette a struktúrát:

1. A csomópontok automatikusan elrendezésre kerülnek — az elrendezési motor mindent tisztán pozicionál
2. E-mail tartalom nincs benne — az e-mail csomópontoknak van tárgyuk és előnézeti szövegük, de a tényleges e-mail tartalmat neked kell megtervezned az e-mail szerkesztővel minden csomópontnál
3. Struktúra áttekintése — ellenőrizd, hogy a logika megfelel-e a szándékodnak, és szükség szerint módosíts csomópontokat
4. Aktiválás ha kész — teszteld az e-mailjeidet és kapcsold be az automatizálást

Automatizálás kezelés

Validáció és aktiválás

Az Aktív kapcsoló addig letiltva marad, amíg az automatizálás nem érvényes, és addig figyelmeztetés ül az oldalsáv tetején: „Érvénytelen automatizálás — Be kell állítanod az eseményindítót és legalább egy műveletet az automatizálás használatához.” A gyakorlatban ez azt jelenti:

• A vásznon minden csomópont teljesen be van állítva
• A trigger után van legalább egy lépés

Ha egy már aktív automatizálás később érvénytelenné válik, a Yaplet kikapcsolja helyetted, ahelyett hogy hibásan futtatná.

Minden e-mail lépéshez kész levél kell

Az automatizálás bekapcsolása akkor is elutasításra kerül, ha bármelyik e-mail lépésnek nincs mit küldenie. Az automatizálás inaktív marad, a hibaüzenet pedig megmondja, melyik lépés a hibás (ezek a mondatok jelenleg angolul jelennek meg):

• „An email step has no design yet — open the step and create its email before activating.” — a lépés létrejött, de a levele soha nem készült el.
• „The email step "…" has an empty body — create its email before activating.” — a levél létezik, de a tartalma üres.

Nyisd meg a megnevezett lépést, építsd fel a levelét, ments, majd kapcsold be újra az automatizálást. Az automatizálás kikapcsolása soha nincs letiltva.

Teljesítmény monitorozás

A szerkesztő oldalsávja munka közben élő számlálót mutat:

• Befejezett: befejeződött futások
• Sorban áll: végrehajtásra váró futások
• Sikertelen: hibába ütközött futások

Automatizálás tesztelése

• Küldj teszt e-maileket az e-mail csomópont konfigurációból
• Használj teszt webhookokat és teszt lekéréseket az integrációk ellenőrzéséhez
• Indítsd el kézzel az automatizálást egy teszt feliratkozónál a feliratkozó oldaláról

Legjobb gyakorlatok