Udgående Webhooks

Om Udgående Webhooks

I generelle termer er en webhook, hvordan applikationer kommunikerer med hinanden automatisk. Med andre ord, en besked sendes over nettet, der udløses automatisk, når en bestemt begivenhed finder sted. Udgående webhook-automatisering udløses, når en respondent fuldfører din undersøgelse, og deres respons sendes til et eksternt system efter dit valg.

Hver gang den udgående webhook-automatisering udløses, laver den en ny automationskørsel. Disse køringer repræsenterer tidspunkter, hvor din udgående webhook sender en undersøgelsesrespons til det specificerede eksterne system. Med Enalyzer kan du nemt se og håndtere dine automationskørsler.

Webhooks er beregnet til 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åde () 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 datatransfer.
   1. Denne mulighed vil inkludere alle dine undersøgelsesspørgsmål og baggrundsvariabler i datatransmissionen.
      1. Brug rullemenuen til at vælge inkluder alle variabler alternativet
      2. Klik næste.
   2. Denne mulighed giver dig mulighed for at vælge, hvilke undersøgelsesspørgsmål og baggrundsvariabler der skal inkluderes i din datatransfer.
      1. Brug rullemenuen til at vælge inkluder specifikke variabler alternativet og klik næste.
      2. Vælg de spørgsmål og baggrundsvariable, du vil inkludere i din datatransfer og klik tilføj.
6. Vælg de variabel etiketter webhook'en skal bruge. Du kan vælge mellem:
   • Automatisk genererede etiketter: disse er genereret af Enalyzer og er de samme etiketter, du finder respons data downloads.
   • Data etiketter: Du kan bruge data etiketter som du selv kan tilpasse under dine undersøgelsesindstillinger. 
7. Tilføj URL'en, som webhook automatiseringen vil sende dataene til.
8. Klik på test forbindelse knappen. Når din forbindelse er succesfuld, klik på næste.
9. Navngiv din automatisering og klik næste.
10. Indstil automatiseringsstatus. Som standard er det aktiveret, men du kan deaktivere den, før du opretter den.
11. Når du er klar til at oprette din automatisering, klik på færdig.

Tilpas Data Etiketter

Når du opretter en baggrundsvariabel eller et spørgsmål, genererer Enalyzer automatisk en etiket, som du kan finde i rapport downloads. Data etiketter giver dig mulighed for at tilpasse etiketterne for dine undersøgelses baggrundsvariable og spørgsmål for udgående webhooks for at styre outputtet af API-opkald.

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

1. Gå til Rapporteringsområdet () og åbn din undersøgelse.
2. I sidemenuen, klik på indstillinger.
3. Under dataindstillinger, klik på data etiketter.
4. Du vil se en oversigt over alle undersøgelsesvariable (baggrundsvariable og spørgsmål) på venstre side. På højre side vil du se dine data etiketter. Som standard er data etiketterne autogenereret, baseret på de tilsvarende baggrundsvariable/spørgsmål, men du kan definere dine egne værdier.

Data etiketter skal være unikke, kan ikke indeholde specielle tegn, og de er begrænset til 100 tegn.

Data etiketter kan kun defineres for baggrundsvariable og spørgsmål men ikke svarmuligheder.

Data etiketter kopieres ikke ved kopiering af spørgsmål, men de kopieres ved kopiering af undersøgelser eller når undersøgelsen deles som en skabelon.

Vis Automatisering Kørsels Detaljer

Hver gang den udgående webhook-automatisering udføres, opretter den en ny kørsel. Automatiseringskørsler er de tilfælde, hvor din udgående webhook overfører et undersøgelsesrespons til det angivne eksterne system. Når den udgående webhook-automatisering begynder at køre, kan du se de automatiseringskørsler, den opretter. Hver automatiseringskørsel kan have en anden 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 er stødt på en fejl og har ikke kørt.
• Afspejler: Den udgående webhook-automatisering afspiller i øjeblikket.
• Success: 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 gøre følgende:

1. Gå til automatiseringsområdet () og klik på Enalyzer i sidemenuen.
2. I sidemenuen skal du klikke på Enalyzer.
3. Klik på automatiseringen.
4. Under log, klik på automatiseringskørsler.
5. For at se en automatiseringskørsel detaljer, skal du bare klikke på kørslen.
6. Detaljerne for automatiseringskørslen inkluderer:
   • Fornavn og efternavn: Kørslen vil vise respondentens fornavn og efternavn, hvis det er tilgængeligt.
   • Status: Kørselsstatus, samt datoen og tidspunktet, hvor det fik den status.
   • Oprettelsestid: Datoen og tidspunktet hvor kørslen blev oprettet.
   • Push URL: URL'en hvor undersøgelsesresponsen blev postet til.
   • Udgående besked: Dataene der blev sendt til det eksterne system.

Kørsler fra anonyme undersøgelser vil ikke vise respondenternes fornavne, efternavne eller emails. I stedet vil kørslen blive navngivet "Anonym".

Filtrer Automatiseringer

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

For at filtrere dine automatiseringsløb, skal du:

1. Gå til automatiseringsområdet () 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å filter knappen.
6. Du har følgende muligheder for at filtrere løb, og du kan tilføje så mange filtre som nødvendigt for at bore ned gennem dem:
   • Søg efter navn eller e-mailadresse: Skriv en e-mailadresse eller et navn i søgefeltet. Dette refererer til værdien af undersøgelsessvaret.
   • Status: Filtrer efter løbsstatus.
   • Tidsperiode: Filtrer efter tidsperioden baseret på løbs oprettelsesdato.
     

     Automatiseringskørsler opbevares kun i 14 dage, derfor er tidsperioden filtret begrænset til 14 dage i fortiden.

7. Når du er færdig med at tilføje alle filtre, klik på anvend knappen for at filtrere automatiseringsløbslisten og lukke rediger filterkørsler i sidemenuen.

Gentag Automatiseringer

Der er flere grunde til, at du vil ønske at genafspille en kørsel. Den mest almindelige er, hvis den er fejlet, men du ønsker måske at sende dataene igen eller afspille en kørsel, der har været planlagt til en senere tid. For at genafspille dine kørsler skal du bare gøre følgende:

1. Gå til automatiseringsområdet () og klik på Enalyzer i side menuen.
2. I side menuen, klik på Enalyzer.
3. Klik på automatiseringen.
4. Under log, klik på automatiseringskørsler.
5. Klik på handlingsmenuen og vælg gentag.
6. Vælg de kørsler, du gerne vil genafspille og klik på gentag knappen.

Modtag Fejlmeddelelser

Udgående webhooks kan mislykkes af forskellige årsager og medføre at din automatisering deaktiveres. Uanset årsagen, har du mulighed for at aktivere fejlmeddelelser via e-mail til din automatisering. Du kan definere de person(er), der skal modtage disse meddelelser.

For at aktivere fejlmeddelelser, skal du:

1. Gå til automatiseringsområdet () og klik på Enalyzer i sidemenuen.
2. Klik på den automatisering, du ønsker at aktivere fejlmeddelelser for.
3. Under fejlmeddelelser, aktivér indstillingen e-mail meddelelser.
4. Klik på tilføj modtager og indtast e-mailadressen, der skal modtage fejlmeddelelses-e-mails. Gentag dette trin for at tilføje flere modtagere.
5. Dine ændringer gemmes med det samme.