Utgående webhooks

Om utgående webhooks

Generelt sett er en webhook en måte applikasjoner kan kommunisere med hverandre på automatisk. Med andre ord, en melding sendes over webben, som utløses automatisk når en spesifikk hendelse skjer. Utgående webhook-automatisering blir utløst når en respondent fullfører undersøkelsen din og svaret deres sendes til et eksternt system du velger.

Hver gang utgående webhook-automatisering blir utløst, skaper det en ny automatiseringskjøring. Disse kjøringene representerer tilfellene hvor utgående webhook sender et undersøkelsessvar til det angitte eksterne systemet. Med Enalyzer kan du enkelt se og håndtere automatiseringskjøringer.

Webhooks er ment for brukere som vet hvordan de skal håndtere dem. Vennligst merk at vi ikke kan feilsøke koden din eller gi deg trinnvise utviklingsinstruksjoner.

Lag en Utgående Webhook-automatisering

For å sette opp en utgående webhook-automatisering, følg disse trinnene:

1. Gå til automasjonsområdet () og klikk på Enalyzer i side-menyen.
2. Klikk på Enalyzer i side-menyen.
3. Klikk på Opprett automatisering. Hvis du allerede har en eller flere automatiseringer, klikk på legg til automatisering-ikonet () for å legge til en ny.
4. Velg webhooks-alternativet og klikk på utgående webhook.
5. Velg hvilke variabler du vil inkludere i overføringen din. Du kan velge å inkludere alle variabler eller spesifikke variabler i dataoverføringen din.
   1. Denne muligheten vil inkludere alle spørsmålene i undersøkelsen og bakgrunnsvariablene i dataoverføringen.
      1. Bruk rullegardinmenyen til å velge alternativet inkluder alle variabler
      2. Klikk neste.
   2. Denne muligheten lar deg velge hvilke spørsmål og bakgrunnsvariabler du vil inkludere i dataoverføringen din.
      1. Bruk rullegardinmenyen til å velge alternativet inkluder spesifikke variabler og klikk neste.
      2. Velg spørsmålene og bakgrunnsvariablene du vil inkludere i dataoverføringen din, og klikk på legg til.
6. Velg de variable etikettene webhooken skal bruke. Du kan velge mellom:
   • Auto-genererte etiketter: disse genereres av Enalyzer og er de samme etikettene du finner i nedlastningene av responsdata.
   • Dine egne etiketter: Du kan bruke etikettene dine som du kan tilpasse under innstillingene for undersøkelsen. 
7. Legg til URL-en som webhook-automatiseringen vil sende dataene til.
8. Klikk på test tilkobling-knappen. Når tilkoblingen din er vellykket, klikk på neste.
9. Gi automatiseringen et navn og klikk på neste.
10. Angi automatiseringsstatusen. Som standard er den aktivert, men du kan deaktivere den før du oppretter den.
11. Når du er klar til å opprette automatiseringen, klikker du på ferdig.

Tilpass Dataetiketter

Når du oppretter en bakgrunnsvariabel eller spørsmål, produserer Enalyzer automatisk en etikett som du finner i nedlastingene av svardata. Dataetiketter lar deg tilpasse etiketter for dine undersøkelsesbakgrunnsvariabler og spørsmål for utgående webhooks for å kontrollere resultatet av API-kall.

Dine dataetiketter er definert under undersøkelsesinnstillingene dine, du trenger bare:

1. Gå til undersøkelsesområdet () og åpne undersøkelsen din.
2. I sidepanelet, klikk på innstillinger.
3. Under datainnstillinger, klikk på dataetiketter.
4. Du vil se en oversikt over alle undersøkelsesvariabler (bakgrunnsvariabler og spørsmål) på venstre side. På høyre side ser du dine dataetiketter. Som standard genereres dataetikettene automatisk, basert på de tilsvarende bakgrunnsvariablene og spørsmålene, men du kan definere dine egne verdier.

Dataetiketter må være unike, kan ikke inneholde spesialtegn og er begrenset til 100 tegn.

Dataetiketter kan bare defineres for bakgrunnsvariabler og spørsmål, men ikke for svaralternativer.

Dataetiketter kopieres ikke ved kopiering av spørsmål, men de kopieres ved kopiering av undersøkelser eller når undersøkelsen deles som en mal.

Vis detaljer om Automation-run

Hver gang Utgående webhook-automatisering blir utført, oppretter den en ny kjøring. Automatiseringsløpene er de tilfellene når Utgående webhook overfører et svar på en undersøkelse til det angitte eksterne systemet. Når Utgående webhook-automatisering starter å kjøre, kan du se automatiseringsløpene den oppretter. Hvert automatiseringsløp kan ha forskjellig status. De mulige statusene er:

