Happynizr koppelen | Helpcentrum

Wat je nodig hebt

De rol Admin of Member in je organisatie. Viewers hebben geen toegang tot Koppelen. Zie Wie mag koppelen?.
Tweestapsverificatie (2FA) op je APIboard-account.
Een vrije plek in je pakket: Proefperiode en Basis 3 koppelingen, Team 7, Pro 10 (plus eventueel een gekochte extra koppeling).
Een Happynizr-account waarin je een API-token kunt aanmaken.

Verbinden

Ga in APIboard naar Koppelen > Koppelingen.
Zoek Happynizr bij Beschikbare koppelingen (of typ de naam in het zoekveld) en klik op de kaart. Er opent een venster dat je stap voor stap begeleidt.
Log in op je Happynizr-account in een ander tabblad.
Ga naar Beheer > Koppelingen > API en maak een nieuw token aan.
Plak het token in het veld API-token in APIboard. Vul eventueel een Naam voor deze koppeling (optioneel) in.
Klik op Koppelen.
APIboard haalt direct de eerste gegevens op (Data wordt opgehaald…). Daarna zie je Verbonden met Happynizr, met de dashboards die klaarstaan. Op Koppelen > Koppelingen staat de pil Bezig met ophalen… tot de eerste volledige ronde klaar is; daarna staat er Actief.

Account of administratie kiezen

Er is geen keuzescherm: één token hoort bij één Happynizr-account. Heb je meer accounts, koppel ze dan elk met een eigen token.

Welke gegevens je krijgt

Onderwerp	Tabellen
Antwoorden	Antwoorden, Antwoorden per vraag
Vragenlijsten	Vragenlijsten, Vragen, Vraaggroepen
Deelnemers	Deelnemers, Uitgesloten e-mailadressen
Beheer	Gebruikers

Je vraagt de gegevens op via de API en ziet ze in de Datawerkbank. Alle tabellen en velden staan in de API-documentatie van Happynizr.

Hoe vaak vernieuwd

Happynizr geeft niet aan wat er is gewijzigd, dus er is geen incrementele synchronisatie. Elke ronde haalt APIboard de lijst met vragenlijsten en gebruikers op en daarna, per actieve vragenlijst, de details, deelnemers, uitgesloten e-mailadressen en antwoorden. De antwoorden komen uit een volledige export van elke vragenlijst en worden elke ronde volledig opnieuw ingelezen. Antwoorden die niet meer in de export staan, worden als verwijderd gemarkeerd.

Antwoorden van vóór de grens van je pakket slaat APIboard niet op: Proefperiode en Basis vanaf 1 januari van dit jaar, Team vanaf vorig jaar, Pro vanaf twee jaar terug.

Hoe vaak dat gebeurt, hangt af van je pakket (Proefperiode, Basis, Team of Pro): zie Hoe vaak worden gegevens vernieuwd?.

Goed om te weten

Alleen actieve vragenlijsten worden opgehaald. Een vragenlijst die inactief wordt, gaat nog één ronde mee.
APIboard laat ruim tijd tussen de aanroepen, dus bij veel vragenlijsten loopt een ronde over meerdere runs.
Taalcodes (nl, en, de, fr) worden als Nederlands, Engels, Duits en Frans getoond.
Opnieuw verbinden vervangt alleen je inloggegevens. De koppeling, alle opgehaalde gegevens en de syncstand blijven staan, de status gaat terug naar Actief en de volgende synchronisatie haalt alleen wijzigingen op. Het verbindscherm opent direct, zonder bevestigingsvraag. Je plakt een nieuw token. APIboard herkent bij deze koppeling niet of een sleutel bij een ander account hoort, dus gebruik een sleutel van hetzelfde account.
Je vindt Opnieuw verbinden (pijlicoon) in het zijpaneel dat opent als je op de kaart van de koppeling klikt.
Een koppeling of account verwijderen (Koppeling verwijderen of het verwijderpictogram bij een account) wist ook alle opgehaalde gegevens. Dat kan niet ongedaan worden gemaakt.

Problemen oplossen

Koppelen mislukt. Controleer je gegevens en probeer het opnieuw. Dit is de standaardmelding. Controleer of je het hele token hebt gekopieerd en of het in Happynizr nog bestaat. Maak zo nodig onder Beheer > Koppelingen > API een nieuw token aan.
Viewers kunnen geen koppelingen beheren. Je hebt de rol Viewer. Vraag een Admin van je organisatie om je de rol Member te geven, of om de koppeling te maken.
Dit account is al gekoppeld. Wat je probeert te koppelen, staat al in je organisatie. Zoek het op onder Koppelen > Koppelingen.
Je hebt je koppelingen-limiet bereikt voor je pakket. (of Je hebt je accounts-limiet bereikt voor je pakket.) Kies Bekijk abonnementen om te upgraden, of koop een extra koppeling of extra account.
De pil Fout bij de koppeling. Een synchronisatie is mislukt of de toegang is verlopen of ingetrokken. APIboard probeert het bij een tijdelijke fout later zelf opnieuw; bij een verlopen toegang gebruik je Opnieuw verbinden.