Munkafolyamat-ötletek és receptek

Munkafolyamat kell, vagy valami egyszerűbb?

A munkafolyamat egy forgatókönyv: minden alkalommal ugyanazt teszi, ugyanabban a sorrendben. Ez az erőssége — és ezért gyakran több annál, amire szükséged van. Mielőtt építesz egyet, nézd meg ezt a táblázatot:

Akkor építs munkafolyamatot, ha olyasmire van szükséged, amit csak egy forgatókönyv garantál: pontos szövegre, kötött sorrendű kérdésekre, a válaszok szerinti elágazásra, egy mindig megtörténő átadásra, vagy egy olyan hívásra, amely csak a látogató Igenje után változtat meg valamit.

A kettő össze is kapcsolható. Egy gyors művelet gomb vagy egy beszélgetésindító elindíthat egy munkafolyamatot, egy munkafolyamat pedig egy Küldés VEX AI-nak lépéssel egy körre visszaadhatja a szót az AI-nak.

Receptek

Minden recept leírja, mit csinál, mi indítja, milyen lépésekből áll sorrendben, hogyan tartsd biztonságban a kapcsolatát, és mi lenne az egyszerűbb megoldás. A lépéseket és a mezőiket a Folyamatszerkesztő, a triggereket az Így indul egy munkafolyamat cikk magyarázza el. Az idézőjeles szövegek csak javaslatok, az olyan értéknevek pedig, mint az order_number, a te választásod.

Üdvözöld a látogatókat, amikor megnyitják a chatet

A leggyakoribb munkafolyamat: egy rövid köszönés abban a pillanatban, amikor valaki megnyitja a chatet.

Akkor indul, amikor: Chat megnyitása. Látogatónként egyszer fut, hacsak nem módosítod a Milyen gyakran beállítást, és csendben marad, ha a látogató írt, vagy egy ügyintéző válaszolt az elmúlt 3 órában.

Lépések:

1. Üzenet írása — „Szia! Kérdezz bármit a szállításról, a visszaküldésről vagy a rendelésedről.”
2. Nem kötelező: Gombok a két-három leggyakoribb témáddal, mindegyik a saját kártyájára vezet.

Változat: ha akkor köszönnél, amikor a látogató megérkezik, nem pedig amikor megnyitja a chatet, használd a Látogatás triggert, és szűkítsd a Csak akkor induljon, ha szűrővel — például a Jelenlegi oldal szerint.

Kapcsolat: nincs — semmi nem hagyja el a Yapletet.

Egyszerűbb megoldás: a kezdőlap üdvözlő és köszöntő üzenetéhez (Márka → Chat widget → Kezdőoldal) egyáltalán nem kell munkafolyamat. Ha a köszönés az oldaltól vagy attól függ, mennyi ideje van ott valaki, egy Elköteleződés chat üzenet egyszerűbb.

Kényes témák átadása egy embernek — előbb egy Igennel

Olyan kérdésekhez, amelyekre az AI nem válaszolhat magától, például egészségügyi, jogi vagy fiókbiztonsági témákhoz. A munkafolyamat felajánl egy ügyintézőt, és a látogató dönt.

Akkor indul, amikor: A felhasználó mondja, a Mit kér a látogató mezőben ezzel: „A látogató orvosi tanácsot kér, vagy egy egészségi állapotról kérdez.”

Lépések:

1. Üzenet írása — „Egészségügyi kérdésekben nem adhatok tanácsot, de egy kollégánk tud segíteni. Összekösselek vele?”
2. Gombok — Igen, kérem / Nem, köszönöm.
3. Az Igen, kérem után: Ügyintéző kérése, egy Megjegyzés az ügyintézőnek sorral, például: „Egészségügyi kérdés — olvasd el a látogató fenti üzenetét.”
4. A Nem, köszönöm után: Küldés VEX AI-nak — „A látogató nem kért ügyintézőt. Csak általános termékinformációval válaszolj, egészségügyi tanácsot ne adj.” Ebben a körben az AI nem indít munkafolyamatot, és nem ajánl fel újra ügyintézőt.

Kapcsolat: nincs.

