Utgående Webhooks

Om utgående webhooks

Generelt er en webhook en måte applikasjoner kommuniserer med hverandre automatisk på. Med andre ord sendes en melding over nettet, som utløses automatisk når en spesifikk hendelse inntreffer. Utløsningen av utgående webhook automatisering skjer når en respondent fullfører undersøkelsen din og deres respons sendes til et eksternt system du har valgt.

Hver gang den utgående webhook-automatiseringen blir utløst, opprettes det et nytt automatiseringskjør. Disse kjøringene representerer instanser når din utgående webhook sender en undersøkelsesrespons til det spesifiserte eksterne systemet. Med Enalyzer kan du enkelt se og håndtere dine automatiseringskjør.

Webhooks er beregnet for brukere som vet hvordan de skal behandle dem. Vær oppmerksom på at vi ikke kan feilsøke koden din eller gi trinn-for-trinn utviklingsinstruksjoner.

Opprett en utgående webhook-automatisering

For å sette opp en utgående webhook-automatisering, må du:

1. Gå til automatiseringsområdet () og klikk på Enalyzer i sidemenyen.
2. I sidemenyen, klikk på Enalyzer.
3. Klikk på opprett automatisering. Hvis du allerede har en eller flere automatiseringer klikker du på ikonet for å legge til automatisering () for å legge til en automatisering.
4. Velg webhooks-alternativet og klikk på utgående webhook.
5. Velg hvilke variabler du ønsker å inkludere i overføringen din. Du kan velge å inkludere alle variabler eller bestemte variabler i dataoverføringen din.
   1. Dette alternativet vil inkludere alle spørsmål i undersøkelsen din og bakgrunnsvariabler i dataoverføringen.
      1. Bruk rullegardinmenyen til å velge alternativet inkluder alle variabler
      2. Klikk neste.
   2. Dette alternativet lar deg velge hvilke spørsmål i undersøkelsen og bakgrunnsvariabler som skal inkluderes i dataoverføringen din.
      1. Bruk rullegardinmenyen for å velge alternativet inkluder spesifikke variabler og klikk neste.
      2. Velg spørsmålene og bakgrunnsvariablene du ønsker å inkludere i dataoverføringen din og klikk legg til.
6. Velg variabeletiketter som webhooken skal bruke. Du kan velge mellom:
   • Auto-genererte etiketter: disse genereres av Enalyzer og er de samme etikettene som de auto-genererte etikettene i nedlastingen av responsdata.
   • Dataetiketter: Du kan bruke dataetiketter som du kan tilpasse selv under innstillingene for undersøkelsen din. 
7. Legg til URL-en som webhook-automatiseringen vil sende dataene til.
8. Klikk på test forbindelse-knappen. Når forbindelsen din er vellykket, klikk neste.
9. Gi automatiseringen din et navn og klikk neste.
10. Sett 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 din, klikk ferdig.

Tilpass Dataetiketter

Når du oppretter en bakgrunnsvariabel eller et spørsmål, genererer Enalyzer automatisk en etikett som du kan finne i nedlastningene av responsdata. Dataetiketter lar deg tilpasse etiketter for dine undersøkelsesbakgrunnsvariabler og spørsmål for utgående webhooks for å kontrollere utdataene fra API-kall.

Dine dataetiketter defineres under undersøkelsesinnstillingene dine, alt du trenger å gjøre er:

1. Gå til undersøkelsesområdet () og åpne undersøkelsen din.
2. I sidemenyen, klikk på innstillinger.
3. Under datainnstillinger, klikk på dataetiketter.
4. Du vil se en oversikt over alle undersøkelsesvariablene (bakgrunnsvariabler og spørsmålselementer) på venstre side. På høyre side, vil du se dine dataetiketter. Som standard er dataetikettene automatisk generert, basert på de tilsvarende bakgrunnsvariablene/undersøkelseselementene, 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 når man kopierer spørsmål, men de kopieres når man kopierer undersøkelser eller når undersøkelsen deles som en mal.

Vis Detaljer for Automatiseringskjøring

Hver gang automatiseringen av utgående webhook utføres, opprettes en ny kjøring. Automatiseringskjøringer er tilfellene når din utgående webhook overfører en undersøkelsesrespons til det spesifiserte eksterne systemet. Så snart automatiseringen av utgående webhook starter, kan du se de automatiseringskjøringene den oppretter. Hver automatiseringskjøring kan ha en forskjellig status. De mulige statusene er:

• Planlagt: Automatiseringen av utgående webhook er planlagt for en senere tid, men har ikke kjørt enda.
• Mislykket: Automatiseringen av utgående webhook har støtt på en feil og klarte ikke å kjøre.
• Spilles av: Automatiseringen av utgående webhook spilles av for øyeblikket.
• Vellykket: Automatiseringen av utgående webhook ble fullført med suksess og undersøkelsesresponsen ble sendt til det eksterne systemet.

For å se detaljer om en automatiseringskjøring, er alt du trenger å gjøre:

1. Gå til automatiseringsområdet () og klikk på Enalyzer i sidemenyen.
2. I sidemenyen, klikk på Enalyzer.
3. Klikk på automatiseringen.
4. Under logg, klikk på automatiseringskjøringer.
5. For å se en automatiseringskjørings detaljer, klikk bare på kjøringen.
6. Detaljene for automatiseringskjøringen inkluderer:
   • Fornavn og etternavn: kjøringen vil vise respondentens fornavn og etternavn hvis tilgjengelig.
   • Status: kjøringsstatusen, samt dato og klokkeslett den fikk denne statusen.
   • Opprettelsestid: dato og klokkeslett kjøringen ble opprettet.
   • Push-URL: URL-en som undersøkelsesresponsen ble postet til.
   • Utgående melding: dataene som ble sendt til det eksterne systemet.

Kjøringer fra anonyme undersøkelser vil ikke vise respondentenes fornavn, etternavn eller e-poster. I stedet vil kjøringen bli navngitt "Anonym".

Filtrering av automatiske kjøringer

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

For å filtrere dine automatiske kjøringer, må du:

1. Gå til området for automatiseringer () og klikk på Enalyzer i sidemenyen.
2. I sidemenyen, klikk på Enalyzer.
3. Klikk på automatiseringen.
4. Under logg, klikk på automatiske kjø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 å gå gjennom dem:
   • Søk etter navn eller e-postadresse: Skriv inn en e-postadresse eller et navn i søkefeltet. Dette refererer til verdien av svaret på undersøkelsen.
   • Status: Filtrer etter kjøringsstatus.
   • Tidsperiode: Filtrer etter tidsperioden basert på kjøringens opprettelsesdato.
     

     Automatiske kjøringer lagres kun i 14 dager, derfor er tidsperiodefilteret begrenset til 14 dager tilbake i tid.

7. Når du er ferdig med å legge til alle filtre, klikk på bruk-knappen for å filtrere listen over automatiske kjøringer og lukke menyen for redigering av filterkjøringer.

Gjenta automatiseringskjøringer

Det er flere grunner til at du ønsker å gjenta en kjøring. Den vanligste er hvis den har feilet, men du ønsker kanskje også å sende data på nytt eller gjenta en kjøring som har blitt planlagt for et senere tidspunkt. For å gjenta kjøringene dine, alt du trenger å gjøre er:

1. Gå til automatiseringsområdet () og klikk på Enalyzer i sidemenyen.
2. I sidemenyen, klikk på Enalyzer.
3. Klikk på automatiseringen.
4. Under logg, klikk på automatiseringskjøringer.
5. Klikk på handlingsmenyen og velg gjenta.
6. Velg kjøring(ene) du ønsker å gjenta og klikk på gjenta-knappen.

Motta feilvarslinger

Utgående webhooks kan feile av forskjellige grunner og føre til at automasjonen din blir deaktivert. Uansett årsaken, har du muligheten til å aktivere e-postvarsler for feil for din automasjon. Du kan definere personen(e) som trenger å motta disse varslingene.

For å aktivere feilvarsler, må du:

1. Gå til området for automatiseringer () og klikk på Enalyzer i sidemenyen.
2. Klikk på automatiseringen du vil aktivere feilvarsler for.
3. Under feilvarsler, aktiver e-postvarslinger innstillingen.
4. Klikk på legg til mottaker og skriv inn e-postadressen som vil motta e-postene med feilvarsel. Gjenta dette steget for å legge til flere mottakere.
5. Endringene dine vil bli lagret umiddelbart.