Documentație Fidelizam - Este o platformă completă de fidelizare a clienților pentru afaceri.

Ghid complet pentru toate funcționalitățile platformei — pentru membri, parteneri și administratori.

Introducere

Fidelizam - Este o platformă completă de fidelizare a clienților pentru afaceri. este o platformă completă de fidelizare a clienților, destinată afacerilor de orice dimensiune. Permite crearea și gestionarea de programe de loialitate digitale — carduri cu puncte, carduri cu ștampile, vouchere, campanii de marketing și multe altele.

Membrii

Clienții care colectează puncte, ștampile și folosesc vouchere

Partenerii

Afacerile care creează programele de fidelizare și gestionează membrii

Administratorii

Echipa care administrează întreaga platformă și configurează setările

Contul de Membru

Membrii sunt clienții finali ai platformei. Aceștia se pot înregistra, autentifica și gestiona cardurile de fidelitate din portofelul lor digital.

Înregistrare și autentificare

Creare cont cu email + verificare OTP (cod unic trimis pe email)
Autentificare cu email + parolă
Autentificare prin cod OTP (fără parolă)
Link magic de autentificare (login fără parolă, prin link semnat)
Resetare parolă prin email
Deconectare (logout)

Portofel digital (Dashboard)

Vizualizare centralizată a tuturor cardurilor de loialitate urmărite
Carduri sortate după activitate recentă
Acces rapid la balansul de puncte și nivelul de tier al fiecărui card
Acces la toate voucherele salvate

Legarea dispozitivelor

Conectarea mai multor dispozitive la același cont de membru
Sincronizarea automată a punctelor și recompenselor între dispozitive

Carduri de loialitate cu puncte

Sistemul principal de fidelizare bazat pe acumularea și răscumpărarea punctelor. Membrii câștigă puncte la fiecare achiziție și le pot folosi pentru recompense.

Vizualizare card

Balans de puncte, nivel tier curent, progres spre nivelul următor, lista de recompense disponibile

Recompense

Vizualizare detalii recompensă, inițierea procesului de revendicare prin link semnat QR

Urmărire card

Adaugă sau elimină un card din portofelul personal (follow/unfollow)

Istoric tranzacții

Vizualizarea istoricului complet de câștigare și utilizare puncte per card

Cum funcționează revendicarea recompensei?

Membrul accesează recompensa dorită → se generează un link semnat (URL unic) → personalul scanează sau accesează link-ul → confirmă revendicarea. Procesul este securizat prin semnătura criptografică a URL-ului.

Carduri cu ștampile (Stamp Cards)

Sistemul de tip „cumpără 10, primești 1 gratis". Membrii colectează ștampile la fiecare vizită sau achiziție și primesc o recompensă când completează cardul.

Vizualizare card cu ștampile colectate și numărul total necesar pentru recompensă

Înrolare și dezinscriere din programul de ștampile

Progres vizual al ștampilelor colectate

Revendicare automată a recompensei la completarea cardului

Istoric complet al ștampilelor primite

Vouchere & reduceri

Sistemul de vouchere permite partenerilor să creeze și distribuie coduri de reducere de mai multe tipuri. Membrii le pot salva în portofel și folosi la achiziții.

Reducere procentuală

Ex: 20% reducere la orice achiziție

Sumă fixă

Ex: 50 RON reducere la achiziții peste 200 RON

Produs gratuit

Ex: un produs specific inclus gratuit

Puncte bonus

Ex: 2x puncte la următoarea achiziție

Funcționalități pentru membri

Salvarea/bookmarking voucherelor în portofelul personal
Vizualizare detalii voucher (valoare, condiții, expirare)
Utilizare voucher prin cod la personal sau la casă
Revendicare voucher din link QR de batch (acces direct fără cont)

Câștigarea punctelor

Membrii pot acumula puncte prin mai multe metode — la achiziții directe, prin coduri speciale sau prin cereri de puncte între membri.

Coduri de puncte