Egyszerűbb megoldás: ha az AI-nak csak azt kell tudnia, mit mondjon a témáról, írd bele a Márka → Tudás oldalra. A munkafolyamat akkor a jó választás, ha a felajánlásnak minden alkalommal meg kell történnie, a te szavaiddal.

Súgómenü gombokkal

A leggyakoribb témáid kötött menüje, egy koppintásnyira egy embertől.

Akkor indul, amikor: Nincs automatikus indítás — egy Munkafolyamat Indítása típusú gyors művelet gombbal vagy egy beszélgetésindítóval indítsd. Ha mindenkinek meg akarod mutatni, aki megnyitja a chatet, használd helyette a Chat megnyitása triggert.

Lépések:

1. Üzenet írása — „Miben segíthetek?”
2. Gombok — Szállítás / Visszaküldés / Beszélnék valakivel / Ennyi, köszönöm.
3. A Szállítás és a Visszaküldés után: Üzenet írása a válaszoddal, szó szerint.
4. A Beszélnék valakivel után: Ügyintéző kérése.
5. Az Ennyi, köszönöm után: Leállítás — nincs válasz, így a beszélgetés csendben véget ér.

Kapcsolat: nincs.

Egyszerűbb megoldás: írd a válaszokat a Márka → Tudás oldalra, és a gyors művelet gombok küldjék el a kérdéseket az AI-nak. A menü akkor éri meg, ha a válaszoknak pontosan a te szövegeidnek kell lenniük, vagy ha egy embert egyetlen koppintással el kell tudni érni.

Rendelés állapota a webshopodból

A látogató megkérdezi, hol a rendelése. A munkafolyamat elkéri az adatokat, megkeresi a rendelést a webshopodban, és a valódi állapottal válaszol.

Akkor indul, amikor: A felhasználó mondja — „A látogató tudni szeretné, hol van a rendelése, vagy mikor érkezik meg.”

Lépések:

1. Adatgyűjtés → A látogató saját e-mail címe. Ha a címe már megvan, a látogató egy koppintással megerősíti.
2. Adatgyűjtés → Valami mást, Szöveg válasz típussal — „Mi a rendelésszámod?”, a Válasz mentése így mezőben order_number névvel.
3. API hívás — POST a https://shop.example.com/yaplet/order-status címre, bekapcsolt Yaplet aláírással, a Mit küldjön mezőben Mezők (JSON-ként küldve): order_number = {{ order_number }} és email = {{ email }}. A válaszból olvasd ki a status (Szöveg) és a delivery_date (Szöveg, Nem kötelező) értéket.
4. A Sikerült után: Feltételek — Ha a status munkafolyamat érték egyenlő ezzel: shipped, akkor Üzenet írása — „A(z) rendelésed úton van — várható érkezés: .” Egyébként: Üzenet írása — „A(z) rendelésedet most készítjük elő.”
5. A Nem sikerült után: Üzenet írása — „Ezekkel az adatokkal nem találtam rendelést.” —, majd Munkafolyamat indítása az átadó munkafolyamatoddal.

Az átadást egyszer építsd meg. Készíts belőle egy saját kis munkafolyamatot — egy Ügyintéző kérése lépést, az értékekkel a Megjegyzés az ügyintézőnek mezőben —, és minden ágat, amelynek emberre van szüksége, zárj le egy Munkafolyamat indítása lépéssel. Az elindított munkafolyamat megkapja az addig összegyűjtött összes érték másolatát.

Kapcsolat: aláírt hívás. A webshopod csak akkor válaszol, ha a rendelésszám és az e-mail cím is egyezik; ha a látogatóid be vannak jelentkezve, inkább a {{ external_id }} alapján keresd meg a rendelést. Az állapotot és a dátumot add vissza, a címet és a fizetési adatokat soha. Lásd: Biztonságos kapcsolatok.

Egyszerűbb megoldás: egy API eszköz ugyanezt a keresést végzi el, csak az AI kéri el az adatokat, és a saját szavaival válaszol. A munkafolyamatot akkor válaszd, ha kötött szöveget, mindig megtörténő átadást vagy állapotonként eltérő választ szeretnél.

