Centrul de asistență KWIGA Servicii, integrări, API, Setări Setări generale Utilizarea variabilelor în proiect, listă de variabile disponibile

Utilizarea variabilelor în proiect, listă de variabile disponibile

Articole:

8 luni în urmă • Actualizat

Acest articol explică modul de utilizare a variabilelor în proiectul tău — unde pot fi aplicate, ce date sunt disponibile și cum pot fi folosite pentru automatizare și personalizare. Include o listă cu descrieri și exemple pentru e-mailuri, webhook-uri, butoane, lecții și altele.

Informații generale despre variabile

Variabilele sunt o modalitate convenabilă de a insera date personalizate în diferite elemente ale proiectului dvs. Ele pot fi utilizate în următoarele locuri:

1. Webhook-uri în automatizări

Variabilele pot fi inserate:

în URL-ul webhook-ului, de exemplu:
https://example.com/hook?user={user.email}
în parametrii corpului cererii
în anteturi

Acest lucru permite transmiterea automată a datelor personale către servicii terțe.

2. CTA (Call to Action)

În butoane și linkuri, variabilele pot fi utilizate pentru:

personalizarea textului butonului
transmiterea datelor prin linkuri, de exemplu ID-ul utilizatorului sau etichete UTM

3. În parametri

Variabilele pot fi utilizate în parametrii formularelor sau altor elemente:

email-ul utilizatorului
ID-ul abonamentului
coduri și etichete unice
orice altă variabilă disponibilă în context

4. În linkul de redirecționare (dacă nu se folosește trecerea la plată)

Puteți adăuga variabile manual în linkul de redirecționare:

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

5. În linkul de redirecționare după plata cu succes a ofertei

În linkul de redirecționare după plata cu succes a ofertei sunt disponibile variabilele din blocurile contact.*, order.* și payment.*

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

5. În infoblocurile lecțiilor

Variabilele și blocurile condiționale funcționează în textele blocurilor informative. De exemplu:

Adresare pe nume: Salut, {user.first_name}!
Afișarea numelui cursului, datei, statutului etc.
Datele contactului: {contact.name}, {contact.email} și alte câmpuri
Blocuri condiționale @if/@endif: afișați conținut diferit în funcție de faptul dacă contactul are o etichetă, acces la ofertă etc.

6. În scrisori

Utilizarea variabilelor în e-mailuri permite ca comunicarea să fie mai personalizată și mai eficientă. Cu ajutorul variabilelor, precum {nume}, {data} sau {denumirea cursului}, e-mailul pare adresat personal clientului. Acest lucru crește încrederea, implicarea și probabilitatea ca utilizatorul să citească e-mailul până la capăt sau să efectueze acțiunea dorită. În plus, variabilele simplifică automatizarea trimiterilor în masă fără a pierde abordarea individuală.

7. În notificări

La configurarea notificărilor în acțiunile de automatizare, variabilele permit inserarea dinamică a informațiilor în notificări, de exemplu, numele utilizatorului, numărul comenzii sau denumirea ofertei. Acest lucru simplifică și accelerează procesul de creare a notificărilor, făcându-le mai intuitive și adaptabile pentru diferite scenarii.

Lista variabilelor disponibile

Lista variabilelor disponibile, care sunt disponibile în toate locurile unde se pot folosi variabile.

Variabilă	Valoare
contact.id	ID-ul contactului
contact.user_id	ID-ul utilizatorului
contact.first_name	Numele contactului
contact.last_name	Prenumele contactului
contact.middle_name	Patronimic contact
contact.name	Numele complet al contactului
contact.email	Email-ul contactului
contact.phone	Telefonul contactului
contact.country	Țara contactului. De exemplu: Ucraina
contact.timezone	Fusul orar al contactului. De exemplu: Europe/Kyiv
contact.currency	Valuta contactului. De exemplu: USD
contact.city	Orașul contactului
contact.utm_source	Lista unică de utm_source a contactului (separator ", ")
contact.utm_medium	Lista unică de utm_medium a contactului (separator ", ")
contact.utm_campaign	Lista unică de utm_campaign a contactului (separator ", ")
contact.utm_term	Lista unică de utm_term a contactului (separator ", ")
contact.utm_content	Lista unică de utm_content a contactului (separator ", ")
contact.field_<id>	Câmpuri personalizate (descriere mai jos)
datetime	Data și ora în UTC în formatul YYYY-MM-DD HH:mm:ss
contact.visit_source	Sursa vizitei
Aceste variabile sunt disponibile în linkul de redirecționare după plata cu succes a ofertei.

Câmpuri personalizate

{contact.field_<id>}

Exemplu {contact.field_123}

