Välkommen till Micali.online

Användarroller

Varje person som interagerar med Micali.online faller under en av dessa roller. Roller styr vad någon kan se, redigera och godkänna.

Vad varje roll kan göra

Konto

Ett konto representerar ett företag eller en organisation som äger bokningsuppsättningen — salongen, studion, kliniken. Varje konto har sin egen offentliga subdomän (till exempel yourname.micali.online) där besökare landar för att göra en bokning.

Ett konto innehåller alla delar som en besökare interagerar med: medlemskapen de kan köpa, tjänsterna och procedurerna de kan boka, evenemangen de kan anmäla sig till och formulären de fyller i längs vägen.

Evenemang

Ett evenemang är en tidslucka — eller en serie tidsluckor — som besökare kan anmäla sig till. Använd evenemang för klasser, gruppmöten, workshops, föreställningar och alla andra reservationer som är knutna till en fast starttid.

Mallevenemang vs. klassiska evenemang

Evenemang finns i två varianter:

• Mallevenemang — en återanvändbar mall. Mallar visas aldrig för besökare; de finns så att du kan skapa många riktiga evenemang med samma inställningar (kapacitet, formulär, meddelanden osv.) utan att behöva mata in allt på nytt.
• Klassiskt evenemang — ett riktigt, bokningsbart evenemang. Ett klassiskt evenemang kan skapas från grunden eller länkas till en mall, och ärver i så fall mallens konfiguration.

Viktiga inställningar att känna till

• Kapacitet — hur många besökare som kan delta i en tidslucka, och om varje besökare kan ta med ”vänner” (extra enheter). Ange minimum och maximum antal deltagare.
• Anmälningsfrist — den senaste tidpunkten en besökare kan boka. Om det lämnas tomt förblir bokningar öppna tills evenemanget startar.
• Automatisk bekräftelse — om reservationer accepteras omedelbart eller väntar på administratörens godkännande.
• Tillåtna medlemskap — begränsa vem som får boka genom att begränsa evenemanget till specifika medlemskap. Om du lämnar detta tomt kan vem som helst boka.
• Väntelista — när evenemanget är fullbokat kan nya besökare placeras på en väntelista och meddelas automatiskt när en plats blir ledig.
• Meddelanden — välj vilka meddelandemallar som skickas för bokningsbekräftelse, betalningspåminnelser, avbokningar, närvaropåminnelser och väntelisteuppdateringar. Varje evenemang har sin egen plats för varje syfte, så du kan kombinera mallar per evenemang.

Tjänster och procedurer

Tjänster är för en-till-en-bokningar där besökaren väljer en tid som passar dem. Tänk på en frisörsalong, en privatlektion, en konsultation eller en behandling.

Hur tjänster och procedurer hänger ihop

• En tjänst är behållaren — erbjudandet som helhet (till exempel ”Frisörsalong centrum”). Den har ett namn, en beskrivning, en plats, en adress och en tidszon.
• En procedur är en specifik sak du kan boka inom den tjänsten (till exempel ”Klippning — 30 minuter”, ”Färgning — 90 minuter”). En tjänst kan ha många procedurer.
• Tillgänglighet är kalendern över tidsfönster när besökare kan välja att boka. Dessa anger du per tjänst.

På den offentliga sidan väljer en besökare först en tjänst, sedan en procedur, sedan en ledig tidslucka — och fyller slutligen i eventuella obligatoriska formulär.

Automatiserade meddelanden

Varje procedur kan kopplas till fyra meddelandemallar — en för det ögonblick då en bokning skapas, en för bekräftelse, en för avslag och en påminnelse före tiden. Välj mallarna per procedur så att olika tjänster kan tala med olika ton.

Medlemskap

Ett medlemskap är en förbetald plan som en besökare köper — ett klippkort, en månadsprenumeration, ett säsongskort. Använd medlemskap för att fakturera i förväg och för att styra vem som får boka vissa evenemang.

Vad ett medlemskap definierar

• Pris och valuta — vad besökaren betalar.
• Användningsgränser — maximalt antal användningar och/eller maximal varaktighet i dagar.
• Tillgänglighetsfönster — när medlemskapet kan köpas (available_from och valfritt available_to).

Hur medlemskap öppnar evenemang

I sig självt är ett medlemskap bara en produkt som besökare kan köpa. För att använda det som en spärr, länka det till ett eller flera evenemang som ett tillåtet medlemskap. Efter det kan bara besökare som har det medlemskapet boka evenemanget.

Om en besökare med ett giltigt medlemskap inte dyker upp kan evenemanget konfigureras så att en kredit ändå dras från medlemskapet.

Automatiserade medlemskapsmeddelanden

