Fleetio integracija

Šiame straipsnyje:

• Ką daro integracija?
• Kaip nustatyti integraciją
  • Gaukite 3 identifikatorius iš savo Fleetio paskyros nustatymų:
    • API raktas
    • Paskyros raktas
    • Webhook slaptasis raktas
  • Susiekite „Fleetio“ paskyrą su savo „Keycafe“ paskyra
    • Pridėkite pasirinktinius laukus
• Naudojimasis integracija
  • Susiekite Keycafe raktą su Fleetio transporto priemone
  • Pranešimų metodai
    • Automatinis
    • Pranešimas
  • Sukurkite transporto priemonės priskyrimą naudodami automatinį nustatymą
  • Sukurkite transporto priemonės priskyrimą naudodami pranešimo nustatymą
  • Sekti rakto naudojimą
• Atjungimas nuo „Fleetio“ paskyros
• Tolesnė pagalba

Ką daro integracija?

Integravę savo „Fleetio“ paskyrą su „Keycafe“, galite greitai susieti visą savo „Fleetio“ transporto priemonių inventorių su kiekvienos transporto priemonės raktu „Keycafe“ sistemoje. Kai transporto priemonė priskiriama vairuotojui „Fleetio“ sistemoje, automatiškai sukuriamas unikalus užsakymo PIN kodas raktui „Keycafe“ sistemoje ir vairuotojui išsiunčiamos prieigos instrukcijos. Vairuotojas naudos PIN kodą, kad atsiimtų transporto priemonės raktą iš SmartBox. „Fleetio“ transporto priemonių raktų užsakymai bus rodomi „Keycafe“ sistemoje su „Fleetio“ indikatoriumi, o „Keycafe“ rakto prieigos instrukcijos ir kodas bus matomi transporto priemonės priskyrime „Fleetio“ sistemoje.

Po pradinio nustatymo ši integracija leidžia valdyti ir automatizuoti transporto priemonių priskyrimus naudojant tik „Fleetio“.

Ši integracija taip pat suderinama su „Fleetio“ „Motor Pool“ funkcija. Patvirtinus transporto priemonių rezervavimo užklausas, sukuriama transporto priemonės priskyrimas, kuris inicijuoja „Keycafe“ užsakymo sukūrimą.

Kaip nustatyti integraciją

Norint nustatyti „Fleetio“ ir „Keycafe“ integraciją, reikia gauti 3 raktus iš savo „Fleetio“ paskyros, tada susieti savo paskyras ir išbandyti integraciją.

„Fleetio“ API rakto, paskyros rakto ir Webhook slaptojo rakto gavimas

Rekomenduojame juos nukopijuoti ir įklijuoti į laikiną dokumentą, ruošiantis kitam žingsniui.

Sukurkite naują API raktą „Fleetio“ sistemoje

API raktas leidžia trečiosios šalies sistemai prisijungti ir leisti duomenų perdavimą. Jums reikės sugeneruoti API raktą „Fleetio“ sistemoje, kuris taps „Keycafe“ integracijos konfigūracijos dalimi. 

1. Prisijunkite prie savo „Fleetio“ paskyros, viršutiniame kairiajame kampe spustelėkite paskyros išskleidžiamąjį meniu, tada pasirinkite Nustatymai.

1. Spustelėkite Tvarkyti API raktus.

1. Pasirinkite + Pridėti API raktą.

1. Įveskite „Keycafe“ į laukelį Žymė, iš išskleidžiamojo sąrašo pasirinkite 2023-03-01 kaip API versiją, tada spustelėkite Išsaugoti. Lentelėje turėtumėte matyti naują API raktą.

Gaukite savo „Fleetio“ paskyros raktą

Paskyros raktas yra pagrindinis trečiosios šalies sistemos identifikatorius API integracijoje ir derinamas su API raktu, kad būtų užtikrintas visiškas identifikavimas. „Fleetio“ paskyros raktas randamas API raktų puslapyje, jūsų „Fleetio“ paskyros nustatymuose.

Skyriuje „Paskyros raktai“ nukopijuokite visą paskyros raktą ir įklijuokite jį į tą patį laikiną dokumentą, kuriame įdėjote API raktą. Šį paskyros raktą reikės pridėti „Keycafe“ integracijos konfigūracijoje.

Sukurkite „Fleetio Webhook“

Webhook suteikia galimybę siųsti HTTP POST į vieną ar daugiau URL kiekvieną kartą, kai jūsų „Fleetio“ paskyroje įvyksta tam tikro tipo įvykiai. Visi „Fleetio“ webhook įvykiai turi duomenis, serializuotus kaip JSON.