• Planlagt: utgående webhook-automatisering er planlagt for senere, men har ennå ikke kjørt
• Mislykket: utgående webhook-automatisering har oppstått en feil og klarte ikke å kjøre
• Spillende: utgående webhook-automatisering spiller nå
• Vellykket: utgående webhook-automatisering ble fullført vellykket, og undersøkelsessvaret ble sendt til det eksterne systemet

For å vise detaljer om en automatisering, alt du trenger å gjøre er:

1. Gå til automatiseringsområdet () og klikk på Enalyzer i sidemenyen.
2. I sidepanelet, klikk på Enalyzer.
3. Klikk på automatiseringen.
4. Under loggen, klikk på automatiseringsløp.
5. For å se detaljer om automatiseringsløp, klikk enkelt og greit på løpet.
6. Automatiseringsløp-informasjonen inkluderer:
   • Fornavn og etternavn: løpet vil vise respondentens fornavn og etternavn hvis tilgjengelig.
   • Status: løpets status, samt datoen og tidspunktet som statusen ble gjeldende.
   • Opprettelsestidspunkt: datoen og klokkeslettet for når løpet ble opprettet.
   • Push-URL: URL-en som undersøkelsesresponsen ble postet til.
   • Utgående melding: data som ble sendt til det eksterne systemet.

Løp fra anonyme undersøkelser vil ikke vise deltakernes fornavn, etternavn eller e-post. I stedet vil kjøringen bli navngitt "Anonym".

Filtrer automatiseringskjøringer

Du kan filtrere automatiseringskjøringer etter status, tidsperiode eller navn. Dette vil hjelpe deg med å sortere gjennom kjøringene dine og gjøre dem enklere å administrere, for eksempel kan du finne alle mislykkede kjøringer og se hva som skjedde eller spille dem på nytt.

For å filtrere automatiseringskjøringer må du:

1. Gå til automasjonsområdet () og klikk på Enalyzer i sidepanelet.
2. I sidepanelet klikker du på Enalyzer.
3. Klikk på automatiseringen.
4. Under logg klikker du på automatiseringskjøringer.
5. Klikk på filter-knappen.
6. Du har følgende alternativer for å filtrere kjøringer, og du kan legge til så mange filtre som nødvendig for å bore deg ned i dem:
   • Søk etter navn eller e-postadresse: Skriv inn en e-postadresse eller et navn i søkefeltet. Dette refererer til verdien av undersøkelsesresponset.
   • Status: Filtrer etter kjørestatus.
   • Tidsperiode: Filtrer etter tidsperioden basert på kjøringens opprettelsesdato.
     

     Automatiseringskjøringer er bare lagret i 14 dager, derfor er tidsperiodefilteret begrenset til de siste 14 dagene.

7. Når du er ferdig med å legge til alle filtrene, klikker du på apply-knappen for å filtrere listen over automatiseringskjøring og lukke sidepanelet for å redigere filterkjøringer.

Gjenta kjøring av automatisering

Det er mange grunner til å ønske å gjenta en kjøring. Den vanligste er hvis den har feilet, men det kan også være ønskelig å sende dataene igjen eller spille en kjøring som er planlagt for senere tidspunkt. For å gjenta kjøringene, trenger du bare å gjøre følgende:

1. Gå til automatiseringsområdet () og klikk på Enalyzer i side menyen.
2. I side menyen, klikk på Enalyzer.
3. Klikk på automatiseringen.
4. Under logg, klikk på Automatiseringskjøringer.
5. Klikk på handlingsmenyen og velg gjenta.
6. Velg kjøringene du vil gjenta og klikk på gjenta-knappen.

Motta feilmeldinger

Utgående webhooks kan mislykkes av forskjellige årsaker og føre til at automatiseringen din blir deaktivert. Uansett årsak kan du aktivere e-postfeilmeldinger for automatiseringen din. Du kan definere personene som trenger å motta disse meldingene.

For å aktivere feilmeldinger må du:

1. Gå til automatiseringsområdet () og klikke på Enalyzer i side menyen.
2. Klikke på automatiseringen du vil aktivere feilmeldinger for.
3. Aktiver epostmeldinger for feilmeldinger.
4. Klikk på legg til mottaker og skriv inn e-postadressen som vil motta feilmeldingsmeldingene. Gjenta dette trinnet for å legge til flere mottakere.
5. Endringene dine vil bli lagret umiddelbart.