Partenerul generează coduri unice de câștigare puncte. Membrul introduce codul în aplicație și primește instantaneu punctele aferente.

Coduri de utilizare unică (single-use)
Coduri cu limită de utilizări
Coduri cu expirare configurabilă
Coduri asociate cu un card specific

Cereri de puncte între membri

Un membru poate genera un link de cerere de puncte și îl poate distribui. Oricine accesează link-ul poate trimite puncte respectivului membru.

Generare link partajabil de cerere puncte
Setarea unui card specific pentru primire
Limitarea numărului de utilizări al link-ului
Setarea datei de expirare a cererii
Trimitere puncte prin link-ul altui membru

Programul de referral

Membrii pot invita prietenii și pot câștiga recompense pentru fiecare persoană care se înregistrează prin link-ul lor personal.

Link personal de referral

Fiecare membru primește un cod și link unic de invitare

Dashboard referral

Vizualizează câți membri s-au înregistrat prin link-ul tău și recompensele câștigate

Recompense automate

La înregistrarea unui utilizator invitat, recompensa se acordă automat

Landing page localizat

Pagina de landing pentru link-ul de referral se afișează în limba utilizatorului

Niveluri de loialitate (Tiers)

Sistemul de niveluri oferă beneficii suplimentare membrilor care acumulează mai multe puncte, motivând loialitatea pe termen lung.

Calificare bazată pe puncte/cheltuieli/tranzacții

Criteriile de avansare la nivelul următor sunt configurabile de partener

Multiplicator de puncte per nivel

Membrii la nivel superior câștigă mai multe puncte la aceeași achiziție (ex: Gold = 2x puncte)

Reduceri la răscumpărare per nivel

Nivelurile superioare beneficiază de procente mai mari la utilizarea punctelor

Beneficii personalizate per nivel

Partenerul poate defini avantaje exclusive pentru fiecare nivel (acces VIP, livrare gratuită etc.)

Niveluri multiple ierarhice

Se pot defini oricâte niveluri (Bronze → Silver → Gold → Platinum etc.)

Contul de Partener

Partenerii sunt afacerile (magazine, restaurante, clinici etc.) care creează programe de fidelizare pe platformă.

Autentificare partener

Înregistrare cont cu email, nume afacere, date personale și opțional date firmă (CUI, Reg. Com.)
Verificare email prin cod OTP
Autentificare cu email + parolă sau OTP
Link magic de autentificare (fără parolă)
Resetare parolă
Selectare plan de abonament la înregistrare (inclusiv facturare lunară/anuală)

Notă privind planurile

Fiecare plan include limite pentru: număr de cluburi, membri, personal, locații, carduri de loialitate, recompense. Planul poate fi ales la înregistrare sau modificat ulterior din contul partenerului.

Dashboard-ul partenerului

Interfața principală a partenerului, cu statistici și acces rapid la toate funcționalitățile platformei.

Analytics carduri de loialitate

Număr total de membri înrolați pe fiecare card
Puncte emise și răscumpărate în timp
Recompense revendicate (număr și valoare)
Drill-down per card — statistici detaliate pentru fiecare card în parte

Analytics carduri cu ștampile

Număr ștampile acordate în total și per perioadă
Rate de completare (câți membri finalizează cardul)
Recompense acordate din ștampile
Vizualizare per card de ștampile

Analytics vouchere

Rata de utilizare per voucher (câte au fost folosite din total generate)
Breakdown pe membri — cine a folosit voucherele
Valoarea totală a reducerilor acordate
Vizualizare per batch de vouchere

Tranzacții

Istoric complet al tranzacțiilor de puncte (filtrate per membru și card)
Anulare ultima tranzacție (undo) pentru un membru
Istoric ștampile cu posibilitate de anulare
Istoric voucher cu anulare/invalidare tranzacție specifică

Gestionare batch-uri vouchere

Wizard de creare batch: tip, valoare, cantitate, expirare
Listare și gestionare batch-uri existente
Export batch în CSV
Activare/dezactivare batch
Ștergere batch sau vouchere neutilizate
Extindere dată expirare batch
Import coduri externe din CSV
Analytics per batch