Medlemskap kan utlösa fyra meddelandemallar:

• Efter varje användning — bekräfta att en kredit förbrukades och hur många som återstår.
• Före slutdatum — en förvarning ett konfigurerbart antal dagar innan medlemskapet löper ut.
• Vid utgång — skickas när medlemskapet upphör.
• Få återstående användningar — skickas när besökarens återstående krediter sjunker under en tröskel du anger.

Meddelandemallar

En meddelandemall är en återanvändbar textdel som plattformen skickar till besökare vid rätt tillfälle — bokningsbekräftelse, betalningspåminnelse, närvaropåminnelse, utgångsvarning och så vidare. Definiera en mall en gång på kontonivå och referera till den från varje evenemang, tjänsteprocedur eller medlemskap som ska använda den.

En mall, två kanaler

Varje mall har platser för både en e-post-version (ämne + text) och en SMS-version (ämne + text). Du kan fylla i den ena eller den andra, eller båda — minst en text måste finnas när du sparar.

Det du lämnar tomt används helt enkelt inte:

• Om e-posttexten är tom skickas ingen e-post när denna mall utlöses.
• Om SMS-texten är tom skickas inget SMS när denna mall utlöses.

På ett evenemang bestämmer två brytare på kontonivå — skicka e-post och skicka SMS — vilka kanaler som skickas för det evenemangets mallar. Medlemskap erbjuder samma brytarpar för meddelandet efter användning. Andra mallplatser skickar helt enkelt de kanaler som mallen själv har fyllt i.

Platshållare du kan använda

Mallar stödjer enkla variabler som ersätts med riktiga data vid sändningstillfället. Du kan placera vilken som helst av dessa i ämne eller text, på endera kanalen:

Platshållare som inte gäller ett visst meddelande (till exempel %event_name% i en tjänstepåminnelse) lämnas helt enkelt tomma.

Var mallar används

Mallar skickas inte själva — de hämtas av enheten som utlöser meddelandet. Här är den fullständiga listan över platser.

På ett evenemang

• Bokning skapad — skickas i det ögonblick en besökare skickar in en reservation.
• Bekräftelse — skickas när reservationen bekräftas (manuellt eller automatiskt).
• Betalning saknas — betalningspåminnelse, med en eller två konfigurerbara förvarningstider (första och andra påminnelse, i timmar före evenemanget).
• Närvaropåminnelse — skickas ett konfigurerbart antal timmar före evenemanget.
• Avbokning — skickas när besökaren avbokar.
• Kontoavbokning — skickas när en administratör avbokar besökarens reservation.
• Väntelista — tillagd — skickas när besökaren placeras på väntelistan.
• Väntelista — befordrad — skickas när en plats blir ledig och besökaren får boka.

På en tjänsteprocedur

• Bokning skapad — skickas när besökaren skickar in begäran.
• Bekräftelse — skickas när tiden godkänns.
• Avslag — skickas när begäran avslås.
• Påminnelse — skickas före tiden.

På ett medlemskap

• Efter varje användning — skickas varje gång en kredit förbrukas.
• Före slutdatum — skickas ett konfigurerbart antal dagar innan medlemskapet löper ut.
• Vid utgång — skickas när medlemskapet når sitt slutdatum.
• Få återstående användningar — skickas när antalet återstående krediter sjunker under tröskeln du angett.

Offentlig vs. Aktiv — vad varje flagga betyder

Evenemang, tjänster och medlemskap delar två av/på-brytare. De ser lika ut men de svarar på två olika frågor.

Kombinationer och vad de betyder

Webhooks

Webhooks låter Micali.online meddela dina egna system i samma stund som något händer inuti ett konto — en ny besökare, en bokning, en medlemskapsbetalning. Konfigurera en eller flera lyssnar-URL:er per konto, välj de händelser du bryr dig om, och Micali.online postar en JSON-payload till varje URL när de utlöses. Perfekt för att synka bokningar in i ett CRM, utlösa nedströmsautomatiseringar eller bygga dashboards ovanpå dina reservationsdata.

Vem kan konfigurera dem

Endast rotadministratörer kan skapa, redigera och ta bort webhook-lyssnare. Administratörer och teammedlemmar kan inte se eller ändra dem. Webhooks finns tillsammans med de andra integrationerna — öppna Anslutningar → Webhooks för att hantera dem.

Händelser du kan lyssna på

Varje lyssnare är bunden till en enda händelsetyp. Lägg till flera lyssnare — även pekande mot samma URL — för att ta emot fler än en händelsetyp. Katalogen över händelser som för närvarande sänds är:

• visitor.created — en ny besökare anmälde sig i kontot.
• visitor.updated — en befintlig besökarprofil uppdaterades.
• event_booking.created — en besökare bokade en evenemangsplats.
• event_booking.confirmed — en evenemangsbokning bekräftades (manuellt eller automatiskt).
• event_booking.cancelled — en evenemangsbokning avbokades.
• service_booking.created — en besökare bokade en tjänsteplats.
• service_booking.confirmed — en tjänstebokning bekräftades.
• service_booking.cancelled — en tjänstebokning avbokades.
• membership.assigned — ett medlemskap tilldelades en besökare.
• membership.paid — ett besökarmedlemskap markerades som betalt.
• membership.ended — ett besökarmedlemskap nådde sitt slutdatum.

Vad som skickas

Varje leverans är en enda HTTP POST till din URL med en JSON-kropp. Följande huvuden följer alltid med begäran:

• Content-Type: application/json — kroppen är alltid JSON-kodad.
• User-Agent: micali-webhooks/1.0 — identifierar avsändaren.
• X-Micali-Event: <event_type> — upprepar händelsetypen så att du kan dirigera utan att parsa kroppen.
• Authorization — skickas endast när du konfigurerar autentisering på lyssnaren (se nedan).

Payloadens form

Alla payloads delar samma kuvert:

• event — händelsetypen (samma värde som X-Micali-Event-huvudet).
• occurred_at — ISO-8601-tidsstämpel för när utlösaren kördes.
• resource — typen av objekt inuti data: event_booking, service_booking eller visitor_membership.
• data — en ögonblicksbild av resursen, inklusive dess publika ID, aktuella statusflaggor och besökarens kontaktuppgifter (e-post, för- och efternamn, telefon). Evenemangs- och tjänstebokningar inkluderar också det länkade evenemanget eller tjänste-/procedurblocket; medlemskapspayloads inkluderar medlemskapets namn och publika ID.

Identifiera objekt över leveranser genom deras public_id — det är den stabila, mänskligt delbara identifieraren vi använder överallt annars i plattformen.

Autentisering

Välj ett autentiseringsschema så att din mottagare kan verifiera att begäran kom från Micali.online:

• Ingen — inget Authorization-huvud skickas. Använd endast när din slutpunkt är skyddad på annat sätt (signerad URL, IP-tillåtelselista, privat nätverk).
• Basic — användarnamn och lösenord skickas som standard Authorization: Basic ...-huvud.
• Bearer-token — token du anger skickas som Authorization: Bearer <token>. Lagras krypterad i vila och returneras aldrig av API:et när den väl är sparad.

Leverans och nya försök

Leveransen är asynkron och körs genom plattformens bakgrundsjobbskö. Om mottagaren returnerar en icke-2xx-status (eller begäran misslyckas helt) försöker jobbet igen med exponentiell backoff — börjar vid 60 sekunder, dubblas varje gång och är begränsat till en timme mellan försök. Efter tio misslyckade försök markeras leveransen som misslyckad och kastas. Lyssnare som är inaktiverade eller borttagna mellan utlösaren och själva leveransen hoppas tyst över.

Så här skapar du ett evenemang och publicerar det

För rotadministratörer och administratörer. Målet: en besökare kan landa på din offentliga sida och boka en plats.

1. Öppna sidan Evenemang.

   Logga in i appen, välj rätt konto i övre raden och öppna Evenemang från huvudmenyn.

2. (Valfritt) Skapa en mall först.

   Om du ska köra samma typ av evenemang upprepade gånger, skapa det en gång som en mall — kapacitet, formulär, meddelanden och så vidare. Nya klassiska evenemang kan sedan ärva från den.

3. Skapa ett nytt klassiskt evenemang.

   Klicka på Nytt evenemang, ge det ett namn och en beskrivning, ange kapacitet (max antal deltagare, om de får ta med vänner) och välj bokningsformuläret.

4. Lägg till ett eller flera evenemangsdatum.

   För varje förekomst, ange starttiden och vid behov anmälningsfristen. Utan minst ett kommande datum kan evenemanget inte bokas.

5. Begränsa till medlemskap (valfritt).

   Om endast medlemmar får delta, lägg till de obligatoriska medlemskapen under Tillåtna medlemskap. Lämna tomt för att låta vilken besökare som helst boka.

6. Välj meddelandena.

   Välj mallar för betalningspåminnelser, avbokningar och närvaropåminnelsen. Se till att rätt anslutning (SMTP, SendGrid eller Twilio) är konfigurerad på kontonivå.

7. Slå på Aktiv.

   Detta gör evenemanget aktivt inuti kontot. Det når fortfarande inte besökare förrän nästa steg.

8. Slå på Offentlig.

   Nu visas evenemanget på din offentliga subdomän. Öppna subdomänen i ett privat webbläsarfönster för att verifiera att allt ser rätt ut.