Rendelés lemondása — csak egy Igen után

Olyan, mint a rendelésállapot-recept, de ez a munkafolyamat megváltoztat valamit a rendszeredben, ezért a látogató előbb megerősíti.

Akkor indul, amikor: A felhasználó mondja — „A látogató le szeretne mondani egy rendelést.”

Lépések:

1. Adatgyűjtés → A látogató saját e-mail címe.
2. Adatgyűjtés → Valami mást — „Melyik rendelést szeretnéd lemondani?”, order_number néven mentve.
3. API hívás — keresd meg a rendelést egy aláírt POST hívással, ahogy a rendelésállapot-receptben, és olvasd ki a can_cancel értéket Igen / nem típussal.
4. A Nem sikerült után: Ügyintéző kérése, a rendelésszámmal a Megjegyzés az ügyintézőnek mezőben.
5. A Sikerült után: Feltételek — Ha a can_cancel munkafolyamat érték igaz, folytasd a 6. lépéssel. Egyébként: Ügyintéző kérése, az Üzenet a látogatónak mezőben ezzel: „Online már nem lehet lemondani — egy kollégánk megnézi, mit tehetünk.”
6. A Ha után: Üzenet írása — „A(z) rendelésed még lemondható. Lemondjam?” —, majd Gombok — Igen, mondd le / Nem, maradjon.
7. Az Igen, mondd le után: API hívás — aláírt POST a lemondási címedre. A Sikerült ága után: Üzenet írása — „Kész — a(z) rendelésedet lemondtuk.” A Nem sikerült ága után: Ügyintéző kérése.
8. A Nem, maradjon után: Üzenet írása — „Rendben, semmi nem változott.”

Kapcsolat: a változtatás előtti Gombok lépés nem elhagyható — egy olyan hívás előtt, amely megváltoztat valamit, semmi más nem kérdez rá, akkor sem, ha a munkafolyamatot az AI indította el magától. A szervered a lemondás előtt újra ellenőrzi, hogy a rendelés ezekhez az adatokhoz tartozik; soha nem hagyatkozik a korábbi keresésre. Az API hívás a POST kérést soha nem ismétli meg, így a Yaplet magától soha nem próbálja újra a lemondást.

Egyszerűbb megoldás: ha ritkán mondanak le rendelést, hagyd el a második hívást, és bízd egy ügyintézőre: Ügyintéző kérése a rendelésszámmal a megjegyzésben.

Sérült vagy hibás termék: panaszűrlap

Az AI a látogató saját szavaiból felismeri a panaszt, és megnyitja a panaszűrlapodat.

Akkor indul, amikor: A felhasználó mondja — „A látogató sérült, hibás vagy rossz terméket kapott.”

Lépések:

1. Adatgyűjtés → Valami mást — „Mi a rendelésszámod?”, order_number néven mentve.
2. Üzenet írása — „Sajnáljuk! Kérlek, töltsd ki ezt a rövid űrlapot — egyenesen a csapatunkhoz kerül.”
3. Űrlap indítása — a panaszűrlapod a Ticketek → (tábla) → Űrlapok oldalról, a Kitöltés ebből a folyamatból alatt a rendelésszám mezőjébe írt {{ order_number }} értékkel. Minden beküldés ticketként érkezik arra a táblára.

Csatornák: az űrlap kizárja a munkafolyamatot a Facebookról, az Instagramról, az e-mailből és a telefonhívásokból. Ha Adatgyűjtés és Kérdés feltevése lépésekből, valamint egy olyan Ügyintéző kérése lépésből építed, amelynek a megjegyzése tartalmazza a válaszokat, Facebookon és Instagramon is fut.

Kapcsolat: nincs.

Egyszerűbb megoldás: egy Űrlap Megnyitása típusú gyors művelet gomb munkafolyamat nélkül is megnyitja ugyanazt az űrlapot.

Nem működő kuponkód

Összegyűjti, amire a csapatodnak szüksége lesz, mielőtt egy ügyintéző átveszi.

Akkor indul, amikor: A felhasználó mondja — „A látogató szerint egy kupon- vagy kedvezménykód nem működik.”

Lépések:

1. Adatgyűjtés → Valami mást — „Melyik kódot használtad?”, coupon_code néven mentve.
2. Adatgyűjtés → A látogató saját e-mail címe.
3. Kérdés feltevése — „Mi történt, amikor beírtad?”, coupon_problem néven mentve.
4. Ügyintéző kérése — Üzenet a látogatónak: „Köszönjük — egy kollégánk elintézi.” Megjegyzés az ügyintézőnek: „Kupon: — ”.

Kapcsolat: nincs.

Egyszerűbb megoldás: írd a kuponszabályaidat — lejárati dátumok, minimális kosárérték, kizárt termékek — a Márka → Tudás oldalra, és az AI a legtöbb nem működő kódot maga elmagyarázza. A munkafolyamatot tartsd meg azokra az esetekre, amelyekhez ember kell.

Jelentkezések, az AI válaszol a kérdésekre

Azoknak, akik partnerként, viszonteladóként vagy csapattagként csatlakoznának.

Akkor indul, amikor: A felhasználó mondja — „A látogató partnernek szeretne jelentkezni.”

Lépések:

1. Üzenet írása — két-három sorban, hogy kit keresel.
2. Gombok — Jelentkezem / Kérdésem van.
3. A Jelentkezem után: Űrlap indítása a jelentkezési űrlapoddal.
4. A Kérdésem van után: Küldés VEX AI-nak — „A látogatót érdekli a partnerprogramunk. Válaszolj a kérdésére a partnerprogram oldalai alapján.” Az AI a tudásodból válaszol, a látogató következő üzenete pedig újra egy hétköznapi AI-kör.

Kapcsolat: nincs.

Egyszerűbb megoldás: egy tudásbáziscikk a programról, és egy gyors művelet gomb, amely megnyitja a jelentkezési űrlapot.

Értékesítési érdeklődők begyűjtése

Nagyobb csomagról, egyedi árazásról vagy bemutatóról szóló kérdésekhez.

Akkor indul, amikor: A felhasználó mondja — „A látogató vállalati csomagról, egyedi árazásról vagy egy nagyobb csapatnak szóló bemutatóról érdeklődik.” Az Értékek, amiket az AI ügynök kiolvas az üzenetből alatt add hozzá a team_size értéket — „Hányan használnák, ha a látogató megmondta.”

Lépések:

1. Üzenet írása — „Szívesen segítünk — két gyors kérdés, hogy a megfelelő kolléga keressen.”
2. Adatgyűjtés → A látogató saját e-mail címe.
3. Kérdés feltevése — „Mire használnád?”, use_case néven mentve.
4. Ügyintéző kérése — Megjegyzés az ügyintézőnek: „Értékesítési érdeklődő. Csapatméret: . Felhasználás: ”. Ha a csapatodból senki sem elérhető, a webchat az üzenethagyó kártyát mutatja a látogatónak, ahol mindent megírhat a csapatodnak.

Kapcsolat: nincs. Ha az érdeklődőt a CRM-edbe is el akarod küldeni, adj hozzá egy API hívás lépést: aláírt POST hívást, csak azokkal a mezőkkel, amelyekre a CRM-nek szüksége van.

Egyszerűbb megoldás: egy Elköteleződés chat üzenet az árazási oldaladon beszélgetésre hív; egy űrlap ugyanezeket az adatokat ticketként gyűjti be.

Ajánlatok és spam figyelmen kívül hagyása

Vannak üzenetek, amelyekre egyáltalán nem kell válaszolni.

Akkor indul, amikor: A felhasználó mondja — „A feladó el akar adni nekünk valamit, vagy az üzenet spam.”

Lépések:

1. Leállítás — nincs válasz, egy Megjegyzés a csapatnak sorral, például: „Értékesítési ajánlat — figyelmen kívül hagyva.”

Kész sablon: az Új munkafolyamat → Ajánlatok és spam figyelmen kívül hagyása megépíti helyetted, kikapcsolva.

Csatornák: működik a chatben, Facebookon, Instagramon és e-mailben. Egy hívónak nem lehet csenddel válaszolni, ezért telefonhívásban nem fut. E-mailben a beszélgetés az AI-nál marad, nem kerül a csapatod sorába.