<id> - id-ul câmpului, care poate fi obținut în setările câmpurilor de contact (exemplu https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

Cum să modifici valoarea unei variabile

După variabilă poți adăuga opțiuni pentru a-i schimba aspectul: să adaugi text, să faci literele mari sau să formatezi data.

Format general: {variable|option:value|option}. De exemplu: {order.id|prefix:ORDER-} sau {payment.paid_at|format:DD.MM.YYYY}.

Ce vrei să obții	Ce să scrii
Adaugă text înainte de valoare	`{order.id\|prefix:ORDER-}` -> vei obține `ORDER-123`
Adaugă text după valoare	`{order.id\|suffix:-EU}` -> vei obține `123-EU`
Fă numărul cu lungime fixă	`{payment.number\|pad:6}` -> vei obține `000001`
Completează nu cu zerouri, ci cu propriul simbol	`{payment.number\|pad:6\|padchar:_}` -> vei obține `_____1`
Fă toate literele mari	`{contact.city\|upper}` -> `KYIV`
Fă toate literele mici	`{contact.city\|lower}` -> `kyiv`
Fă mare doar prima literă	`{contact.city\|ucfirst}` -> `Kyiv`
Afișează data în formatul dorit	`{payment.paid_at\|format:DD.MM.YYYY}` -> vei obține `24.12.2026`

Dacă vrei propriul tău șablon de dată, poți consulta notațiile gata făcute în documentația publică: pentru variante precum DD.MM.YYYY, MMMM YYYY, dddd este potrivită documentația Carbon. Pentru variante precum Y-m-d și H:i:s este potrivită documentația oficială PHP.

Important: dacă se folosește pad, mai întâi valoarea este completată până la lungimea necesară și abia apoi se aplică celelalte opțiuni.

Blocuri condiționale @if / @endif

Permit afișarea sau ascunderea unei părți din text în funcție de o condiție. Dacă condiția este adevărată, blocul este afișat; dacă nu — este eliminat complet.

Sintaxă: @if(condiție)...text...@endif

Exemplu:
@if({contact.has|offer:123})Obțineți acces la materiale@endif

Condiția din interiorul @if() este orice variabilă care returnează true sau false. În acest moment este acceptat {contact.has|...} (verificarea apartenenței contactului).

Condiția contact.has — verificarea contactului

Permite verificarea dacă un contact corespunde anumitor condiții. Returnează true sau false. De obicei este folosită împreună cu blocurile condiționale @if/@endif.

Sintaxă: {contact.has|tip:valoare}

Tip	Valoare	Descriere
`offer`	ID-ul ofertei	Contactul are acces la ofertă
`order`	ID-ul comenzii	Contactul are o comandă cu acest ID
`product`	ID-ul produsului	Contactul are acces la produs
`tag`	ID-ul sau numele etichetei	Contactul are o etichetă (sunt acceptate chirilica și spațiile în denumire)
`list`	ID-ul listei	Contactul este inclus în listă
`course`	ID-ul cursului	Contactul este înscris la curs
`marathon`	ID-ul cursului	Pseudonim pentru course (maratonul — un subtip al cursului)
`webinar`	ID-ul webinarului	Contactul are acces la webinar
`closed_group`	ID-ul grupului închis	Contactul are acces la grupul închis

Se pot specifica mai multe condiții prin | — toate trebuie îndeplinite simultan (logica AND). De exemplu: {contact.has|offer:123|tag:VIP}

Exemple de utilizare:

{contact.has\|offer:123}	verifică existența ofertei cu ID 123
{contact.has\|tag:VIP}	verifică eticheta după nume
{contact.has\|tag:тест тег}	etichetă cu spațiu și chirilică
{contact.has\|offer:123\|tag:VIP}	ambele condiții simultan (AND)

Variabile care pot fi utilizate suplimentar în CTA

în parametri
în linkul de redirecționare (dacă nu se folosește trecerea la plată)

Variabilă	Valoare
first_name	Prenumele din cerere
last_name	Numele de familie din cerere
middle_name	Patronimic din cerere
name	Numele complet din cerere
email	Email din cerere
phone	Telefon din cerere
field_<id>	Câmpuri personalizate Telefon din cerere (descriere mai jos)
utm_source	utm_source - specific vizitei de la care a fost lăsată cererea
utm_medium	utm_medium - specific vizitei de la care a fost lăsată cererea
utm_campaign	utm_campaign - specific vizitei de la care a fost lăsată cererea
utm_term	utm_term - specific vizitei de la care a fost lăsată cererea
utm_content	utm_content - specific vizitei de la care a fost lăsată cererea
widget_landing	Url-ul landing page-ului de unde a fost trimisă cererea
widget_landign_referer	Referer-ul care a fost pe landing page când a fost trimisă cererea
De asemenea, în anumite formulare pot fi disponibile variabilele descrise mai jos în Variabile disponibile în webhook-urile de automatizare Pe comandă ({order.}) - Dacă este selectată opțiunea de formular Acces la produs (Acces complet/Pe ofertă) Pe produs({product.}) - Dacă este selectată opțiunea de formular Acces la produs + Acces complet Pe ofertă ({offer.*}) - Dacă este selectată opțiunea de formular Acces la produs + Pe ofertă

Câmpuri personalizate

{field_<id>}

Exemplu {contact.field_123}

<id> - id-ul câmpului, care poate fi obținut în setările câmpurilor de contact (exemplu https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

Dacă pe pagina unde este plasat CTA sau scriptul Kwiga pentru urmărirea vizitelor au fost vizite cu etichete utm, iar clientul a lăsat o cerere pe landing page deja fără etichete utm, atunci în aceste variabile ele vor lipsi. Dar vor fi disponibile în variabilele {contact.utm_...}, care sunt descrise mai sus.

Variabile disponibile în webhook-urile de automatizare (url, parametri, emailuri)