Så här skapar du en tjänst eller procedur och publicerar den

För rotadministratörer och administratörer. Målet: en besökare kan välja en procedur och boka en ledig tidslucka.

1. Öppna sidan Tjänster.

   Välj Tjänster från app-menyn. Listan visar allt som tillhör det aktiva kontot.

2. Skapa tjänsten.

   Klicka på Ny tjänst, ange namn, beskrivning, plats, adress och tidszon. Tidszonen är viktig — alla tillgänglighetsfönster tolkas i den.

3. Lägg till procedurer.

   För varje sak en besökare kan boka, skapa en procedur med ett namn och en varaktighet. Ange valfritt förberedelsetid före proceduren och uppstädningstid efter den så att kalendern inte dubbelbokas.

4. Ange tillgänglighet.

   Definiera de återkommande tidsfönstren när bokningar är tillåtna (till exempel mån–fre 09:00–17:00). Endast tidsluckor inom ett aktivt tillgänglighetsfönster kan bokas.

5. Välj bokningsformuläret (valfritt).

   Om du behöver information från besökaren vid bokning — telefon, allergier, anteckningar — bifoga ett formulär till tjänsten.

6. Slå på Aktiv på tjänsten och på varje procedur.

   En inaktiv tjänst döljs överallt; en inaktiv procedur stannar i databasen men visas inte i bokningsflödet.

7. Slå på Offentlig på tjänsten.

   Besökare ser nu tjänsten på din offentliga subdomän, med de tillgängliga procedurerna och de nästa lediga tidsluckorna.

Så här skapar du ett medlemskap och publicerar det

För rotadministratörer och administratörer. Målet: en besökare kan köpa ett medlemskap och använda det för att boka evenemang.

1. Öppna sidan Medlemskap.

   Välj Medlemskap från app-menyn.

2. Skapa medlemskapet.

   Klicka på Nytt medlemskap, ge det ett namn och en kort beskrivning som förklarar vad besökaren får.

3. Ange pris, valuta och gränser.

   Ange priset (i den minsta valutaenheten), valutan, maximalt antal användningar och/eller varaktigheten i dagar. Att lämna en gräns tom betyder obegränsat.

4. Definiera när det kan köpas.

   Ange tillgänglig från (när det visas på den offentliga sidan) och valfritt tillgänglig till (när det försvinner). Användbart för säsongs- eller tidsbegränsade erbjudanden.

5. (Valfritt) Länka det till evenemang.

   Om medlemskapet ska låsa upp specifika evenemang, öppna varje evenemang och lägg till medlemskapet under Tillåtna medlemskap.

6. Slå på Aktiv.

   Medlemskapet är nu en del av ditt konto. Befintliga medlemskap för återkommande besökare fortsätter att fungera även när detta är av.

7. Slå på Offentlig.

   Besökare ser medlemskapet på din offentliga subdomän och kan köpa det. Bekräfta genom att öppna subdomänen i ett privat fönster.

Så här skapar du en meddelandemall

För rotadministratörer och administratörer. Mallar lever på kontonivå — skriv dem en gång och återanvänd dem på vilket evenemang, vilken tjänst eller vilket medlemskap som helst.

1. Öppna sidan Meddelandemallar.

   Välj Meddelandemallar i app-menyn inuti det aktiva kontot.

2. (Valfritt) Skapa standardmallarna.

   Om detta är ett nytt konto, klicka på Skapa standardmallar för att skapa en startmall för varje stödd plats på kontots språk. Du kan redigera vilken som helst av dem efteråt.

3. Skapa en ny mall.

   Klicka på Ny mall och ge den ett tydligt, internt namn — till exempel ”Yogaklass — betalningspåminnelse”. Namnet visas bara för din personal.

4. Skriv e-postversionen.

   Fyll i e-postens ämne och text. Använd platshållare som %visitor_first_name% och %event_start_at% där du vill ha personliga värden. Ange valfritt ett avsändarnamn.

5. Skriv SMS-versionen (valfritt).

   Om du även planerar att skicka detta som SMS, fyll i SMS-texten. Håll den kort — SMS-leverantörer tar betalt per segment.

6. Spara mallen.

   Du behöver minst namnet plus en e-posttext eller SMS-text. Mallen visas nu i rullgardinsmenyerna på varje evenemangs-, procedur- och medlemskapsformulär.

7. Bifoga mallen där du behöver den.

   Öppna det aktuella evenemanget, den aktuella tjänsteproceduren eller det aktuella medlemskapet och välj den nya mallen på rätt plats — till exempel Närvaropåminnelse på ett evenemang. Spara och du är klar.