Kapcsolat: nincs.

Ha senki nem veszi fel: válasz e-mailben vagy visszahívás

A látogató ügyintézőt kért, de még senki nem válaszolt. Ahelyett hogy csendben hagynád, ajánlj fel egy módot, ahogyan elérhetitek.

Akkor indul, amikor: Nem vette fel ügyintéző, a Percek mezőben 5 perccel (legfeljebb 45). Kérésenként egyszer indul, ha azóta senki nem vette át a beszélgetést, és egyetlen ügyintéző sem írt.

Lépések:

1. Üzenet írása — „Bocsánat a várakozásért — most mindenki foglalt. Hogyan keressünk?”
2. Gombok — Írjatok e-mailt / Hívjatok vissza / Megvárom.
3. Az Írjatok e-mailt után: Adatgyűjtés → A látogató saját e-mail címe, majd Üzenet írása — „Köszönjük! Erre a címre válaszolunk: .”
4. A Hívjatok vissza után: Adatgyűjtés → Valami mást, Szöveg válasz típussal — „Melyik számon hívjunk?”, callback_number néven mentve. (Nem phone néven: az a látogató saját adatainak egyike.) Utána Üzenet írása — „Köszönjük — ezen a számon hívunk: .” A szám a látogató válaszaként a beszélgetésben is megjelenik, így a csapatod látja.
5. A Megvárom után: Üzenet írása — „Köszönjük a türelmed — hamarosan jelentkezik valaki.”

A beszélgetés közben végig a csapatod sorában marad.

Csatornák: a Gombok lépés kizárja ezt a munkafolyamatot az e-mailes beszélgetésekből.

Kapcsolat: nincs.

Egyszerűbb megoldás: ennek nagy része be van építve. A webchatben az a látogató, aki úgy kér embert, hogy a csapatodból senki sem elérhető, azonnal megkapja az üzenethagyó kártyát, és az is megkapja, akinek a kérése után 5 perccel még senki nem válaszolt — ekkor „A csapat még nem tudott válaszolni” címmel. A kártyán egyenesen a chatbe írja meg, mire van szüksége, és megadhatja az e-mail címét. Akkor építsd meg ezt a munkafolyamatot, ha a saját szavaidat vagy választási lehetőségeidet szeretnéd, például visszahívást, vagy 5 perctől eltérő várakozást: amíg be van kapcsolva, a márkánál átveszi a beépített 5 perces kártya helyét. Facebookon és Instagramon is eléri a látogatókat, ahol kártya nem jelenik meg.

Értékelés kérése egy jó pontszám után

Egy elégedett értékelésből nyilvános vélemény lesz, egy gyengéből pedig tanulság.

Akkor indul, amikor: Értékelés érkezett. A munkafolyamat két értékkel indul: a rating egy 1 és 5 közötti szám, a comment pedig az, amit a látogató hozzáírt.

Lépések:

1. Feltételek — Ha a rating munkafolyamat érték nagyobb 3-nál.
2. A Ha után: Üzenet írása — „Köszönjük! Megírnád ezt egy értékelésben is?” —, majd Gombok — Értékelést írok / Most nem.
3. Az Értékelést írok után: Link megnyitása — az értékelési oldalad, bekapcsolt Megnyitás új lapon kapcsolóval.
4. A Most nem után: Üzenet írása — „Semmi gond — még egyszer köszönjük!”
5. Az Egyébként után: Üzenet írása — „Sajnáljuk, hogy most nem sikerült jól.” —, majd Kérdés feltevése — „Mit csinálhattunk volna jobban?”, feedback néven mentve. Ha személyesen is utánamennél, zárd egy Ügyintéző kérése lépéssel, és a Megjegyzés az ügyintézőnek mezőbe írd be a {{ rating }}, a {{ comment | nincs megjegyzés }} és a {{ feedback }} értéket.

Csatornák: a chat widgetben, Facebookon és Instagramon indul. Ez utóbbi kettőn az értékelési linket szövegként küldjük, és az értékelésekhez nem tartozik megjegyzés.

Kapcsolat: nincs.