Jurnal activitate

Vizualizare analytics pe jurnalul de activitate al partenerului
Urmărire activitate personal, tranzacții, autentificări

Asistent AI

Generare sugestii de conținut pentru campanii
Răspunsuri la întrebări despre platforma partenerului

Campanii de marketing

Partenerul poate crea campanii de marketing targetate, cu programare și segmentare avansată a audienței.

Gestionare campanii

Creare, editare, vizualizare și ștergere campanii de marketing

Targetare audiență

Configurare segmente de membri după criterii specifice (nivel tier, activitate, etc.)

Programare

Setarea datei și orei de start/end a campaniei, frecvență de repetare

Analytics campanie

Urmărire performanță: afișări, click-uri, conversii per campanie

Campanii de email

Trimite emailuri personalizate direct membrilor clubului tău, cu suport multilingv și previzualizare înainte de trimitere.

Compunere campanie cu subiect și conținut multilingv (mai multe limbi simultan)

Previzualizare email randat înainte de trimitere

Creare și salvare ca draft (campanie inactivă)

Activare campanie și trimitere secvențială pentru compatibilitate cu limitele serverului

Monitorizare progres de trimitere în timp real

Vizualizare campanie cu statistici de livrare

Ștergere campanie

Campanii WhatsApp

Modulul WhatsApp transformă platforma de fidelizare într-un canal direct de comunicare cu clienții — campanii automate, segmentare inteligentă, recompense și recuperare clienți inactivi, totul dintr-o singură interfață.

📲 Trimite campanii WhatsApp automat

Creează campanii cu template-uri aprobate Meta și trimite-le automat la momentul potrivit — imediat sau programat la dată și oră.

🎯 Segmentează clienții (VIP, inactivi, activi)

Filtrează audiența după puncte acumulate, zile de inactivitate, tag-uri și comportament de cumpărare. Mesajul potrivit, la omul potrivit.

🎁 Oferă puncte, vouchere și recompense

Trimite mesaje personalizate cu oferte, coduri de reducere sau informații despre recompensele disponibile direct prin WhatsApp.

🔁 Readuce clienții fără efort

Automatizări inteligente: mesaj automat după X zile de inactivitate, la aniversare sau când clientul atinge un prag de puncte. Funcționează non-stop.

Pas 1 - Configurare cont WhatsApp Business

Accesezi Integrări → WhatsApp din meniul lateral al contului de partener (disponibil pe plan Premier).
Urmezi ghidul integrat din pagină: creezi un cont Meta Business, configurezi WhatsApp Business Platform, creezi o aplicație Meta de tip Business și adaugi produsul WhatsApp.
Din aplicația Meta (developers.facebook.com) copiezi Phone Number ID și WhatsApp Business Account ID (WABA ID) din secțiunea WhatsApp → API Setup.
Generezi un System User Access Token permanent din Meta Business Suite → Setări → Utilizatori sistem, cu permisiunile whatsapp_business_messaging și whatsapp_business_management.
Introduci credențialele în pagina de setări și apeși „Testează conexiunea" pentru a valida că token-ul și Phone Number ID sunt corecte.
Token-ul este stocat criptat pe server și folosit exclusiv pentru apelurile API server-side — nu este niciodată expus în browser.

💡 Recomandare: Folosește un System User Token (nu token personal) — nu expiră și nu este legat de contul tău personal Facebook. Îl găsești în Meta Business Suite → Setări → Utilizatori sistem.

Pas 2 - Creare și trimitere campanie

Sincronizezi template-uri aprobate prin butonul Sync from Meta.
Configurezi campania: nume, template, variabile și programare (imediat sau la dată/oră).
Aplici filtre de segmentare (minim puncte, inactivitate, tag-uri).
Folosești Preview Message înainte de lansare pentru validarea conținutului.
Sistemul generează recipientii eligibili și trimite mesajele în background prin job queue.

Pas 3 - Automatizări și trigger-e

