Utgående Webhooks

Om utgående webhooks

I allmänna termer är en webhook hur applikationer automatiskt kommunicerar med varandra. Med andra ord, ett meddelande skickas över nätet, vilket automatiskt utlöses när en specifik händelse inträffar. Automatisering av utgående webhook utlöses när en respondent har slutfört din undersökning och deras svar skickas till ett externt system efter ditt val.

Varje gång som automatiseringen för den utgående webhooken utlöses, skapas en ny automationskörning. Dessa körningar representerar tillfällen då din utgående webhook skickar ett undersökningssvar till det specificerade externa systemet. Med Enalyzer kan du enkelt visa och hantera dina automationskörningar.

Webhooks är avsedda för användare som vet hur man hanterar dem. Observera att vi inte kan felsöka din kod eller ge steg-för-steg instruktioner för utveckling.

Skapa en utgående webhook-automation

För att konfigurera en utgående webhook-automation måste du:

1. Gå till området för automationer () och klicka på Enalyzer i sidomenyn.
2. I sidomenyn, klicka på Enalyzer.
3. Klicka på skapa automation. Om du redan har en eller flera automationer klicka på ikonen för att lägga till automation () för att lägga till en automation.
4. Välj alternativet för webhooks och klicka på utgående webhook.
5. Välj vilka variabler du vill inkludera i din överföring. Du kan välja att inkludera alla variabler eller specifika variabler i din dataöverföring.
   1. Det här alternativet kommer att inkludera alla dina enkätfrågor och bakgrundsvariabler i dataöverföringen.
      1. Använd rullgardinsmenyn för att välja alternativet inkludera alla variabler
      2. Klicka nästa.
   2. Det här alternativet låter dig välja vilka enkätfrågor och bakgrundsvariabler du vill inkludera i din dataöverföring.
      1. Använd rullgardinsmenyn för att välja alternativet inkludera specifika variabler och klicka nästa.
      2. Välj frågorna och bakgrundsvariablerna du vill inkludera i din dataöverföring och klicka lägg till.
6. Välj de variabeletiketter som webhooken ska använda. Du kan välja mellan:
   • Automatiskt genererade etiketter: dessa genereras av Enalyzer och är samma etiketter som de automatiskt genererade etiketterna i nedladdningar av svarsdata.
   • Dataetiketter: Du kan använda dataetiketter som du själv kan anpassa under dina enkätinställningar. 
7. Lägg till URL:en som webhook-automationen kommer att skicka datan till.
8. Klicka på knappen testa anslutning. När din anslutning är framgångsrik klicka på nästa.
9. Namnge din automation och klicka nästa.
10. Ställ in automationsstatusen. Som standard är den aktiverad, men du kan inaktivera den innan du skapar den.
11. När du är redo att skapa din automation, klicka på klar.

Anpassa datamärkningar

När du skapar en bakgrundsvariabel eller fråga genererar Enalyzer automatiskt en etikett som du kan hitta i nedladdning av responsdata. Datamärkningar låter dig anpassa etiketter för dina surveys bakgrundsvariabler och frågor för utgående webhooks för att kontrollera utdata från API-anrop. 

Dina datamärkningar definieras under dina surveyinställningar, allt du behöver göra är:

1. Gå till området för surveys () och öppna din survey.
2. I sidomenyn, klicka på inställningar.
3. Under datainställningar, klicka på datamärkningar.
4. Du kommer att få en översikt av alla surveyvariabler (bakgrundsvariabler och frågeelement) på vänster sida. På höger sida kommer du att se dina datamärkningar. Som standard är datamärkningarna autogenererade, baserade på motsvarande bakgrundsvariabler/surveyelement, men du kan definiera dina egna värden.

Datamärkningar måste vara unika, kan inte innehålla specialtecken och är begränsade till 100 tecken.

Datamärkningar kan endast definieras för bakgrundsvariabler och frågor, men inte för svarsalternativ.

Datamärkningar kopieras inte när frågor kopieras, men de kopieras när surveys kopieras eller när surveyen delas som en mall.

Visa detaljer för automatiserade körningar

Varje gång automatiseringen av utgående webhooks körs skapas en ny körning. Automatiserade körningar är de tillfällen då din utgående webhook överför ett enkätsvar till det angivna externa systemet. Så fort automatiseringen av den utgående webhooken börjar köras, kan du se de körningar den skapar. Varje automatiserad körning kan ha en annan status. De möjliga statusarna är:

• Schemalagd: den utgående webhookautomatiseringen har schemalagts för en senare tidpunkt men har ännu inte körts.
• Misslyckades: den utgående webhookautomatiseringen har stött på ett fel och misslyckats med att köras.
• Spelas upp: den utgående webhookautomatiseringen spelas för närvarande upp.
• Lyckades: den utgående webhookautomatiseringen slutfördes framgångsrikt och enkätsvaret skickades till det externa systemet.

För att visa detaljer om en automatiserad körning, behöver du bara:

1. Gå till automatiseringsområdet () och klicka på Enalyzer i sidomenyn.
2. I sidomenyn klickar du på Enalyzer.
3. Klicka på automatiseringen.
4. Under logg klickar du på automatiserade körningar.
5. För att visa en automatiserad körnings detaljer klickar du helt enkelt på körningen.
6. Detaljer för automatiserade körningar inkluderar:
   • Förnamn och efternamn: körningen kommer att visa respondentens förnamn och efternamn om tillgängligt.
   • Status: körningens status samt datum och tid då den fick den statusen.
   • Skapelse tid: datum och tid då körningen skapades.
   • Push-URL: den URL som enkätsvaret postades till.
   • Utgående meddelande: de data som skickades till det externa systemet.

Körningar från anonyma enkäter kommer inte att visa respondenternas förnamn, efternamn eller e-postadresser. Istället kommer körningen att namnges "Anonym".

Filtrera Automatiseringskörningar

Du kan filtrera dina automatiseringskörningar efter status, tidsperiod eller namn. Detta hjälper dig att sortera bland dina körningar och göra dem lättare att hantera, till exempel kan du hitta alla misslyckade körningar och se vad som hände eller spela om dem.

För att filtrera dina automatiseringskörningar måste du:

1. Gå till automatiseringsområdet () och klicka på Enalyzer i sidomenyn.
2. I sidomenyn klickar du på Enalyzer.
3. Klicka på automatiseringen.
4. Under logg, klicka på automatiseringskörningar.
5. Klicka på filtrera-knappen.
6. Du har följande alternativ för att filtrera körningar, och du kan lägga till så många filter som nödvändigt för att förfina din sökning:
   • Sök efter namn eller e-postadress: Ange en e-postadress eller ett namn i sökfältet. Detta hänvisar till värdet av enkätsvaret.
   • Status: Filtrera efter körningens status.
   • Tidsperiod: Filtrera efter tidsperiod baserat på körningens skapelsedatum.
     

     Automatiseringskörningar lagras endast i 14 dagar, därför begränsas tidsperiodfilter till de senaste 14 dagarna.

7. När du är klar med att lägga till alla filter, klicka på tillämpa för att filtrera listan över automatiseringskörningar och för att stänga redigera filterkörningar-sidomenyn.

Automatiserade Körningar Upprepa

Det finns flera anledningar till varför du skulle vilja upprepa en körning. Den vanligaste anledningen är om den har misslyckats, men du kan också vilja skicka datan igen eller spela en körning som har schemalagts till ett senare tillfälle. För att upprepa dina körningar, är allt du behöver göra följande:

1. Gå till automationsområdet () och klicka på Enalyzer i sidomenyn.
2. I sidomenyn, klicka på Enalyzer.
3. Klicka på automationen.
4. Under logg, klicka på automationskörningar.
5. Klicka på aktionsmenyn och välj upprepa.
6. Välj de körning(ar) du skulle vilja upprepa och klicka på upprepa-knappen.

Få felanmälningar

Utgående webhooks kan misslyckas av olika anledningar och orsaka att din automatisering inaktiveras. Oavsett anledningen kan du aktivera e-postmeddelanden för fel för din automatisering. Du kan ange person(er) som behöver få dessa meddelanden.

För att aktivera felanmälningar måste du:

1. Gå till området för automatiseringar () och klicka på Enalyzer i sidomenyn.
2. Klicka på den automatisering du vill aktivera felanmälningar för.
3. Under felanmälningar, aktivera inställningen för e-postmeddelanden.
4. Klicka på lägg till mottagare och ange e-postadressen som ska få e-postmeddelandena om fel. Upprepa detta steg för att lägga till fler mottagare.
5. Dina ändringar sparas omedelbart.