Egyszerűbb megoldás: ha csak meg akarod köszönni, elég egyetlen Üzenet írása lépés, a szövegében az értékelési linkkel.

Segítség sikertelen fizetés után

A weboldalad jelzi a Yapletnek, hogy egy fizetés nem sikerült, a chat pedig azonnal segítséget ajánl.

Akkor indul, amikor: Egyedi esemény, az Esemény neve mezőben payment_failed. A fejlesztőd egyetlen sort illeszt be oda, ahol a fizetés meghiúsul, egy olyan oldalon, amelyen rajta van a Yaplet widget:

Yaplet.trackEvent('customEvent', { name: 'payment_failed', order_id: '1234', amount: 59 })

Minden mást, amit az oldal küld, értékként kapsz meg — itt az order_id és az amount értéket. A Csak akkor induljon, ha → Esemény adat szűrővel például csak az 50 fölötti összegekre reagálhatsz.

Lépések:

1. Üzenet írása — „Úgy tűnik, a(z) rendelés fizetése nem sikerült. Segíthetek?”
2. Gombok — Újrapróbálom / Beszélnék valakivel.
3. Az Újrapróbálom után: Link megnyitása — https://shop.example.com/checkout/{{ order_id }}, kikapcsolt Megnyitás új lapon kapcsolóval.
4. A Beszélnék valakivel után: Ügyintéző kérése — Megjegyzés az ügyintézőnek: „Sikertelen fizetés a(z) rendelésnél ().”

Kapcsolat: az esemény adatai a látogató böngészőjéből érkeznek, mint minden, amit egy weboldal küld. Egy üzenetbe jók, de semmit nem bizonyítanak: soha ne nyiss meg, ne téríts vissza és ne változtass meg velük semmit a saját rendszered ellenőrzése nélkül.

Egyszerűbb megoldás: egy Elköteleződés chat üzenet is reagálhat az oldaladról érkező egyedi eseményre — ez elég, ha egy üzenet megteszi, és nem kellenek gombok vagy átadás.

Munkafolyamatok építése AI-val

Egy AI megtervezheti és megépítheti helyetted a munkafolyamatot: az irányítópulton Vexszel, vagy a saját AI alkalmazásodból. Mindkét esetben ugyanazokat a szabályokat követi, és ugyanazokkal az ellenőrzésekkel dolgozik, mint a szerkesztő.

Az irányítópulton: Létrehozás AI-val és Szerkesztés AI-val

Mindkét gomb egy kis mezőt nyit maga mellett, ahová a saját szavaiddal leírhatod, mit szeretnél. Az Enter azonnal elküldi a kérést Vexnek; az Esc elküldés nélkül bezárja a mezőt. A gombokat azok a csapattagok látják, akiknek van Vex asszisztens jogosultságuk.

A Létrehozás AI-val a Márka → (a márkád) → Munkafolyamatok oldal tetején található; a mezője ezt kérdezi: „mit csináljon a munkafolyamat”, a kérés pedig magától megnevezi ezt a márkát.

A Szerkesztés AI-val a szerkesztő felső sávjában található; a mezője ezt kérdezi: „mi változzon”.

• Vex pontosan úgy látja a vásznat, ahogy a képernyődön van, a nem mentett módosításokkal együtt.
• Ha az ellenőrzése sikeres, alatta megjelenik egy Alkalmazás a vásznon gomb. Ez a vászonra teszi a módosítást — még semmi nincs elmentve —, a megjelenő értesítésben pedig ott a Visszavonás.
• A módosítás megtartásához nyomd meg a Mentés gombot. Így módosíthatsz AI-val egy közzétett munkafolyamatot is: Vex soha nem menti el, hanem te.

Hívások egy még nem létező rendszerhez. Ha egy munkafolyamatnak API hívás lépés kell, de a rendszerednek még nincs hozzá címe, Vex vázlatként adja hozzá a lépést: cím nélkül, a lépés paneljén pedig egy megjegyzéssel — Mit kell tennie ennek a hívásnak (az AI írta) —, amely elmondja a fejlesztődnek, mit kell megépítenie. Ha elkészült, a címet és az esetleges jelszót te magad írd be a lépésbe; az Eltávolítás törli a megjegyzést. Vex soha nem kér címet vagy jelszót a chatben. Egy munkafolyamat nem tehető közzé, amíg valamelyik API hívás lépésének nincs címe.