Reguli disponibile: birthday, points_reached, inactive_customer, after_purchase, after_checkout.
Automatizările pot avea delay în minute și condiții suplimentare pe ofertă/variabile.
Trigger-ul after_purchase pornește automat după tranzacții eligibile cu puncte acordate.
Sistemul previne duplicatele pentru aceeași regulă/contact în aceeași zi.
Regulile sunt procesate periodic prin scheduler + queue worker.

Inbox & mesaje manuale

Lista conversațiilor include statusuri: sent, delivered, read, failed.
Poți trimite reply manual pe template direct din Inbox.
Contactele sunt corelate per partener pentru izolare multi-tenant.

Webhook Meta

Endpoint verificare: GET /api/whatsapp/v1/webhook (challenge verification).
Endpoint evenimente: POST /api/whatsapp/v1/webhook (delivery/read/incoming).
Evenimentele actualizează statusul mesajelor și alimentează inbox-ul în timp real.

Endpoint-uri API WhatsApp (v1)

Metodă	Endpoint	Scop
POST	/api/whatsapp/v1/account/save	Salvare/actualizare cont WhatsApp
POST	/api/whatsapp/v1/templates/sync	Sincronizare template-uri din Meta
POST	/api/whatsapp/v1/campaigns/create	Creare campanie WhatsApp
POST	/api/whatsapp/v1/campaigns/send	Lansare trimitere campanie
GET	/api/whatsapp/v1/campaigns/stats	Statistici campanii
POST	/api/whatsapp/v1/contacts/add	Adăugare contact
GET	/api/whatsapp/v1/contacts/filter	Filtrare contacte
POST	/api/whatsapp/v1/automation/create	Creare regulă automată
GET	/api/whatsapp/v1/inbox	Listare inbox
POST	/api/whatsapp/v1/inbox/reply	Răspuns manual din inbox

Bune practici

Folosește doar template-uri aprobate, validează numerele în format internațional, pornește queue worker pentru trimitere stabilă și configurează webhook-ul Meta pentru tracking complet al livrărilor și citirilor.

AI Recomandări

Funcționalitate care utilizează inteligența artificială (GitHub Copilot / OpenAI) pentru a genera recomandări personalizate de afaceri bazate pe metricile reale ale programului de fidelizare al partenerului.

Metrici afacere analizate

Total membri, membri activi 30 zile, rata de engagement, tranzacții luna curentă vs luna trecută, modificare lună/lună (MoM)

Programe analizate

Număr programe de loialitate active, vouchere, carduri cu ștampile, campanii active, reguli autopilot

5 recomandări prioritizate

AI-ul returnează exact 5 recomandări structurate cu prioritate, categorie, titlu, descriere și acțiune concretă de luat

Cache 6 ore

Recomandările sunt cache-uite 6 ore per partener pentru performanță optimă și reducerea costurilor API

Multilingv

Recomandările sunt generate în limba activă a platformei (Română, Engleză etc.)

Regenerare manuală

Partenerul poate regenera recomandările oricând direct din interfață, golind cache-ul anterior

Configurare necesară

Funcționalitatea necesită configurarea unui token GitHub Copilot sau a unei chei OpenAI în setările platformei (Setări → AI). Modelul și URL-ul de bază sunt configurabile de administrator.

Chei API & integrări externe

Partenerul poate genera chei API pentru a integra platforma cu sisteme externe (POS, website, aplicații proprii).

Generare chei API

Creare chei cu prefix sk_live_ (producție) sau sk_test_ (testare)

Scopuri și permisiuni

Fiecare cheie are scopuri definite — controlezi exact ce acțiuni permite

Restricții IP

Limitarea utilizării cheii la adrese IP specifice pentru securitate maximă

Rate limiting

Limite configurabile per minut, oră și zi pentru fiecare cheie

Webhook events

Configurare notificări webhook pentru evenimente specifice (tranzacții, recompense etc.)

Loguri de utilizare

Vizualizare log-uri detaliate: cereri, IP-uri, endpoint-uri accesate, timestamp

