Maak een survey-campagne aan

Aan het einde van deze gids loopt er een geplande survey-campagne die op het ingestelde moment automatisch een uitnodiging verstuurt naar de doelgroep, met optioneel één tot drie herinneringen aan respondenten die nog niets hebben ingevuld.

Voor achtergrond, zie de explanation. Voor velden en endpoints, zie de reference.

Voorwaarden

  • Je hebt backoffice-rechten in de tenant.
  • De survey die je wilt verspreiden bestaat en is gekoppeld aan een actieve PublicSurveyLink (publieke deelname-link). Zonder die link annuleert de processor de campagne automatisch bij invite-tick.
  • Er is minstens één MessageTemplate beschikbaar in de admin-omgeving die de huisstijl draagt en een `` placeholder bevat in de HTML.
  • Er zijn één of meer tags die de doelgroep selecteren. Alleen actieve gebruikers met minstens één van deze tags krijgen de uitnodiging.
  • De BullMQ-worker die survey-campaign-tick verwerkt staat aan (standaard onderdeel van de api-deployment).

1. Open de backoffice

Navigeer naar /backoffice/survey-campagnes. Je ziet een lijst van bestaande campagnes met hun fase-marker en status. Klik Nieuwe campagne.

2. Vul de basisgegevens in

In het blok “Campagne”:

  • Naam: vrije tekst, intern gebruik (bijvoorbeeld Tevredenheid Q2 2026).
  • Beschrijving: optioneel, intern gebruik.
  • Vragenlijst: kies de survey via de autocomplete.
  • Doelgroep (tags): voeg één of meer tags toe. Gebruikers met minstens één van deze tags ontvangen de uitnodiging.
  • Template: kies de campagne-template uit de autocomplete. Eén keuze voor de hele campagne, alle fases erven hem.

3. Vul de uitnodiging in

In het blok “Uitnodiging”:

  • Verzenddatum en -tijd: het moment waarop de uitnodiging mag worden verstuurd. Een tick die deze drempel passeert, vuurt de invite. De verzenddatum mag niet in het verleden liggen op het moment van aanmaken.
  • Onderwerp: het onderwerp van de mail. Boven het veld staan twee knoppen “Enquête link” en “Naam ontvanger” die of op de cursor invoegen.
  • Body: rich-text editor. Schrijf je tekst, gebruik de toolbar-knoppen “Enquête link” en “Naam ontvanger” om de placeholders in te voegen. Bijvoorbeeld:
Beste ,

We willen graag je mening horen. Klik hier om de vragenlijst in te vullen:

4. Optioneel: configureer reminders

Per reminder (1, 2, 3) is er een blok. Vink Versturen aan om een herinnering toe te voegen. Daarna verschijnen:

  • Verzenddatum en -tijd: moet later vallen dan de vorige fase. De form valideert dit en geeft een rode foutmelding bij overlap of achterstand.
  • Onderwerp: zelfde knoppen als bij de uitnodiging.
  • Body: zelfde rich-text editor.

Reminders gaan alleen naar respondenten die nog niets hebben ingevuld op het moment dat de tick vuurt. Eén code per ontvanger blijft consistent over alle fases, dus de URL in de reminder is dezelfde als in de oorspronkelijke uitnodiging.

5. Sla op

Klik Opslaan. Je belandt op de detail-pagina van de campagne. De status staat op Gepland (scheduled). De BullMQ-worker pakt de campagne op de eerstvolgende tick na de invite-datum.

6. Verifieer de invite

Op de detail-pagina:

  • Direct na opslaan staat onder “Snapshot doelgroep” nog niets, omdat de snapshot pas bij de invite-tick wordt opgebouwd.
  • Bij de eerstvolgende tick na de invite-datum verandert de status naar Loopt (running) en verschijnt het aantal vastgelegde deelnemers en het tijdstip van de snapshot.
  • Bij Respondenten verschijnen tellers zodra deelnemers de survey invullen.

Als de status onverwacht naar Geannuleerd (cancelled) springt direct na de invite-datum, controleer dan:

  • De gekozen survey heeft een actieve PublicSurveyLink.
  • De gekozen template bestaat nog en is niet verwijderd.
  • De api-logs (of het admin-dashboard) tonen welke van de drie ontbrak.

7. Bewerk gedurende de looptijd

Zolang de campagne Loopt:

  • Vergrendeld: vragenlijst, doelgroep-tags, template, invite-verzenddatum, invite-onderwerp en invite-body. De UI toont een gele banner.
  • Bewerkbaar: alle reminder-velden, totdat de bijbehorende reminder is verstuurd.

Wijzigingen op een nog niet verstuurde reminder werken bij de eerstvolgende tick.

8. Annuleer indien nodig

Klik op de detail-pagina Annuleren. Bevestig in de prompt. Reeds verstuurde berichten blijven uit, toekomstige fases vervallen. De status verandert naar Geannuleerd.

Wat te doen bij fouten

Symptoom Oorzaak Actie
Campagne springt direct na invite-datum naar cancelled Survey heeft geen actieve PublicSurveyLink, template ontbreekt, of tenant-context onbreekbaar in BullMQ-job Controleer survey-link en template-bestaan, check api-logs op survey campaign cannot send invite: ...
Reminder vuurt niet Geen non-respondents over, of reminderXSentAt was al gezet Open de detail-pagina, kijk onder “Fases” naar Verstuurd op. Een fase met respondenten op nul vuurt nog steeds (mailt niemand, markeert sentAt)
Reminder mailt minder mensen dan verwacht Sommige deelnemers hadden geen surveyCode op hun participant-record Open api-logs op survey campaign reminder skipping participants without surveyCode. Meestal duidt dit op een handmatig toegevoegde participant; voeg de ontbrekende code handmatig toe of laat de deelnemer afvallen
Onderwerp toont letterlijk `` in de mail Placeholder is in de subject geplakt zonder dat de pipeline hem oplost Onderwerp draait door dezelfde Handlebars-pipeline als de body, controleer of de tenant-config niet de subject-rendering uitschakelt
Body toont letterlijk `` Subject of body bevat de placeholder maar de campagne kon geen surveyUrl per ontvanger leveren Check in de api-logs of resolveCampaignSendContext faalt; meestal door een ontbrekende PublicSurveyLink

Verwante documenten