KWIGA súgóközpont Services, integrations, API, Settings General setting Using variables on the project, list of available variables

Using variables on the project, list of available variables

Cikkek:

7 hónapja • Frissítve

This article explains how to use variables in your project—where to apply them, what data is available, and how to use them for automation and personalization. Includes a list with descriptions and examples for emails, webhooks, buttons, lessons, and more.

Általános információ a változókról

A változók kényelmes módot kínálnak arra, hogy személyre szabott adatokat illesszen be a projekt különböző elemeibe. Ezeket az alábbi helyeken lehet használni:

1. Webhookok az automatizálásokban

A változók behelyettesíthetők:

a webhook URL-jében, például:
https://example.com/hook?user={user.email}
a kérés törzsének paramétereiben
a fejlécekben

Ez lehetővé teszi a személyes adatok automatikus továbbítását külső szolgáltatásokba.

2. CTA (Call to Action)

A gombokban és linkekben a változók az alábbiakra használhatók:

a gomb szövegének személyre szabására
adatok átadására linkeken keresztül, például felhasználóazonosító vagy UTM-címkék

3. Paraméterekben

A változók használhatók űrlapok vagy más elemek paramétereiben:

a felhasználó email-címe
előfizetésazonosító
egyedi kódok és címkék
bármely más változó, amely elérhető az adott kontextusban

4. Az átirányítási linkben (ha nincs fizetésre irányítás)

A változókat kézzel is hozzáadhatja az átirányítási linkhez:

https://my.site.com/thanks?email={user.email}&course={course.title}

5. Az ajánlat sikeres kifizetése utáni átirányítási linkben

Az ajánlat sikeres kifizetése utáni átirányítási linkben a contact.*, order.* és payment.* blokkok változói érhetők el

Példa: https://my.site.com/success?order_id={order.id}&email={contact.email}&payment_price={payment.price}

6. Az leckék információs blokkjaiban

A változók működnek az információs blokkok szövegein belül. Például:

Név szerinti megszólítás: Szia, {user.first_name}!
A kurzus címének, dátumának, állapotának stb. megjelenítése

7. E-mailekben

A változók használata az e-mailekben lehetővé teszi, hogy a kommunikáció személyesebb és hatékonyabb legyen. Az olyan változók segítségével, mint a {nev}, a {datum} vagy a {kurzus_neve}, az e-mail úgy hat, mintha személyesen a kliensnek szólna. Ez növeli a bizalmat, az elköteleződést és annak valószínűségét, hogy a felhasználó végigolvassa az e-mailt vagy végrehajtja a kívánt műveletet. Emellett a változók megkönnyítik a tömeges kiküldések automatizálását az egyéni megközelítés elvesztése nélkül.

8. Értesítésekben

Az értesítések automatizálási műveletekben történő beállításakor a változók lehetővé teszik az információk dinamikus beillesztését az értesítésekbe, például a felhasználó nevét, a rendelési számot vagy az ajánlat nevét. Ez egyszerűsíti és felgyorsítja az értesítések létrehozásának folyamatát, intuitívabbá és rugalmasabbá téve azokat a különböző forgatókönyvekhez.

Elérhető változók listája

Az elérhető változók listája, amelyek minden olyan helyen használhatók, ahol változók alkalmazhatók.

Változó	Érték
contact.id	Kapcsolat ID
contact.user_id	Felhasználó ID
contact.first_name	Kapcsolat keresztneve
contact.last_name	Kapcsolat vezetékneve
contact.middle_name	Kapcsolat apai neve
contact.name	Kapcsolat teljes neve
contact.email	Kapcsolat e-mail címe
contact.phone	Kapcsolat telefonszáma
contact.country	Kapcsolat országa. Például: Ukrajna
contact.timezone	Kapcsolat időzónája. Például: Europe/Kyiv
contact.currency	Kapcsolat pénzneme. Például: USD
contact.city	Kapcsolat városa
contact.utm_source	A kapcsolat egyedi utm_source értékeinek listája (elválasztó: ", ")
contact.utm_medium	A kapcsolat egyedi utm_medium értékeinek listája (elválasztó: ", ")
contact.utm_campaign	A kapcsolat egyedi utm_campaign értékeinek listája (elválasztó: ", ")
contact.utm_term	A kapcsolat egyedi utm_term értékeinek listája (elválasztó: ", ")
contact.utm_content	A kapcsolat egyedi utm_content értékeinek listája (elválasztó: ", ")
contact.field_<id>	Egyéni mezők (leírás alább)
datetime	Dátum és idő UTC-ben YYYY-MM-DD HH:mm:ss formátumban
contact.visit_source	Látogatás forrása
Ezek a változók az ajánlat sikeres kifizetése utáni átirányítási linkben érhetők el.