1. Savo Nustatymų meniu, slinkite žemyn iki skyriaus Integracijos ir pasirinkite Webhooks.

1. Viršutiniame dešiniajame puslapio kampe spustelėkite + Pridėti Webhook.

1. Laukelyje URL nukopijuokite ir įklijuokite šį URL: https://www.keycafe.com/webhooks/fleetio
2. Palikite HTTP autorizacijos antraštę tuščią. Įveskite „Keycafe“ į laukelį Aprašas ir palikite pažymėtą Įjungta.

1. Spustelėkite Pasirinkti įvykius, tada slinkite žemyn ir pasirinkite visus tris langelius po kategorija Transporto priemonės priskyrimas ir spustelėkite Išsaugoti:

• Transporto priemonės priskyrimas sukurtas
• Transporto priemonės priskyrimas ištrintas
• Transporto priemonės priskyrimas atnaujintas

1. Webhook puslapyje spustelėkite mygtuką Daugiau veiksmų prie naujo Webhook, tada spustelėkite Peržiūrėti slaptąjį raktą.

1. Nukopijuokite visą slaptąjį raktą ir įklijuokite jį į laikiną dokumentą, kuriame taip pat yra API raktas ir paskyros raktas.

Dabar jūsų laikiname dokumente turėtų būti trys elementai: API raktas, paskyros raktas ir slaptasis raktas.

Susiekite „Fleetio“ paskyrą su savo „Keycafe“ paskyra

Integracijos konfigūravimas „Keycafe“ sistemoje daugiausia apima trijų identifikatorių, gautų aukščiau aprašytoje užduotyje, pridėjimą.

1. „Keycafe“ darbalaukio valdymo pulte spustelėkite + Pridėti → Integracija → Fleetio. Mobiliuosiuose įrenginiuose bakstelėkite Daugiau → Integracijos → Pridėti → Fleetio.
2. Įveskite API raktą, paskyros raktą ir slaptąjį raktą iš savo laikinojo dokumento.

1. Pasirinkite Prisijungti su Fleetio. Po kelių akimirkų „Keycafe“ spustelėkite skirtuką Integracijos, kad pamatytumėte integraciją.

Pridėti pasirinktinius laukus

Toliau turite pridėti tris pasirinktinius laukus savo „Fleetio“ paskyroje. Šie laukai leis jums peržiūrėti su „Keycafe“ užsakymais susijusią informaciją „Fleetio“ valdymo pulte.

1. Grįžę į „Fleetio“ Nustatymų meniu, slinkite žemyn iki skyriaus Duomenų valdymas ir pasirinkite Laukų valdymas.

1. Pasirinkite Transporto priemonės priskyrimas, tada spustelėkite + Pridėti lauką.
2. Palikite Duomenų tipą kaip Tekstas, tada įveskite „Keycafe“ prieigos instrukcijos į laukelį Žymė.
3. Spustelėkite Išsaugoti, kad sukurtumėte pasirinktinį lauką.

1. Pakartokite aukščiau nurodytus veiksmus, kad sukurtumėte dar penkis pasirinktinius laukus, iš viso šešis pasirinktinius laukus:

Norėdami peržiūrėti pasirinktinius laukus, grįžkite į Laukų valdymą, pasirinkite Transporto priemonės priskyrimas, ir ieškokite „Keycafe“.

Naudojimasis integracija

Norėdami pradėti naudotis integracija, turite susieti „Keycafe“ pridėtus raktus su „Fleetio“ pridėtomis transporto priemonėmis. Kai transporto priemonė bus susieta su raktu, galėsite pradėti kurti transporto priemonių priskyrimus „Fleetio“ sistemoje, o raktų prieigos instrukcijos bus automatiškai išsiųstos vairuotojui.

Susiekite Keycafe raktą su Fleetio transporto priemone

1. Dabar „Keycafe“ skirtuke Integracijos turėtų būti rodomas integracijos elementas. Spustelėkite šį elementą, kad būtų parodyti meniu Transporto priemonės ir Apie.

1. Norėdami peržiūrėti savo „Fleetio“ transporto priemonių sąrašą, spustelėkite Transporto priemonės, kad naršytumėte sąrašą dešinėje pusėje.
2. Pasirinkite transporto priemonę ir spustelėkite rakto piktogramą.

1. Įveskite savo „Keycafe“ rakto pavadinimą tai transporto priemonei ir pasirinkite jį iš išskleidžiamojo sąrašo.

