Uitgaande Webhooks

Over Uitgaande Webhooks

In algemene termen is een webhook hoe applicaties automatisch met elkaar communiceren. Met andere woorden, er wordt een bericht over het web gestuurd, dat automatisch wordt geactiveerd wanneer een specifieke gebeurtenis plaatsvindt. De automatisering van de uitgaande webhook wordt geactiveerd wanneer een respondent uw enquête voltooit en hun antwoord wordt verzonden naar een extern systeem van uw keuze.

Elke keer dat de uitgaande webhook-automatisering wordt geactiveerd, wordt er een nieuwe automatiseringsrun gecreëerd. Deze runs vertegenwoordigen de momenten waarop uw uitgaande webhook een enquête-antwoord naar het gespecificeerde externe systeem stuurt. Met Enalyzer kunt u uw automatiseringsruns gemakkelijk bekijken en beheren.

Webhooks zijn bedoeld voor gebruikers die weten hoe ze ermee om moeten gaan. Houd er rekening mee dat we uw code niet kunnen troubleshooten of stapsgewijze ontwikkelinstructies kunnen geven.

Maak een Automatisering voor Uitgaande Webhook

Om een automatisering voor uitgaande webhook in te stellen, moet je:

1. Ga naar het automatiseringsgebied () en klik op Enalyzer in het zijmenu.
2. Klik in het zijmenu op Enalyzer.
3. Klik op maak automatisering aan. Als je al één of meerdere automatiseringen hebt, klik op het icoon voor het toevoegen van automatisering () om een automatisering toe te voegen.
4. Selecteer de webhooks optie en klik op uitgaande webhook.
5. Kies welke variabelen je wilt opnemen in je overdracht. Je kunt ervoor kiezen om alle variabelen of specifieke variabelen op te nemen in je datatransfer.
   1. Deze optie zal al je enquêtevragen en achtergrond variabelen opnemen in de datatransfer.
      1. Gebruik het dropdown menu om de neem alle variabelen op optie te selecteren
      2. Klik op volgende.
   2. Deze optie stelt je in staat te selecteren welke enquêtevragen en achtergrond variabelen je wilt opnemen in je datatransfer.
      1. Gebruik het dropdown menu om de neem specifieke variabelen op optie te selecteren en klik op volgende.
      2. Selecteer de vragen en achtergrond variabelen die je wilt opnemen in je datatransfer en klik op toevoegen.
6. Selecteer de variabele etiketten die de webhook moet gebruiken. Je kunt kiezen tussen:
   • Automatisch gegenereerde etiketten: deze worden gegenereerd door Enalyzer en zijn dezelfde etiketten die je vindt bij de antwoorddata downloads.
   • Data labels: Je kunt datalabels gebruiken die je zelf kunt aanpassen onder je enquête instellingen. 
7. Voeg de URL toe waar de webhook automatisering de data naartoe zal sturen.
8. Klik op de test connectie knop. Zodra je connectie succesvol is, klik op volgende.
9. Geef je automatisering een naam en klik op volgende.
10. Stel de automatiseringsstatus in. Standaard is hij ingeschakeld, echter, je kunt hem uitschakelen voordat je hem aanmaakt.
11. Als je klaar bent om je automatisering aan te maken, klik dan op klaar.

Aanpassen Data Labels

Wanneer u een achtergrondvariabele of vraag aanmaakt, genereert Enalyzer automatisch een label dat u kunt vinden in de antwoorddata downloads. Data labels stellen u in staat om labels aan te passen voor uw enquête achtergrondvariabelen en vragen voor uitgaande webhooks om de output van API-calls te regelen. 

Uw data labels zijn gedefinieerd onder uw enquête-instellingen, alles wat u hoeft te doen is:

1. Ga naar het enquêtegebied () en open uw enquête.
2. In het zijmenu, klik op instellingen.
3. Onder data-instellingen, klik op data labels.
4. U zult een overzicht zien van alle enquêtevariabelen (achtergrondvariabelen en vragen) aan de linkerkant. Aan de rechterkant ziet u uw data labels. Standaard zijn de data labels automatisch gegenereerd, gebaseerd op de overeenkomstige achtergrondvariabelen/vragen, echter, u kunt uw eigen waarden definiëren.

Data labels moeten uniek zijn, kunnen geen speciale karakters bevatten, en zijn beperkt tot 100 karakters.

Data labels kunnen alleen worden gedefinieerd voor achtergrondvariabelen en vragen, maar niet voor respons opties.

Data labels worden niet gekopieerd bij het kopiëren van vragen, maar ze worden wel gekopieerd bij het kopiëren van enquêtes of wanneer de enquête wordt gedeeld als een template.

Bekijk Automatisering Uitvoeringsgegevens

Elke keer dat de uitgaande webhook-automatisering wordt uitgevoerd, wordt er een nieuwe uitvoering gemaakt. Automatiseringsuitvoeringen zijn de momenten waarop uw uitgaande webhook een enquêteresponse overdraagt aan het gespecificeerde externe systeem. Zodra de uitgaande webhook-automatisering begint te lopen, kunt u de gecreëerde automatiseringsuitvoeringen bekijken. Elke automatiseringsuitvoering kan een andere status hebben. De mogelijke statussen zijn:

• Gepland: de uitgaande webhook-automatisering is gepland voor een later tijdstip maar is nog niet uitgevoerd.
• Mislukt: de uitgaande webhook-automatisering heeft een fout tegengekomen en kon niet worden uitgevoerd.
• Spelen: de uitgaande webhook-automatisering is momenteel bezig.
• Succesvol: de uitgaande webhook-automatisering is succesvol voltooid en de enquêteresponse is verzonden naar het externe systeem.

Om details van een automatiseringsuitvoering te zien, hoeft u alleen maar het volgende te doen:

1. Ga naar het automatiseringsgebied () en klik op Enalyzer in het zijmenu.
2. In het zijmenu, klik op Enalyzer.
3. Klik op de automatisering.
4. Onder log, klik op automatiseringsuitvoeringen.
5. Om de details van een automatiseringsuitvoering te bekijken, klik je simpelweg op de uitvoering.
6. De details van een automatiseringsuitvoering omvatten:
   • Voornaam en achternaam: de uitvoering zal de voornaam en achternaam van de respondent weergeven, indien beschikbaar.
   • Status: de status van de uitvoering, evenals de datum en tijd waarop het die status kreeg.
   • Aanmaaktijd: de datum en tijd waarop de uitvoering is aangemaakt.
   • Push URL: de URL waar de enquêteresponse naar toe is gestuurd.
   • Uitgaand bericht: de gegevens die naar het externe systeem zijn verzonden.

Uitvoeringen van anonieme enquêtes zullen de voornamen, achternamen of e-mails van de respondenten niet weergeven. In plaats daarvan zal de uitvoering "Anoniem" worden genoemd.

Filter Automatisering Uitvoeringen

U kunt uw automatiseringsuitvoeringen filteren op status, tijdvak of naam. Dit helpt u om uw uitvoeringen te sorteren en ze makkelijker te beheren, bijvoorbeeld, u kunt alle mislukte uitvoeringen vinden en zien wat er gebeurde of ze opnieuw afspelen.

Om uw automatiseringsuitvoeringen te filteren, moet u:

1. Ga naar het automatiseringsgebied () en klik op Enalyzer in het zijmenu.
2. In het zijmenu, klik op Enalyzer.
3. Klik op de automatisering.
4. Onder logboek, klik op automatiseringsuitvoeringen.
5. Klik op de filter knop.
6. U heeft de volgende opties om uitvoeringen te filteren, en u kunt zo veel filters toevoegen als nodig om door ze heen te graven:
   • Zoeken op naam of e-mailadres: Typ een e-mailadres of een naam in het zoekveld. Dit verwijst naar de waarde van de enquêterespons.
   • Status: Filter op de uitvoeringsstatus.
   • Tijdvak: Filter op het tijdvak gebaseerd op de aanmaakdatum van de uitvoering.
     

     Automatiseringsuitvoeringen worden alleen 14 dagen bewaard, daarom is het tijdvakfilter beperkt tot 14 dagen in het verleden.

7. Als u klaar bent met het toevoegen van alle filters, klik dan op de toepassen knop om de automatiseringsuitvoeringenlijst te filteren en sluit het zijmenu voor het bewerken van uitvoeringsfilters.

Automatisering Uitvoeringen Herhalen

Er zijn meerdere redenen waarom u een uitvoering opnieuw zou willen afspelen. De meest voorkomende is als deze is mislukt, maar u wilt misschien de gegevens opnieuw verzenden of een uitvoering afspelen die voor een latere tijd is gepland. Om uw uitvoeringen opnieuw af te spelen, hoeft u alleen maar het volgende te doen:

1. Ga naar het automatiseringen gebied () en klik op Enalyzer in het zijmenu.
2. In het zijmenu, klik op Enalyzer.
3. Klik op de automatisering.
4. Onder logboek, klik op automatisering uitvoeringen.
5. Klik op het actiemenu en selecteer herhalen.
6. Selecteer de uitvoering(en) die u opnieuw wilt afspelen en klik op de herhalen knop.

Foutmeldingen ontvangen

Uitgaande webhooks kunnen om verschillende redenen mislukken en ervoor zorgen dat uw automatisering wordt uitgeschakeld. Wat de reden ook is, u kunt e-mail foutmeldingen inschakelen voor uw automatisering. U kunt de persoon/personen definiëren die deze meldingen moeten ontvangen.

Om foutmeldingen in te schakelen, moet u:

1. Ga naar het automatiseringsgebied () en klik op Enalyzer in het zijmenu.
2. Klik op de automatisering waarvoor u foutmeldingen wilt inschakelen.
3. Onder foutmeldingen, schakel de e-mailmeldingen instelling in.
4. Klik op de ontvanger toevoegen en voer het e-mailadres in dat de foutmeldingsmails zal ontvangen. Herhaal deze stap om meer ontvangers toe te voegen.
5. Uw wijzigingen worden direct opgeslagen.