A saját AI alkalmazásodból

A Claude Desktop, a Claude Code, a Cursor és a többi alkalmazás, amely a Yaplet MCP szerverén keresztül kapcsolódik, ugyanezt meg tudja tenni. Elolvassák a munkafolyamat-útmutatót, ellenőrzik a tervet, létrehoznak egy munkafolyamatot (kikapcsolva), módosítanak egy kikapcsolt munkafolyamatot — egészében vagy egyetlen lépését —, duplikálnak egy munkafolyamatot, akár egy másik márkába is, kikapcsolnak egyet, elolvassák a legutóbbi futásait, és a pontos nevével törölnek egy kikapcsolt munkafolyamatot. API eszközöket is létrehozhatnak, módosíthatnak és törölhetnek.

• Jogosultságok: annak a személynek, akinek a nevében az alkalmazás fut, Chat munkafolyamatok jogosultság kell, az API eszközökhöz pedig Tartalomforrások. Böngészős bejelentkezésnél pipáld be a Workflows területet — az API eszközökhöz a Chatbot területet is.
• Jelszavak: egy alkalmazás beírhat helyetted jelszavakat — titkos fejléceket, a Yaplet aláírás titkos kulcsát és API eszközök kulcsait. Ez akkor hasznos, ha ugyanaz az AI munkamenet a végpontodat is megépíti, például a Claude Code-ban. Egyetlen alkalmazás sem tud jelszót visszaolvasni: csak azt látja, hogy van-e beállítva.

Amit egy AI soha nem tesz

• Kikapcsolva hozza létre a munkafolyamatokat, és csak kikapcsoltakat módosít. Ha egy közzétett munkafolyamatot kellene módosítania, a kérést elutasítjuk: előbb kapcsold ki a munkafolyamatot, vagy duplikáld, és az AI a másolatot módosítsa. A Szerkesztés AI-val bármelyik munkafolyamaton működik, mert a módosítása csak a vászonra kerül, és te mented el.
• Kikapcsolhat egy munkafolyamatot — például ha rosszul működik.
• Csak kikapcsolt munkafolyamatot töröl, egyszerre egyet, a pontos nevével.

Biztonságos kapcsolatok

Egy API hívás lépés vagy egy API eszköz a beszélgetést a saját rendszereiddel köti össze. Ezek a szabályok tartják biztonságban a látogatóid adatait és a rendszereidet. Minden AI, amely munkafolyamatot épít a Yapletben, ugyanezeket a szabályokat tanulja meg, és amikor ellenőriz egy tervet, a Yaplet figyelmeztet minden olyan hívásra, amely Yaplet aláírás nélkül küld látogatói adatot, vagy változtat meg valamit.

