Om webhook
Ein webhook sender informasjon frå ein arbeidsflyt til eit anna system gjennom ein HTTP(S)-førespurnad. Oppsettet krev at du kjenner URL-en til mottakaren, dataformatet og eventuelle tilgangskrav.
Du kan til dømes sende bookinginformasjon til ein arbeidsflyt i Zapier, som deretter oppdaterer eit Google Sheets-dokument eller eit anna tilkopla system. Kva handlingar som er tilgjengelege, avheng av oppsettet og abonnementet til mottakaren.
Kva er ein webhook?
Ei hending i bookingtenesta, til dømes ei ny booking, kan utløyse ein webhook. Mottakarsystemet brukar deretter informasjonen til handlingane du har sett opp der.
Zapier eller IFTTT kan brukast som mottakar når oppsettet deira støttar webhooks. Tilgjengelege vidare handlingar avheng av tenesta og abonnementet der. Førespurnadsbyggjaren lèt deg velje HTTP-metode, URL, innhald og headere.
I IFTTT opnar du Webhooks og vel Receive a web request. Oppgi eit hendingsnamn, kopier adressa og lim ho inn i URL på handlinga Send HTTP(S)-førespurnad. Bruk metoden POST. Adressa har forma https://maker.ifttt.com/trigger/{event}/with/key/{key}. Bytt event og key med verdiane frå kontoen. Oppsettet ligg hos IFTTT Webhooks.
Støtta HTTP-metodar
Vel førespurnadsmetoden mottakaren krev. Desse metodane er støtta:
- GET
- POST
- PUT
- DELETE
Arbeidsflyten og handlinga er deaktiverte; ingen førespurnad blir send.
URL: Lim inn nettadressa til mottakaren. Du kan òg setje inn støtta kortkodar frå etikettikonet ved feltet. Kontroller alltid krava mottakaren stiller til adressa.
Ingen data blir sende.
Skjemadata er tilgjengeleg for POST og PUT når du vel dette under Innhaldstype. Legg inn feltnamnet mottakaren ventar, og verdien eller kortkoden som skal sendast.
Verdien {customer_first_name} blir vald frå etikettikonet.
Under Headerar kan du leggje inn HTTP-headerar som mottakaren krev. Bruk felta for namn og verdi; støtta kortkodar kan setjast inn i verdien.
Bruk handlinga for HTTP(S)-førespurnader i ein arbeidsflyt for den aktuelle hendinga.
Tilgjengelege arbeidsflythendingar
Når ein ny avtale blir lagd til.
Når avtalen er flytta.
Når avtalestatus blir endra. Du kan kombinere den tidlegare og den noverande statusen for avtalen.
Ingen bookingstatus blir endra.
Når avtalen sluttar, eller eit valt tal på minutt før eller etter at han sluttar.
Når ein ny kunde blir oppretta.
Ein arbeidsflyt kan til dømes bli utløyst éin time etter at avtalen er avslutta. Still inn tidspunktet i Hendingsoppsett; URL og førespurnadsinnhald blir sette i Handlingsoppsett.
Døma bruker ei syntetisk adresse, så ingen førespurnad blir send.
Set opp webhook med Zapier
Opprett ein Zapier-konto hos Zapier.com viss du ikkje har ein frå før.
Opprett ein ny Zap i Zapier.
I denne Zapen vel du Webhooks by Zapier. Set denne til Catch Hook.
Gå til Arbeidsflytar i kontrollpanelet. Opprett ein ny arbeidsflyt, til dømes for Ny booking. Vel Send HTTP(S)-førespurnad for denne arbeidsflyten.
Dømet bruker den syntetiske adressa https://example.invalid/webhook. Ingen ekte arbeidsflyt eller førespurnad blir oppretta.
Opne kortet til handlinga. Ei tom handling viser Oppsett, medan ei konfigurert handling viser Endre. Begge opnar Handlingsoppsett.
- Vel POST som førespurnadsmetode, og lim inn mottakaradressa frå Zapier i URL.
- Vel Skjemadata under Innhaldstype.
- Legg inn feltnamna mottakaren ventar. Skriv til dømes first_name i venstre felt, og vel {customer_first_name} frå etikettikonet ved høgre felt.
Klikk Lagre i Handlingsoppsett for å lagre handlinga. Når oppsettet er kontrollert og skal brukast i drift, må både handlinga og arbeidsflyten vere aktiverte. Aktiveringsscenene nedanfor viser dei to brytarane kvar for seg.
Slå på Aktivert i Handlingsoppsett for Webhook-handlinga, og vel Lagre. Sjølve arbeidsflyten er framleis avslått.
Set opp webhook
Klargjer og aktiver først Webhook-handlinga med Lagre i Handlingsoppsett. Slå deretter på Aktivert øvst i arbeidsflyten; endringa blir lagra automatisk.
Namnet på arbeidsflyten blir lagra når du forlèt namnefeltet, og aktiveringsvalet blir lagra når du endrar det. Du skal ikkje leite etter ein ekstra Lagre-knapp på hovudflata til arbeidsflyten. Lagre i Handlingsoppsett gjeld sjølve handlinga.
Kople deretter Zapen til programma du vil bruke.
JSON-døme
Du kan òg sende innhaldet som JSON. Vel JSON under Innhaldstype. Dømet nedanfor viser formatet:
{
"Kunde": {
"Fullt navn": "{customer_full_name}",
"Epost": "{customer_email}",
"Telefon": "{customer_phone}"
},
"Booking": {
"Dato": "{appointment_date}",
"Tid": "{appointment_start_time}"
}
}
Vel POST og JSON under Innhaldstype. Feltnamna må tilpassast krava til mottakaren; ingen JSON blir send her.
Illustrasjon: webhook-oppsett i Bookingtjeneste
I skjemadata kan du velje eigne feltnamn i venstre kolonne og setje tilhøyrande kortkodar i høgre kolonne. Klikk på etikettikonet ved feltet for å finne tilgjengelege kortkodar.
Illustrasjon: webhook-innstillingar i Zapier
Viktig: Krav ved bruk av webhooks
- Du må ha eit abonnement hos ein leverandør som støttar webhooks. Vi tilrår Zapier.com.
- Dersom du legg inn ein booking frå kontrollpanelet (altså ikkje via bookingsida di), må alle obligatoriske felt vere fylte ut for at webhooken skal bli send.
Treng du hjelp med å setje opp ein webhook?
Kontakt oss dersom du står fast. Vi kan svare på spørsmål om oppsettet, men set ikkje opp heile prosessen for deg. Send e-post til post@bookingtjeneste.no.
Test webhooken din
Vil du teste webhooken på ein enkel måte?
Set opp ein webhook med URL-en frå testverktøyet nedanfor. Bruk berre eksempeldata, og kontroller førespurnaden som blir motteken på testsida.
Testverktøy: webhook.cool
Test webhook
LAGRE OG TEST opnar val av testmål. Ein test i det ekte dashboardet kan sende ein faktisk førespurnad, så bruk testdata og eit mottak du kontrollerer.
Historiske systemeksempel
Lista nedanfor er bevart frå den tidlegare rettleiinga. Ho er ikkje ei oversikt over tilgjengelege eller støtta integrasjonar i dag; enkelte tenester er endra eller avvikla. Kontroller alltid den gjeldande webhook-støtta til mottakaren før du set opp ei kopling. Historiske namn:
- Slack
- GitHub
- Google Sheets
- Google Drive
- Trello
- Asana
- Microsoft Teams
- Dropbox
- WordPress
- Mailchimp
- Zendesk
- Salesforce
Vis resten av listaSkjul resten av lista
- Airtable
- Basecamp
- Stripe
- PayPal
- JIRA
- Discord
- Google Calendar
- Facebook Pages
- HubSpot
- LinkedIn Lead Gen Forms
- Zoho CRM
- Freshdesk
- Gmail
- Google Forms
- Redmine
- Pipedrive
- Mailgun
- SendGrid
- AWS Lambda
- Box
- Twilio
- Bitbucket
- Google Tasks
- WooCommerce
- SurveyMonkey
- Google Analytics
- Microsoft Office 365
- Evernote
- ClickUp
- Monday.com
- Typeform
- OneDrive
- ActiveCampaign
- Wix
- Intercom
- FreshBooks
- Podio
- Smartsheet
- Constant Contact
- MailerLite
- Microsoft Outlook
- Drip
- Infusionsoft
- ConvertKit
- Microsoft Dynamics 365
- Todoist
- Docusign
- Adobe Creative Cloud
- Real Estate Webmasters
- Magento
- Etsy
- Flickr
- Wunderlist
- Confluence
- Google Classroom
- Oracle
- SAP
- RSS
- Microsoft OneNote
- SugarCRM
- BigCommerce
- GitLab
- Buffer
- Zoho Mail
- Facebook Messenger
- MySQL
- PostgreSQL
- QuickBase
- Microsoft Azure
- Webflow
- Square
- Braintree
- Volusion
- Chargebee
- Recurly
- Bing Ads
- AppFolio
- Quickbooks Online
- Cisco Webex (webinar og nettmøte)
- Shopify (netthandel)
Tilbyr Bookingtjeneste eit API?
Vi tilbyr ikkje eit eige API. Systemet kan sende webhooks til til dømes Zapier ved valde hendingar i bookingtenesta. Webhook-funksjonen er inkludert i abonnementet, utan ekstra kostnad.