Udgående Webhooks

Om Udgående Webhooks

Generelt er en webhook en måde, hvorpå applikationer automatisk kommunikerer med hinanden. Med andre ord sendes en besked over nettet, som automatisk udløses, hver gang en specifik begivenhed finder sted. Automationen for udgående webhook udløses, når en respondent fuldfører din undersøgelse, og deres svar sendes til et eksternt system efter dit valg.

Hver gang automationen for udgående webhook udløses, skabes der en ny automationskørsel. Disse kørsler repræsenterer tilfælde, hvor din udgående webhook sender et svar fra undersøgelsen til det specificerede eksterne system. Med Enalyzer kan du nemt se og håndtere dine automationskørsler.

Webhooks er tiltænkt brugere, der ved, hvordan man håndterer dem. Bemærk venligst, at vi ikke kan fejlfinde din kode eller give trin-for-trin udviklingsinstruktioner.

Opret en udgående webhook-automatisering

For at opsætte en udgående webhook-automatisering, skal du:

1. Gå til automatiseringsområdet () og klik på Enalyzer i sidemenuen.
2. I sidemenuen, klik på Enalyzer.
3. Klik på opret automatisering. Hvis du allerede har en eller flere automatiseringer, klik på tilføj automatiseringsikonet () for at tilføje en automatisering.
4. Vælg webhooks-muligheden og klik på udgående webhook.
5. Vælg hvilke variabler du vil inkludere i din overførsel. Du kan vælge at inkludere alle variabler eller specifikke variabler i din dataoverførsel.
   1. Denne mulighed vil inkludere alle dine undersøgelsesspørgsmål og baggrundsvariabler i dataoverførslen.
      1. Brug rullemenuen til at vælge inkluder alle variabler-muligheden
      2. Klik næste.
   2. Denne mulighed lader dig vælge hvilke undersøgelsesspørgsmål og baggrundsvariabler du vil inkludere i din dataoverførsel.
      1. Brug rullemenuen til at vælge inkluder specifikke variabler-muligheden og klik næste.
      2. Vælg de spørgsmål og baggrundsvariabler du ønsker at inkludere i din dataoverførsel og klik tilføj.
6. Vælg de variabellabels webhooken skal bruge. Du kan vælge imellem:
   • Autogenererede labels: disse bliver genereret af Enalyzer og er de samme labels som de autogenererede labels i data downloads af svar.
   • Data labels: Du kan bruge data labels, som du selv kan tilpasse under dine undersøgelsesindstillinger. 
7. Tilføj URL'en hvor webhook-automatiseringen vil sende dataene hen.
8. Klik på test forbindelse-knappen. Når din forbindelse er succesfuld, klik næste.
9. Navngiv din automatisering og klik næste.
10. Indstil automatiseringsstatus. Som standard er den aktiveret, men du kan deaktivere den før du opretter den.
11. Når du er klar til at oprette din automatisering, klik færdig.

Tilpas Dataetiketter

Når du opretter en baggrundsvariabel eller et spørgsmål, genererer Enalyzer automatisk en etiket, som du kan finde i download af responsdata. Dataetiketter gør det muligt for dig at tilpasse etiketter for din undersøgelses baggrundsvariabler og spørgsmål for udgående webhooks for at styre outputtet af API-kald.

Dine dataetiketter er defineret under dine undersøgelsesindstillinger, alt du skal gøre er:

1. Gå til undersøgelsesområdet () og åben din undersøgelse.
2. I side menuen, klik på indstillinger.
3. Under dataindstillinger, klik på dataetiketter.
4. Du vil se et overblik over alle undersøgelsesvariabler (baggrundsvariabler og spørgsmålselementer) på venstre side. På højre side, vil du se dine dataetiketter. Som standard er dataetiketterne autogenereret, baseret på de tilsvarende baggrundsvariabler/undersøgelseselementer, dog kan du definere dine egne værdier.

Dataetiketter skal være unikke, kan ikke indeholde specialtegn og er begrænset til 100 tegn.

Dataetiketter kan kun defineres for baggrundsvariabler og spørgsmål, men ikke for svarmuligheder.

Dataetiketter kopieres ikke, når du kopierer spørgsmål, men de kopieres når du kopierer undersøgelser eller når undersøgelsen deles som en skabelon.

Se detaljer for automatiseringskørsel

Hver gang automatiseringen af den udgående webhook udføres, skabes en ny kørsel. Automatiseringskørsler er tilfældene, hvor din udgående webhook overfører en undersøgelsesrespons til det angivne eksterne system. Når automatiseringen af den udgående webhook begynder at køre, kan du se de automatiseringskørsler den skaber. Hver automatiseringskørsel kan have en forskellig status. De mulige statusser er:

• Planlagt: Den udgående webhook automatisering er planlagt til en senere tid, men er endnu ikke kørt.
• Fejlet: Den udgående webhook automatisering stødte på en fejl og fejlede i at køre.
• Afspiller: Den udgående webhook automatisering er i gang med at afspille.
• Succesfuld: Den udgående webhook automatisering blev gennemført med succes, og undersøgelsesresponsen blev sendt til det eksterne system.

For at se detaljer om en automatiseringskørsel skal du bare:

1. Gå til automatiseringsområdet () og klik på Enalyzer i sidemenuen.
2. I sidemenuen klikker du på Enalyzer.
3. Klik på automatiseringen.
4. Under log, klik på automatiseringskørsler.
5. For at se en automatiseringskørsels detaljer skal du blot klikke på kørslen.
6. Detaljer for automatiseringskørslen inkluderer:
   • Fornavn og efternavn: kørslen vil vise respondentens fornavn og efternavn, hvis det er tilgængeligt.
   • Status: kørselsstatus samt dato og tid for, hvornår den fik den status.
   • Oprettelsestid: Dato og tid for, hvornår kørslen blev oprettet.
   • Push URL: URL'en som undersøgelsesresponsen blev postet til.
   • Udgående besked: de data, der blev sendt til det eksterne system.

Kørsler fra anonyme undersøgelser vil ikke vise respondenternes fornavne, efternavne eller e-mails. I stedet vil kørslen være navngivet "Anonym".

Filtrering af automatiseringskørsler

Du kan filtrere dine automatiseringskørsler efter status, tidsperiode eller navn. Dette vil hjælpe dig med at sortere dine kørsler og gøre dem nemmere at håndtere, for eksempel kan du finde alle de fejlede kørsler og se, hvad der er sket, eller afspille dem igen.

For at filtrere dine automatiseringskørsler skal du:

1. Gå til området for automatiseringer () og klik på Enalyzer i sidemenuen.
2. I sidemenuen, klik på Enalyzer.
3. Klik på automatiseringen.
4. Under log, klik på automatiseringskørsler.
5. Klik på filtrer knappen.
6. Du har følgende muligheder for at filtrere kørsler, og du kan tilføje så mange filtre som nødvendigt for at dykke dybere ned i dem:
   • Søg på navn eller e-mailadresse: Indtast en e-mailadresse eller et navn i søgefeltet. Dette refererer til værdien af undersøgelsessvaret.
   • Status: Filtrer efter kørselstatus.
   • Tidsperiode: Filtrer efter tidsperioden baseret på kørselens oprettelsesdato.
     

     Automatiseringskørsler gemmes kun i 14 dage, derfor er filteret for tidsperioder begrænset til 14 dage tilbage i tiden.

7. Når du er færdig med at tilføje alle filtre, klik på anvend knappen for at filtrere listen over automatiseringskørsler og lukke rediger filter kørsler sidemenuen.

Gentag automatiske kørsler

Der er flere grunde til, at du vil gentage en kørsel. Den mest almindelige er, hvis den er fejlet, men du kan også ønske at sende dataene igen eller afspille en kørsel, der er planlagt til en senere tid. For at gentage dine kørsler skal du blot gøre følgende:

1. Gå til området for automatisering () og klik på Enalyzer i sidemenuen.
2. I sidemenuen, klik på Enalyzer.
3. Klik på automatiseringen.
4. Under log, klik på automatiske kørsler.
5. Klik på handlingsmenuen og vælg gentag.
6. Vælg den eller de kørsler, du gerne vil gentage, og klik på gentag knappen.

Modtag fejlnotifikationer

Udgående webhooks kan fejle af forskellige årsager og medføre, at din automatisering deaktiveres. Uanset årsagen, har du mulighed for at aktivere e-mail fejlnotifikationer for din automatisering. Du kan definere personen (eller personerne) der skal modtage disse notifikationer.

For at aktivere fejlnotifikationer, skal du:

1. Gå til området med automatiseringer () og klik på Enalyzer i side menuen.
2. Klik på den automatisering, du ønsker at aktivere fejlnotifikationer for.
3. Under fejlnotifikationer, aktiver indstillingen for e-mail notifikationer.
4. Klik på tilføj modtager og indtast e-mailadressen, der skal modtage e-mails med fejlnotifikationer. Gentag dette trin for at tilføje flere modtagere.
5. Dine ændringer vil blive gemt øjeblikkeligt.