1. Tudd, miből ismeri fel a rendszered a Yapletet. Mielőtt egy AI hívást épít, megkérdezi, hogyan ellenőrzi a rendszered, ki hívja. Ha nem tudod, kérdezd meg a fejlesztődet — a szokásos válasz a Yaplet aláírás.
2. Írj alá minden hívást. Minden API hívás lépésen kapcsold be a Yaplet aláírást, és adj meg egy titkos kulcsot, amelyet a szervered is tárol; az API eszközök mindig aláírják a hívásaikat. Így minden hívás egy Signature fejlécet visz a kulcs SHA-256 lenyomatával, a szervered pedig elutasítja azt a hívást, amelyikben nincs meg a helyes érték. A fejléc minden hívásban ugyanaz — azt bizonyítja, hogy a hívó ismeri a kulcsot, azt nem, hogy mit tartalmaz a hívás —, ezért a kulcs ne kerüljön weboldalba és naplóba, és ha kiszivárog, cseréld le.
3. Személyes adat csak az aláírt felhasználónak. Csak a {{ external_id }} bizonyítja, ki a látogató: ez az a felhasználói azonosító, amelyet a weboldalad aláír (lásd: Személyazonosság ellenőrzése). Az e-mail, a név és az egyedi attribútumok a látogató böngészőjéből érkeznek. A rendeléseket és a fiókadatokat a {{ external_id }} alapján keresd meg. Amit egy látogató beír, vagy amit az AI egy API eszköz mezőibe tölt, soha nem írhatja felül a visitor_id, az external_id, az fb_id és az insta_id értéket.
4. Nincs bejelentkezés? Kérj két adatot, amelyeknek egyezniük kell. A be nem jelentkezett látogatóktól kérj két olyan adatot, amelyet együtt csak a jogos személy tud — például a rendelésszámot és azt az e-mail címet, amellyel a rendelést leadták —, és csak akkor válaszolj, ha mindkettő egyezik. Egyetlen kitalálható szám soha nem elég. Korlátozd, hányszor próbálkozhat egy látogató.
5. Változtatáshoz Igen kell. Egy olyan hívás előtt, amely lemond, módosít vagy lefoglal valamit, semmi nem kér megerősítést — akkor sem, ha a munkafolyamatot az AI indította el magától. Tegyél elé egy Gombok lépést, amely megerősítést kér a látogatótól, vagy bízd a változtatást egy ügyintézőre. A szervered ilyenkor is ellenőrzi, hogy ez a személy megteheti-e.
6. Csak HTTPS. Az API hívás lépések és az API eszközök csak https:// címeket hívnak; a sima http-t elutasítjuk.
7. Csak azt küldd és add vissza, amire szükség van. A rendelésszámot küldd, ne a látogató teljes profilját. Az állapotot és a szállítási dátumot add vissza, ne a címet vagy a fizetési adatokat — bármi, amit a rendszered visszaküld, a chatbe kerülhet.
8. A jelszavak maradjanak ki a chatből. Az API-kulcsokat és tokeneket bekapcsolt Jelszó kapcsolós fejlécbe tedd — a szervereinken tároljuk, és soha többé nem mutatjuk meg —, soha ne a címbe, egy üzenetbe vagy egy AI-val folytatott chatbe.

Ellenőrzőlista a fejlesztődnek

• Csak HTTPS kérést fogadj el.
• Hasonlítsd össze a Signature fejlécet a közös titkos kulcs SHA-256 lenyomatával, állandó idejű összehasonlítással, és ha nem egyezik, 401-gyel válaszolj.
• A személyes adatot az aláírt external_id alapján keresd meg, vagy kérj két adatot, amelyeknek egyezniük kell.
• Csak azokat a mezőket add vissza, amelyekre a válaszhoz szükség van.
• Korlátozd a látogatónkénti kérések számát.
• Változtatás előtt ellenőrizd újra, hogy ez a személy megteheti-e — a munkafolyamat előbb a látogatót kérdezi meg.
• Soha ne naplózd a titkos kulcsot vagy a Signature fejlécet.

A rendelésállapot-recept mögötti végpont Node.js-ben:

const crypto = require("crypto");
const express = require("express");

const app = express();
// The same secret you typed into Yaplet, kept in your server's settings
const expected = crypto.createHash("sha256").update(process.env.YAPLET_SECRET).digest("hex");

function isFromYaplet(req) {
    const received = String(req.headers["signature"] || "");
    if (received.length !== expected.length) return false;
    return crypto.timingSafeEqual(Buffer.from(received), Buffer.from(expected));
}

app.post("/yaplet/order-status", express.json(), async (req, res) => {
    if (!isFromYaplet(req)) return res.status(401).json({ error: "Not allowed" });

    const { order_number, email } = req.body;
    const order = await findOrder(order_number); // your own lookup
    // Two facts must match: never answer from the order number alone
    if (!order || order.email.toLowerCase() !== String(email || "").toLowerCase()) {
        return res.status(404).json({ error: "No matching order" });
    }
    // Only what the answer needs
    res.json({ status: order.status, delivery_date: order.deliveryDate });
});

A 401-es vagy 404-es válasz a lépés Nem sikerült kimenetére viszi a futást, ahol a munkafolyamatod elmondja, hogy nem találta a rendelést.

Tudj meg többet