Egyéni mezők

{contact.field_<id>}

Példa {contact.field_123}

<id> - a mező azonosítója, amely a kapcsolatmezők beállításaiban szerezhető meg (példa https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

A változó értékének módosítása

A változó után opciókat lehet hozzáadni, hogy megváltoztassa a megjelenését: szöveget hozzáfűzni, nagybetűssé tenni, vagy formázni a dátumot.

Általános forma: {variable|option:value|option}. Például: {order.id|prefix:ORDER-} vagy {payment.paid_at|format:DD.MM.YYYY}.

Mit szeretne kapni	Mit kell írni
Szöveg hozzáadása az érték elé	`{order.id\|prefix:ORDER-}` -> eredmény: `ORDER-123`
Szöveg hozzáadása az érték után	`{order.id\|suffix:-EU}` -> eredmény: `123-EU`
A szám fix hosszúságúvá tétele	`{payment.number\|pad:6}` -> eredmény: `000001`
Ne nullákkal, hanem saját karakterrel töltse fel	`{payment.number\|pad:6\|padchar:_}` -> eredmény: `_____1`
Az összes betű nagybetűssé tétele	`{contact.city\|upper}` -> `KYIV`
Az összes betű kisbetűssé tétele	`{contact.city\|lower}` -> `kyiv`
Csak az első betű legyen nagybetűs	`{contact.city\|ucfirst}` -> `Kyiv`
A dátum megjelenítése a kívánt formában	`{payment.paid_at\|format:DD.MM.YYYY}` -> eredmény: `24.12.2026`

Ha saját dátumsablont szeretne, a kész jelöléseket megnézheti a nyilvános dokumentációkban: az olyan formátumokhoz, mint DD.MM.YYYY, MMMM YYYY, dddd, megfelelő a Carbon dokumentációja. Az olyan formátumokhoz, mint Y-m-d és H:i:s, megfelelő a hivatalos PHP dokumentáció.

Fontos: ha a pad használatban van, az érték először a szükséges hosszra egészül ki, és csak ezután kerülnek alkalmazásra a többi opciók.

A CTA-ban kiegészítően használható változók

a paraméterekben
az átirányítási hivatkozásban (ha nincs fizetésre irányítás használatban)

Változó	Érték
first_name	Keresztnév az űrlapbeküldésből
last_name	Vezetéknév az űrlapbeküldésből
middle_name	Apai név az űrlapbeküldésből
name	Teljes név az űrlapbeküldésből
email	E-mail az űrlapbeküldésből
phone	Telefonszám az űrlapbeküldésből
field_<id>	Egyéni mezők Telefon az űrlapbeküldésből (leírás alább)
utm_source	utm_source - pontosan abból a látogatásból, amelyből az űrlapbeküldés történt
utm_medium	utm_medium - pontosan abból a látogatásból, amelyből az űrlapbeküldés történt
utm_campaign	utm_campaign - pontosan abból a látogatásból, amelyből az űrlapbeküldés történt
utm_term	utm_term - pontosan abból a látogatásból, amelyből az űrlapbeküldés történt
utm_content	utm_content – pontosan annak a látogatásnak az adata, amelyből az érdeklődői jelentkezés érkezett
widget_landing	Annak a landing oldalnak az URL-je, ahonnan a jelentkezést elküldték
widget_landign_referer	Az a referer, amely a landing oldalon volt, amikor a jelentkezést elküldték
Bizonyos űrlapokban az alább, az automatizálási webhookokban elérhető Változók részben leírt változók is elérhetők lehetnek Rendelés szerint ({order.}) - Ha az űrlaptípusnál a Termékhozzáférés lehetőség van kiválasztva (Teljes hozzáférés/Ajánlat szerint) Termék szerint ({product.}) - Ha az űrlaptípusnál a Termékhozzáférés + Teljes hozzáférés lehetőség van kiválasztva Ajánlat szerint ({offer.*}) - Ha az űrlaptípusnál a Termékhozzáférés + Ajánlat szerint lehetőség van kiválasztva

Egyéni mezők

{field_<id>}

Példa {field_123}

<id> - a mező azonosítója, amely a kapcsolatmezők beállításaiban szerezhető meg (példa https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

Ha azon az oldalon, ahol a CTA vagy a Kwiga látogatáskövető szkriptje el van helyezve, voltak utm címkével érkező látogatások, és az ügyfél már utm címkék nélkül küldött be jelentkezést a landing oldalon, akkor ezekben a változókban nem fognak szerepelni. De elérhetők lesznek a fent leírt {contact.utm_...} változókban.

Az automatizálási webhookokban elérhető változók (url, paraméterek, e-mailek)