Fidelizando API ja veebihaagid: ühenda kaart

Alustamine

Sinu API võti on juhtpaneelil jaotises Liidestused. Saada see iga päringuga päises:

Authorization: Bearer fdz_tu_clave

Kõik aadressid algavad https://fidelizando.io/api/v1, võtavad vastu JSON-i ja vastavad JSON-iga, milles on "ok": true või "ok": false ja "error" hispaania keeles. Kliendi leiad tema email, tema telefono või kaardi codigo järgi.

Aadressid

GET/yo

Kontrollib, kas võti töötab, ja tagastab ettevõtte ning programmi tüübi. Seda kasutab Zapier ühenduse kontrollimiseks.

Vastus

{
  "ok": true,
  "negocio": { "nombre": "Café Martina", "slug": "cafe-martina" },
  "programa": { "tipo": "sellos", "nombre": "Templikaart" }
}

POST/clientes

Registreerib kliendi ja loob talle kaardi (tervituskingitusega, kui see on sisse lülitatud). Kui klient oli juba olemas, tagastab tema kaardi. consentimiento on kohustuslik: kinnitab, et klient on nõustunud sinu privaatsuspoliitikaga.

{
  "nombre": "Liis Tamm",
  "email": "lucia@ejemplo.com",
  "consentimiento": true,
  "marketing": false
}

Vastus

{
  "ok": true,
  "tarjeta": {
    "codigo": "F5TGSLQRZE",
    "nombre": "Liis Tamm",
    "email": "lucia@ejemplo.com",
    "programa": "sellos",
    "saldo": 6,
    "estado": "Jäänud on 3 kuni: café gratis",
    "visitas": 6,
    "app": "https://fidelizando.io/c/cafe-martina"
  }
}

POST/sumar

Lisab kaardile. Templite puhul cantidad templit (1, kui seda ei saada). Punktide puhul nii palju, kui vastab summale importe sinu programmi järgi. Järgib sinu piiranguid, näiteks templite maksimumi päevas.

{
  "email": "lucia@ejemplo.com",
  "importe": 12.50,
  "concepto": "Ticket 1043"
}

Vastus

{
  "ok": true,
  "sumado": 1,
  "premio_listo": false,
  "tarjeta": { … }
}

GET/tarjetas?email=lucia@ejemplo.com

Näitab kaardi saldot ja olekut.

Vastus

{
  "ok": true,
  "tarjeta": {
    "codigo": "F5TGSLQRZE",
    "nombre": "Liis Tamm",
    "email": "lucia@ejemplo.com",
    "programa": "sellos",
    "saldo": 6,
    "estado": "Jäänud on 3 kuni: café gratis",
    "visitas": 6,
    "app": "https://fidelizando.io/c/cafe-martina"
  }
}

POST/canjear

Lunastab auhinna, kui saldot on piisavalt. Punktide puhul premio on auhinna koht sinu kataloogis (0 on esimene).

{
  "codigo": "F5TGSLQRZE"
}

Vastus

{
  "ok": true,
  "premio": "Tasuta kohv",
  "tarjeta": { … }
}

E-poed

Shopify ja WooCommerce ei luba päiseid lisada, seega on võti aadressis. Iga makstud tellimus lisatakse ostja kaardile (e-posti järgi) üks kord, isegi kui pood teavitust kordab. Täpsed aadressid sinu võtmega on juhtpaneelil.

https://fidelizando.io/api/v1/tiendas/shopify?clave=fdz_tu_clave
https://fidelizando.io/api/v1/tiendas/woocommerce?clave=fdz_tu_clave

Teavitused (veebihaagid)

Sisesta juhtpaneelil aadress https:// ja saadame sulle iga kord, kui midagi juhtub, POST-päringu JSON-iga. Kui sinu server ei vasta koodiga 2xx, proovime kuni 5 korda.

Sündmus	Millal
`cliente.alta`	Klient saab kaardi (sinu rakenduses, leti juures või API kaudu).
`tarjeta.suma`	Lisatakse templeid või punkte, ka kingitusi (tervitus, sünnipäev, sõbrad, kraabi ja võida).
`tarjeta.canje`	Auhind lunastatakse.

{
  "evento": "tarjeta.suma",
  "fecha": "2026-10-23T12:36:08+02:00",
  "codigo": "F5TGSLQRZE",
  "tipo": "suma",
  "cantidad": 1,
  "saldo": 7,
  "concepto": "Ticket 1043"
}

Zapier, Make ja n8n

Teavituste saamine: „Webhooks by Zapier → Catch Hook“ (Make’is „Custom webhook“). Kopeeri selle aadress juhtpaneelile.
Lisamine või registreerimine: „Webhooks by Zapier → POST“ aadressile https://fidelizando.io/api/v1/sumar või /clientes, päisega Authorization: Bearer ja sinu võtmega.
Nii ühendad Square’i, Holdedi, Odoo, Revo, oma CRM-i või Google’i arvutustabeli: iga müük lisandub kliendi kaardile.

Vajad veel midagi? Kirjuta meile hola@fidelizando.io.