1. Pasirinkite Susieti, kad patvirtintumėte, jog norite susieti šį raktą su šia transporto priemone.
2. Galite įjungti Automatiškai baigti priskyrimą, jei norite, kad „Fleetio“ transporto priemonės priskyrimas baigtųsi, kai raktai bus grąžinti į SmartBox (o tai vėliau nutrauks „Keycafe“ užsakymą ir vairuotojo prieigą prie raktų).
3. Galite pasirinkti Automatinis arba Pranešimas, kas pakeis, kaip vartotojas bus informuojamas, kai jam bus priskirta transporto priemonė. Dauguma vartotojų turėtų pasirinkti Automatinis paprasčiausiam darbo procesui. Spustelėkite Atnaujinti, kad uždarytumėte iššokantįjį langą.

Pranešimų metodai

Automatinis

Kai „Fleetio“ sistemoje sukuriamas transporto priemonės priskyrimas, vairuotojui automatiškai išsiunčiamas el. laiškas arba SMS žinutė su instrukcijomis, kaip pasiekti raktus. Tai leidžia visą procesą atlikti naudojant tik „Fleetio“ valdymo pultą. Kontakto metodas pagrįstas vairuotojo „Fleetio“ vartotojo profilio kontaktine informacija. Jei vairuotojo paskyroje yra ir el. pašto adresas, ir telefono numeris, pirmenybė teikiama el. paštui. 

Pranešimas

Kai „Fleetio“ sistemoje sukuriamas transporto priemonės priskyrimas, „Keycafe“ paskyros administratoriui išsiunčiamas el. laiškas su priminimu sukurti rakto prieigą. Tai leidžia individualizuoti rakto prieigos detales ir instrukcijas, tačiau procesui užbaigti reikia naudoti ir „Fleetio“, ir „Keycafe“.

Sukurkite transporto priemonės priskyrimą naudodami automatinį nustatymą

1. Kurdami transporto priemonės priskyrimą „Fleetio“ sistemoje, pamatysite šešis jūsų sukurtus pasirinktinius laukus. Palikite juos tuščius – jie bus automatiškai užpildyti po priskyrimo sukūrimo ir raktų naudojimo.

1. Sukūrus priskyrimą, peržiūrėkite detales, kad pamatytumėte užpildytas vertes laukuose „Keycafe“ prieigos kodas, prieigos nuoroda, prieigos instrukcijos ir užsakymo nuoroda. Kartais tai gali užtrukti kelias minutes.

1. Priskyrimas taip pat atsiras „Keycafe“ skirtuke Užsakymai.

Sukurkite transporto priemonės priskyrimą naudodami pranešimo nustatymą

1. Kurdami transporto priemonės priskyrimą „Fleetio“ sistemoje, pamatysite šešis jūsų sukurtus pasirinktinius laukus. Palikite juos tuščius – jie bus automatiškai užpildyti po priskyrimo sukūrimo ir raktų naudojimo.

1. Kai transporto priemonės priskyrimas sukurtas „Fleetio“ sistemoje, raskite tą transporto priemonę „Fleetio“ integracijoje „Keycafe“ ir pasirinkite kalendoriaus piktogramą.

1. Matysite transporto priemonės priskyrimo datas kaip rezervaciją. Pasirinkite + piktogramą.

1. Patvirtinkite priskyrimo detales ir pasirinkite Sukurti užsakymą.

1. Pritaikykite užsakymo detales pagal savo norus ir patvirtinkite pasirinkdami Pridėti.

1. Eikite į skirtuką Užsakymai „Keycafe“ sistemoje, kad patvirtintumėte. Priskirtas vairuotojas gaus el. laišką arba SMS žinutę (priklausomai nuo ką tik pasirinkto kontakto metodo) su instrukcijomis, kaip pasiekti raktą.

1. Grįžę į „Fleetio“ transporto priemonių priskyrimų valdymo pultą, peržiūrėkite priskyrimo detales, kad pamatytumėte užpildytas vertes laukuose „Keycafe“ prieigos kodas, prieigos nuoroda, prieigos instrukcijos ir užsakymo nuoroda. Kartais tai gali užtrukti kelias minutes.

Sekti rakto naudojimą

Kai vairuotojas atsiima transporto priemonės priskyrimo raktą, laukelis „Keycafe“ atsiėmimo laikas bus atnaujintas su laiko žyma, kada raktas buvo paimtas. Taip pat laukelis „Keycafe“ grąžinimo laikas bus atnaujintas su laiko žyma, kada raktas buvo grąžintas.

Atjungimas nuo „Fleetio“ paskyros

1. Savo „Keycafe“ valdymo pulte pasirinkite Integracijos → Fleetio → Apie integraciją → Atjungti.
2. Spustelėkite Atjungti, kad patvirtintumėte.

Tolesnė pagalba

Turite klausimų dėl integracijos ar pasiūlymų tobulinimui? Rašykite mums el. paštu support@keycafe.com.