Webhook

En webhook används för att göra anrop till andra system. T.ex. göra ett anrop till ett affärssystem vid varje köp. Kanske skicka ett SMS när obehöriga försöker logga in. Eller skicka ett e-post när låset låses upp. Det finns ett antal olika händelser som vi hanterar och fler kommer hela tiden.

Observer att en webhook är kopplats till en plats. Så om ni har flera platser och vill ha en webhook till alla platser så behöver ni skapa en webhook per plats.

Webhook Lista

Här visas en lista med alla webhook kopplade till vald plats. Klicka på en webhook för att se och ändra dess detaljer.

Utlös när

Ange när det ska hända. Se mer detaljer kring varje typ längst ner på sidan.

Trigger typ

Ange vad som ska hända. Välj bland

API

E-post

SMS (Observera att det tillkommer en kostnad för SMS.)

Ett flertal olika affärssystem och kassor kommer att finnas i listan.

E-post och SMS

Mottagare

Beroende på trigger typ så anges e-postadress eller telefonnummer för SMS. 

Det går bra att ange flera mottagare använd då semikolon (;) som separator.

Telefonnumret måste innehålla landskod och ska då formateras t.ex. [phone]

E-post eller SMS

Ange texten som ska stå i meddelandet till mottagaren. Observera att om ingen text anges så kanske inget meddelande heller kommer att skickas.

API

Detta är inställningar som endast ska användas vid Trigger typ = API. 

URL

Ange en adress per rad.

On endast en adress används så körs det asynkront.

Om flera adresser används så körs de en i taget. Synkront. 

https://anrop.till.doman/API/test1
https://anrop.till.doman/API/test2

Body

Det som ska postas vid ett POST-anrop.

Det går bra att bygga sitt helt egna objekt förslagsvis json. 

Vi har också stöd för att lägga in objekt i angivet json-objekt. T.ex.

{    
    "myparameter": 123,    
    "receipt": {receipt},    
    "articles": {articles},
    "article": {article},    
    "cart": {cart},    
    "user": {user},
    "platsid": {store.StoreId},
}

Observera att alla fält i alla objekt inte hanteras. Testa för att dubbelkolla vilken data som hanteras.

Observera stor och liten bokstav måste vara rätt - i t.ex. "store.StoreId".

Tex om ovan används vid "Nytt köp" så kommer "article" vara tomt så den kan uteslutas. "cart" kommer att vara en lista med alla produkter från kundvagnen.

Headers

För att skicka med en eller flera header i API-anropet. 

Ta bort

Det går bra att radera en webhook som inte längre används. 

 

Utlöses när

Här kommer detaljerad förklaring när en webhook utlöses / körs.

Nytt köp

Direkt efter att ett köp genomförts och kvittot skapas så körs denna webhook. 

Blockerad användare försöker öppna dörren

En användare som ni lagt in i Spärrlistan försöker öppna ett lås. 

Lägg produkt i kundvagn / Ta bort från kundvagn

Så snart en kund lägger en produkt i kundvagnen. Kunden behöver inte betala utan det händer direkt när produkten hamnar i kundvagnen. Respektive för att ta bort.

I dessa två varianter går det att lägga till ytterligare info för att bl.a. få reda på vem som tagit bort varor. Modifiera meddelandefältet för SMS/e-post till t.ex. detta:

Kund har tagit bort en vara från kundvagnen.
{date}
{store}
{user}

Varning om öppen dörr

Det finns en artikel som förklarar detta flöde i detalj. Sök efter artikeln eller kontakta supporten.

Notera att det endast är styrbox mobil som stödjer denna funktion i dagsläget.

Öppnar lås

Direkt när en kund klickar på LÅS UPP.

Integration mot kassasystem

Squid, Extenda m.fl. är integrationer mot kassasystem. Rör ej!!