Integrare Shopify

Conectează-ți magazinul Shopify cu platforma de fidelizare pentru a acorda automat puncte la fiecare comandă.

Conectare prin OAuth (autorizare securizată Shopify)

Dashboard integrare cu status conexiune și snippet de instalare

Configurare setări de sincronizare (ce evenimente acordă puncte)

Mapare recompense — configurare ce recompense se acordă pentru acțiuni Shopify

Pauză/reluare sincronizare fără a pierde configurația

Deconectare completă de la magazinul Shopify

Import PynBooking

Integrare cu sistemul PMS PynBooking pentru hoteluri. Permite importul automat al oaspeților hotelului ca membri ai programului de fidelizare, direct din panoul partenerului.

Pas 1 — Configurare credențiale API

Introducerea Client ID și Client Secret din dashboardul PynBooking
Testarea automată a conexiunii la salvare (verificare token Bearer)
Credențialele sunt stocate criptat în baza de date (Laravel encrypt())
Token-ul de acces este cache-uit 55 minute (limita API: 10 tokenuri/oră)

Pas 2 — Filtrare și preluare oaspeți

Filtru stare oaspete: Toți / În hotel (inhouse) / Sosiri (arrival) / Plecări (departure)
Filtru dată în format YYYY-MM-DD (obligatoriu pentru sosiri/plecări)
Selecție număr înregistrări per pagină: 50, 100, 250, 500, 1000 (max API: 5000)
Date preluate per oaspete: Prenume, Nume, Email, Țară, Data nașterii, Consimțământ marketing

Pas 3 — Previzualizare și import selectiv

Tabel de previzualizare a oaspeților cu badge „Deja Membru" / „Nou"
Selectare individuală sau în masă a oaspeților de importat
Import creează conturi de membri cu: nume, email, parolă aleatorie, email verificat, dată naștere, cod țară
Saltul automat al oaspeților deja existenți ca membri (deduplicare pe email)
Contorizare rezultate: importați / săriți / erori
Membri importați sunt marcați cu meta imported_from = pynbooking

Auth

api-access-service.pynbooking.com

Base URL

api.pynbooking.com

Endpoint

POST /marketing/emailList/

Abonament și facturare

Platforma oferă mai multe planuri de abonament cu facturare lunară sau anuală (cu reducere). Plata se procesează securizat prin Stripe.

Limită	Startup	Premier ⭐
Cluburi	1	99.999.999
Membri	5.000	99.999.999
Personal (Staff)	5	99.999.999
Locații	1	99.999.999
Carduri de loialitate	3	99.999.999
Recompense per card	1.000	99.999.999
Carduri promovate	1	99.999.999

Plată prin Stripe

Procesare securizată a plăților cu card bancar prin Stripe Checkout

Facturare lunară sau anuală

Alegerea perioadei la înregistrare, cu reducere la facturarea anuală (echivalent 2 luni gratuite)

Upgrade/downgrade plan

Posibilitate de schimbare a planului oricând din contul partenerului

Anulare oricând

Abonamentul poate fi anulat oricând, fără penalități

Personal (Staff)

Personalul angajat al partenerului (casieri, vânzători) are acces la un panou simplificat pentru operațiunile zilnice cu membrii.

Autentificare personal

Login cu email + parolă sau OTP
Link magic de autentificare
Resetare parolă

Scanner QR

Scanare cod QR al membrului pentru identificare rapidă
Căutare membre după nume, email sau identificator

Acordare puncte

Acordare puncte unui membru pe un card specific
Selectare card dintr-o listă

Procesare recompense

Confirmare revendicare recompensă de pe card de loialitate (via link semnat)
Procesare recompensă stamp card la completare

Stamp cards

Acordare ștampile unui membru
Vizualizare status membre pe stamp card
Procesare recompensă la completare card

Vouchere

Formular de răscumpărare voucher cu validare în timp real
Procesare răscumpărare voucher pentru un membru
Vizualizare istoric voucher al unui membru