Webbkrokar: Koppla ihop SuperSaaS med andra webbplatser
Webbkrokar (på engelska webhooks) är användardefinierade anrop som meddelar andra applikationer eller webbplatser om händelser i ditt SuperSaaS-konto i så gott som realtid.
Några exempel på hur du kan använda en webbkrok:
- När en ny användare registrerar sig i ditt SuperSaaS-konto, lägg till hen i en utskickslista i MailChimp
- När en ny användare registrerar sig, skicka en PDF med dina villkor till hens e-postadress
- När en ny bokning görs, skapa en faktura i QuickBooks eller Freshbooks
- När en ny bokning görs för en viss klass, uppdatera Google Kalender för läraren som håller i klassen
- När en bokning snart börjar, skicka en notis till Slack eller en pushnotis till din telefon
- När en användare flyttas från en väntelista till en bekräftad plats, skicka ett sms till hen
- När ett e-postmeddelande skickas, led om det för att skicka e-post via en annan e-postserver
Konfigurera webbkrokar automatiskt med Zapier.com eller Make
Med Zapier.com eller Make kan du interaktivt skapa kopplingar mellan hundratals välkända webbplatser och SuperSaaS, utan att behöva programmera. Både Zapier och Make erbjuder en testversion och en kostnadsfri nivå för mindre användare.
Det bör vara relativt enkelt att skapa webbkrokar utifrån de färdiga exemplen, men nedan hittar du detaljerad information om du vill ha mer kontroll genom att bara filtrera fram vissa händelser.
→ Ny användare till utskickslista i MailChimp → Ny bokning till Google Kalender → Ny bokning skapar en faktura i QuickBooks → Ny bokning till e-postfilterTriggers som stöds
Det finns flera händelser som du kan bevaka. Vissa händelser kan bevakas antingen som en ”ny” händelse eller som en ”ändrad” händelse. Händelsen ”ändrad” omfattar alla ändringar, så den utlöses även vid ”ny” och ”radera”. Om du konfigurerar både ”Ny användare” och ”Ändrad användare” utlöses alltså båda webbkrokarna när en ny användare registrerar sig. Observera att om ditt schema inte kräver registrering kommer du aldrig att se triggern ”Ny användare”, bara triggern ”Ny bokning”.
| Trigger | Utlöses av… |
|---|---|
| Ny användare | Utlöses när en användare registrerar sig i ditt konto |
| Ändrad användare | Utlöses när användaren uppdaterar sina registreringsuppgifter, eller när administratören gör det åt hen. |
| Ny bokning | Utlöses när en användare, eller administratören, gör en bokning i det angivna schemat. |
| Ändrad bokning | Utlöses vid alla tänkbara ändringar av en bokning, bland annat ”Ny”, ”Radera”, ”Placering från väntelista”, ”Betalning mottagen” och så vidare. (Se hela listan nedan) |
| Nytt fristående formulär | Utlöses när ett fristående formulär fylls i. Observera att den inte utlöses när ett formulär är kopplat till en bokning, eftersom det i stället utlöser webbkroken för bokningen. |
| Ändrat fristående formulär | Utlöses vid alla ändringar av ett fristående formulär (integrerade formulär utlöser i stället ”Ändrad bokning” eller ”Ändrad användare”) |
| Skicka e-post | Utlöses för all e-post som skickas från ditt konto, till exempel meddelanden om bortglömt lösenord. Användbart om du vill skicka e-post via din egen server. Vi skickar inte längre e-posten när den här webbkroken är aktiv. |
| Påminnelse Uppföljning | Utlöses vid påminnelser eller uppföljningar. Vi skickar inte längre påminnelsen eller uppföljningen när dess webbkrok är aktiv. |
| Kreditköp | Utlöses när en användare köper något i din butik. Utlöses även om du registrerar ett köp manuellt. |
Filtrera händelser
När du kopplar ihop två tjänster med Zapier eller Make kan du filtrera händelserna. Några exempel på hur du kan använda filter:
- Skicka en sms-notis bara när någon flyttas från en väntelista, inte vid varje ändring av en bokning
- Meddela en lärare om en ny bokning bara om det är läraren som håller i klassen, och ignorera andra bokningar i samma schema
- Skicka en notis till ledningen bara om bokningen har ett värde på mer än 1 000 kr
När du skapar en ny webbkrok begär Zapier eller Make ett exempelobjekt från SuperSaaS.
Exempelobjektet visar vilka fält som finns och innehåller lite exempeldata.
Vilka fält webbkroken skickar beror på vilka fält som är aktiverade i ditt konto och om ett eget formulär är kopplat.
De flesta triggers innehåller fälten event och role, som du kan använda för att filtrera händelserna.
Du kan till exempel filtrera fram bara de triggers som har värdet delete i fältet event.
| Trigger | Möjliga värden i fältet event |
|---|---|
| Ny användare | new |
| Ändrad användare | new, change, delete |
| Ny bokning | create |
| Ändrad bokning | create, edit, place, pending, destroy, restore, approve, revert |
| Nytt formulär | new |
| Ändrat formulär | new, change, delete, restore |
| Påminnelse / Uppföljning | reminder, follow_up |
| Kreditköp | purchase |
Fältet role | Vem som utlöste händelsen… | |
|---|---|---|
| 0 | Anonym | Inte inloggad |
| 1 | Inloggad med ett gemensamt lösenord | |
| 2 | Verifierad genom kontroll av IP-adress | |
| 3 | Vanlig användare | |
| 4 | Superanvändare | |
| 5 | Administratör eller återförsäljare | |
| 7 | Systemet eller betalningstjänsten | |
När du skapar eller ändrar en bokning som omfattar betalning kan du använda fälten ”status” och ”status message” för att avgränsa till vissa händelser, utifrån listan över alla möjliga statuskoder. Du kan till exempel ställa in ett filter som bara reagerar på meddelanden om bokningar som har återbetalats.
Webbkrokar med egen installation av n8n
Ett annat alternativ är att använda webbkrokar med en egen installation av n8n. Det kräver goda tekniska kunskaper och rekommenderas bara för vana n8n-användare som har viss förståelse för sådant som att konfigurera och säkra servrar, konfigurera containrar och hantera applikationsresurser. Mer information om att använda en egen installation av n8n finns i dokumentationen om webbkrokar för utvecklare.
Konfigurera webbkrokar manuellt (avancerat)
Att skapa en webbkrok utan Zapier eller Make kräver vissa kunskaper i webbutveckling. Du kan ställa in webbkrokar så att de skickas direkt till din egen server, eller ändra den data de innehåller. Detaljerna finns i dokumentationen om webbkrokar för utvecklare.