Presentor koppelen aan Zapier of Make.

Wat je nodig hebt

• Een merk of bedrijf met Team, waar jij beheerder van bent. Webhooks horen bij Team en staan in Beheer, op het tabblad Koppelingen.
• Een account bij Zapier of Make. In Zapier is dat de app Webhooks by Zapier met de gebeurtenis Catch Hook; die zit volgens Zapier niet in het gratis abonnement. In Make is het de module Custom webhook.
• Een plek voor de gegevens, bijvoorbeeld een Google Sheet of je CRM.

Er is geen aparte Presentor-app in Zapier of Make, en die is ook niet nodig. Presentor stuurt een JSON-bericht naar een adres, en Zapier en Make hebben een algemene ontvanger voor zulke berichten. Werk je met Teamleader, HubSpot of Pipedrive, kijk dan eerst naar de eigen CRM-koppeling op hetzelfde tabblad: die zet kijkgegevens zelf als notitie en taak in het CRM. Zapier en Make zijn voor al het andere.

Wat Presentor verstuurt

Bij elke gebeurtenis stuurt Presentor één POST-verzoek met een JSON-bericht naar het adres dat je hebt opgegeven. Elk bericht heeft dezelfde buitenkant:

• id: het nummer van de gebeurtenis, beginnend met evt_.
• type: de soort gebeurtenis, bijvoorbeeld link.opened.
• created_at: het tijdstip volgens ISO 8601, in UTC.
• data: de gegevens van de gebeurtenis. Die verschillen per soort (zie De negen gebeurtenissen).

Een veld zonder waarde staat als null in het bericht; de sleutel ontbreekt dus nooit. Tijden in data (started_at, last_at en last_view) zijn UTC in de vorm 2026-10-26 09:14:22, met een spatie en zonder Z. De waarden van device (computer, telefoon of tablet) en van action.kind (afspraak, akkoord, peiling, download of offerte) zijn altijd Nederlands, ook als je Presentor in het Engels gebruikt.

De knop Test bij een webhook stuurt een bericht met type gelijk aan ping. Dat is geen van de negen gebeurtenissen, maar het laat zien dat de verbinding werkt:

{
  "id": "evt_a3p8v6nzd",
  "type": "ping",
  "created_at": "2026-10-26T09:02:41.907Z",
  "data": {
    "workspace": { "id": "ws_h4n8c2xpv", "name": "Studio Noord" },
    "message": "Test van Presentor"
  }
}

Koppelen met Zapier

1. Maak in Zapier een nieuwe Zap. Kies als trigger Webhooks by Zapier en als gebeurtenis Catch Hook. Laat Pick off a child key leeg: dan houd je ook type en created_at.
2. Kopieer de webhook-URL die Zapier toont. Die begint met https://hooks.zapier.com/hooks/catch/.
3. Open in Presentor Beheer, ga naar het tabblad Koppelingen en zoek Webhooks. Plak het adres. Alle gebeurtenissen staan standaard aangevinkt: laat alleen staan wat je nodig hebt. Elke gebeurtenis heeft andere velden, dus een eigen webhook en Zap per gebeurtenis maakt het koppelen van velden eenvoudiger. Klik op Koppeling toevoegen.
4. Presentor toont nu één keer een geheim dat begint met whsec_. Je hebt het alleen nodig om de handtekening te controleren; Zapier vraagt er niet om. Bewaar het veilig als je wel controleert.
5. Klik in de lijst bij de webhook op Test. Klik in Zapier op Test trigger: Zapier toont het testbericht. Geneste velden krijgen daar één naam met twee underscores, zoals data__workspace__name.
6. Wil je de velden van een echte gebeurtenis, open dan een link van een presentatie in een privévenster (voor link.opened) en klik in Zapier opnieuw op Test trigger. Kies het nieuwste bericht.
7. Kies de actie. Voorbeeld met Google Sheets, actie Create Spreadsheet Row: maak kolommen als Tijd, Presentatie, Naam, E-mail en Apparaat, en kies als waarden created_at, data__deck__title, data__viewer__name, data__viewer__email en data__viewer__device.
8. Test de actie en zet de Zap aan.

Voorbeeld met een notitie in je CRM, bij view.finished: zoek het contact op data__viewer__email en maak een notitie met de naam van de kijker (data__viewer__name), de kijktijd (data__view__seconds), de presentatie (data__deck__title) en tot welke slide de kijker kwam (data__view__furthest_slide van data__view__total_slides).

Koppelen met Make

1. Maak in Make een nieuw scenario. Kies als eerste module Webhooks en daarin Custom webhook.
2. Klik op Add, geef de webhook een naam (bijvoorbeeld Presentor link.opened) en klik op Save. Klik daarna op Copy address to clipboard.
3. Make wacht nu op een eerste bericht om de velden te bepalen. Laat het venster open, of klik later op Run once.
4. Open in Presentor Beheer, ga naar het tabblad Koppelingen en zoek Webhooks. Plak het adres, kies de gebeurtenis die je wilt ontvangen en klik op Koppeling toevoegen. Klik daarna bij de webhook op Test.
5. Make meldt dat de datastructuur is bepaald (Successfully determined). Wil je de velden van een echte gebeurtenis, klik dan in de module op Redetermine data structure, open een link van een presentatie in een privévenster en laat Make het bericht ontvangen.
6. Voeg de volgende module toe, bijvoorbeeld Google Sheets met Add a row. De velden van het bericht staan in de lijst; geneste velden staan onder elkaar. Koppel aan je kolommen onder meer created_at, data > deck > title, data > viewer > name en data > viewer > email.
7. Klik op Run once, open weer een link en kijk of er een rij in je Google Sheet komt. Zet het scenario daarna aan met de schakelaar.

Make leest de velden uit één voorbeeldbericht en kent daarna alleen die velden. Een andere gebeurtenis heeft andere velden, dus maak ook in Make per gebeurtenis een eigen webhook en scenario.

Voorbeeld met een notitie in je CRM, bij view.finished: zoek het contact op data > viewer > email en maak een notitie met de kijktijd (data > view > seconds), de presentatie en de slides waar het langst naar werd gekeken (data > view > top).

De negen gebeurtenissen

Per gebeurtenis staat hier wanneer die komt en hoe het bericht eruitziet. De voorbeelden volgen wat Presentor echt verstuurt; alleen de waarden zijn verzonnen. In alle berichten over een presentatie is workspace het merk, deck de presentatie en link de link die de kijker opende. Bij een openbare link is link.recipient null. Wat je met kijkcijfers doet, staat in de gids Weten of je presentatie is bekeken.

link.opened: iemand opent een link

Komt elke keer dat iemand een link van een presentatie opent en begint te kijken, ook bij een openbare link. Bewerkers die in de app kijken, tellen niet mee. De kijker is anoniem (name en email zijn null), tenzij de link om naam en e-mailadres vraagt of voor één ontvanger is gemaakt. viewer.forwarded is true als Presentor vermoedt dat de link is doorgestuurd.

{
  "id": "evt_x7k2m9qa3",
  "type": "link.opened",
  "created_at": "2026-10-26T09:14:22.418Z",
  "data": {
    "workspace": { "id": "ws_h4n8c2xpv", "name": "Studio Noord" },
    "deck": { "id": "dk_m3t7q9bw2", "title": "Voorstel website Vermeulen" },
    "link": {
      "id": "ln_Ab3dE5fGh7",
      "label": "Sanne de Vries",
      "recipient": "sanne@vermeulen.nl"
    },
    "viewer": {
      "name": "Sanne de Vries",
      "email": "sanne@vermeulen.nl",
      "device": "computer",
      "forwarded": false
    },
    "view": { "id": "vw_4k8m2x7q9c1d" }
  }
}

Kan null zijn: link.recipient, viewer.name, viewer.email.

link.forwarded: de link is doorgestuurd

Komt direct na link.opened, met precies dezelfde data, maar alleen als de kijker een ander e-mailadres invulde dan dat van de ontvanger van de link. Een andere browser alleen is geen reden: dan staat viewer.forwarded bij link.opened wel op true, maar komt er geen link.forwarded.

{
  "id": "evt_r5t9c4wby",
  "type": "link.forwarded",
  "created_at": "2026-10-26T11:40:08.653Z",
  "data": {
    "workspace": { "id": "ws_h4n8c2xpv", "name": "Studio Noord" },
    "deck": { "id": "dk_m3t7q9bw2", "title": "Voorstel website Vermeulen" },
    "link": {
      "id": "ln_Ab3dE5fGh7",
      "label": "Sanne de Vries",
      "recipient": "sanne@vermeulen.nl"
    },
    "viewer": {
      "name": "Mark Jansen",
      "email": "mark.jansen@vermeulen.nl",
      "device": "telefoon",
      "forwarded": true
    },
    "view": { "id": "vw_h7d2q5m8x3rn" }
  }
}

Kan null zijn: link.recipient, viewer.name.

link.stalled: een deal staat stil

Een link per ontvanger is stil gevallen: de ontvanger keek een tijd niet meer, of opende de link nooit. Presentor controleert dat elk kwartier. De drempel stel je in bij Beheer, onder Verkoop, Deal staat stil: na 3, 7 (standaard), 14 of 30 dagen, of uit. Per link komt dit één keer, tot de ontvanger weer kijkt. Het geldt voor links met een ontvanger die niet zijn ingetrokken of verlopen en die minder dan 120 dagen geleden zijn gemaakt.

{
  "id": "evt_k8w2f5ctm",
  "type": "link.stalled",
  "created_at": "2026-10-26T08:15:04.120Z",
  "data": {
    "workspace": { "id": "ws_h4n8c2xpv", "name": "Studio Noord" },
    "deck": { "id": "dk_m3t7q9bw2", "title": "Voorstel website Vermeulen" },
    "link": {
      "id": "ln_Ab3dE5fGh7",
      "label": "Sanne de Vries",
      "recipient": "sanne@vermeulen.nl"
    },
    "viewer": { "email": "sanne@vermeulen.nl", "name": "Sanne de Vries" },
    "stall": { "days": 7, "last_view": "2026-10-18 14:02:11", "views": 2 }
  }
}

stall.days telt vanaf de laatste keer kijken, of vanaf het maken van de link als de ontvanger nooit keek. stall.views is het aantal kijksessies. Kan null zijn: viewer.name en stall.last_view (nooit gekeken).

view.finished: een kijksessie is afgelopen

De kijker deed een half uur niets meer. Presentor controleert elk kwartier, dus het bericht komt een half tot driekwartier na de laatste activiteit. Het gaat om sessies via een link met minstens één seconde kijktijd, van de afgelopen dag, en per sessie komt het bericht één keer. Dit is het bericht voor een notitie in je CRM.

{
  "id": "evt_d6n3h9sqe",
  "type": "view.finished",
  "created_at": "2026-10-26T09:52:03.221Z",
  "data": {
    "workspace": { "id": "ws_h4n8c2xpv", "name": "Studio Noord" },
    "deck": { "id": "dk_m3t7q9bw2", "title": "Voorstel website Vermeulen" },
    "link": {
      "id": "ln_Ab3dE5fGh7",
      "label": "Sanne de Vries",
      "recipient": "sanne@vermeulen.nl"
    },
    "viewer": {
      "name": "Sanne de Vries",
      "email": "sanne@vermeulen.nl",
      "device": "computer",
      "forwarded": false
    },
    "view": {
      "id": "vw_4k8m2x7q9c1d",
      "seconds": 154,
      "furthest_slide": 6,
      "total_slides": 14,
      "seconds_per_slide": {
        "s_k2m8x4qw7": 18,
        "s_p9d3v6ht2": 41,
        "s_b5n7c2yr8": 74,
        "s_w3h6t9zc4": 12,
        "s_f8j2r5vn6": 9
      },
      "top": [
        { "title": "Investering", "seconds": 74 },
        { "title": "Planning en oplevering", "seconds": 41 },
        { "title": "Onze aanpak", "seconds": 18 }
      ],
      "started_at": "2026-10-26 09:14:22",
      "last_at": "2026-10-26 09:19:34"
    }
  }
}

seconds is de kijktijd in seconden. furthest_slide is het hoogste slidenummer (vanaf 1) dat in beeld kwam en total_slides het aantal slides dat de link laat zien. seconds_per_slide geeft de seconden per slide, met het id van de slide als sleutel. top zijn de drie slides waar het langst naar gekeken is (alleen slides met minstens 5 seconden), met de titel zoals de kijker die zag; de lijst kan leeg zijn. started_at en last_at zijn UTC. Kan null zijn: viewer.name, viewer.email.

action.created: een kijker doet iets op een actieslide

action.kind is afspraak (de kijker wil een gesprek plannen), akkoord (geeft akkoord), peiling (beantwoordt een vraag), download (haalt de pdf op) of offerte (stelt een offerte samen). Actieslides horen bij Team.

{
  "id": "evt_m4z7b2xjp",
  "type": "action.created",
  "created_at": "2026-10-26T09:17:45.372Z",
  "data": {
    "workspace": { "id": "ws_h4n8c2xpv", "name": "Studio Noord" },
    "deck": { "id": "dk_m3t7q9bw2", "title": "Voorstel website Vermeulen" },
    "link": {
      "id": "ln_Ab3dE5fGh7",
      "label": "Sanne de Vries",
      "recipient": "sanne@vermeulen.nl"
    },
    "action": {
      "kind": "akkoord",
      "slide": { "id": "s_c4v8n2kx5", "title": "Akkoord met het voorstel" },
      "choice": null,
      "label": null,
      "amount": null,
      "name": "Sanne de Vries",
      "email": "sanne@vermeulen.nl",
      "forwarded": false,
      "view_id": "vw_4k8m2x7q9c1d"
    }
  }
}

choice is bij een peiling het nummer van het gekozen antwoord (vanaf 0), anders null; label is dan de tekst van dat antwoord. Bij een offerte is label de keuze met het totaal en amount het totaal als getal in de eenheid van de slide (24400 is € 24.400, geen centen). Bij de andere soorten zijn label en amount null. Zo ziet action er bij een offerte uit:

{
  "action": {
    "kind": "offerte",
    "slide": { "id": "s_c4v8n2kx5", "title": "Akkoord met het voorstel" },
    "choice": null,
    "label": "Website, Onderhoud · € 24.400 exclusief btw",
    "amount": 24400,
    "name": "Sanne de Vries",
    "email": "sanne@vermeulen.nl",
    "forwarded": false,
    "view_id": "vw_4k8m2x7q9c1d"
  }
}

Kan null zijn: action.name, action.email, action.view_id (de kijksessie is niet bekend), link.recipient.

room.opened: een klant opent een ruimte

Een klant opent een ruimte. Een bewerker van het merk die de ruimte bekijkt, telt niet mee, en dezelfde browser binnen een half uur is hetzelfde bezoek. Ruimtes horen bij Team.

{
  "id": "evt_q9s5g3vyc",
  "type": "room.opened",
  "created_at": "2026-10-27T13:05:19.044Z",
  "data": {
    "workspace": { "id": "ws_h4n8c2xpv", "name": "Studio Noord" },
    "room": { "id": "rm_t6w3k9ydh", "title": "Samenwerking Vermeulen" },
    "viewer": { "name": "Sanne de Vries", "email": "sanne@vermeulen.nl" },
    "view": { "id": "rv_Kd83mPq2xZ" }
  }
}

Kan null zijn: viewer.name, viewer.email.

room.message: een klant stuurt een bericht

Een klant stuurt een vraag of bericht in de ruimte. message.body is de tekst, tot 2000 tekens.

{
  "id": "evt_t2c8x6hwa",
  "type": "room.message",
  "created_at": "2026-10-27T13:21:57.810Z",
  "data": {
    "workspace": { "id": "ws_h4n8c2xpv", "name": "Studio Noord" },
    "room": { "id": "rm_t6w3k9ydh", "title": "Samenwerking Vermeulen" },
    "message": {
      "id": "rb_q4m7x2ncv",
      "name": "Sanne de Vries",
      "email": "sanne@vermeulen.nl",
      "body": "Kunnen we donderdag bellen over de planning?"
    },
    "view": { "id": "rv_Kd83mPq2xZ" }
  }
}

Kan null zijn: message.email, view.id.

room.step: een klant vinkt een stap af

Een klant vinkt een eigen stap in de ruimte af. Het bericht komt op het moment dat een stap van niet af naar af gaat, niet bij een tweede klik op een stap die al af is.

{
  "id": "evt_w7j4n9fkr",
  "type": "room.step",
  "created_at": "2026-10-27T13:34:30.296Z",
  "data": {
    "workspace": { "id": "ws_h4n8c2xpv", "name": "Studio Noord" },
    "room": { "id": "rm_t6w3k9ydh", "title": "Samenwerking Vermeulen" },
    "step": {
      "id": "ri_h8d2f5kqw",
      "title": "Logo en huisstijlbestanden aanleveren"
    },
    "viewer": { "name": "Sanne de Vries", "email": "sanne@vermeulen.nl" },
    "view": { "id": "rv_Kd83mPq2xZ" }
  }
}

Kan null zijn: viewer.name, viewer.email, view.id.

stand.lead: een bezoeker laat gegevens achter

Een bezoeker van een beursstand laat zijn gegevens achter, op het scherm van de stand of via de QR-code op de eigen telefoon. lead.source is scherm of telefoon. De beursmodus hoort bij Enterprise.

{
  "id": "evt_b5v2m8drx",
  "type": "stand.lead",
  "created_at": "2026-10-28T15:48:12.503Z",
  "data": {
    "workspace": { "id": "ws_h4n8c2xpv", "name": "Studio Noord" },
    "stand": { "id": "st_c5r9v3mxa", "title": "Stand Dutch Design Week" },
    "lead": {
      "id": "sl_w2j6n8phq",
      "name": "Pieter Bakker",
      "email": "pieter@bakker-interieurbouw.nl",
      "company": "Bakker Interieurbouw",
      "question": "Kunnen jullie een demo geven voor ons team?",
      "item_id": "si_g7b4t2ndz",
      "item_title": "Productfilm 2026",
      "source": "telefoon"
    }
  }
}

Kan null zijn: lead.company, lead.question, lead.item_id, lead.item_title (de bezoeker koos geen onderdeel van de playlist).

De handtekening controleren

Presentor ondertekent elk bericht aan een gewone webhook. In de header Presentor-Signature staat t=<tijd>,v1=<handtekening>. De tijd is het aantal seconden sinds 1 januari 1970 (UTC). De handtekening is de HMAC-SHA256 van de tekst <tijd>.<body>, in hexadecimale vorm, met het geheim (whsec_) als sleutel. Jij rekent hetzelfde uit en vergelijkt.

• Neem de body precies zoals je die ontving. Wie de JSON eerst inleest en weer opmaakt, verandert spaties en volgorde, en dan klopt de handtekening niet.
• Vergelijk met een vergelijking van constante duur (in Node.js timingSafeEqual).
• Controleer ook de tijd. Weiger een bericht dat ouder is dan vijf minuten, zodat niemand een opgevangen bericht later opnieuw kan sturen.

const { createHmac, timingSafeEqual } = require('node:crypto');

// rawBody: de ontvangen tekst, ongewijzigd.
// header: de waarde van Presentor-Signature.
function checkPresentor(rawBody, header, secret) {
  const entries = String(header || '').split(',').map((p) => p.trim().split('='));
  const parts = Object.fromEntries(entries);
  if (!parts.t || !parts.v1) return false;
  // ouder dan 5 minuten: weigeren
  if (Math.abs(Date.now() / 1000 - Number(parts.t)) > 300) return false;
  const signed = parts.t + '.' + rawBody;
  const expected = createHmac('sha256', secret).update(signed).digest('hex');
  const a = Buffer.from(expected);
  const b = Buffer.from(parts.v1);
  return a.length === b.length && timingSafeEqual(a, b);
}

In een Express-server gebruik je het zo:

const express = require('express');
const app = express();
const SECRET = process.env.PRESENTOR_SECRET;

// express.raw, niet express.json: de handtekening gaat over de ongewijzigde tekst.
app.post('/presentor', express.raw({ type: 'application/json' }), (req, res) => {
  const raw = req.body.toString('utf8');
  const signature = req.get('Presentor-Signature');
  if (!checkPresentor(raw, signature, SECRET)) return res.sendStatus(401);
  const event = JSON.parse(raw);
  console.log(event.type, event.data.deck && event.data.deck.title);
  res.sendStatus(200); // snel antwoorden: Presentor wacht 5 seconden
});

In Zapier en Make kun je de controle overslaan, en de meeste mensen doen dat. Zeg het er dan wel eerlijk bij: het adres is dan de enige bescherming. Iedereen die het adres van je Zap of scenario kent, kan er berichten naartoe sturen die van Presentor lijken. Deel het adres dus met niemand. Bij twijfel maak je in Zapier of Make een nieuwe webhook (met een nieuw adres) en haal je de oude weg in Presentor.

Wil je wel controleren, laat dan een eigen server de handtekening nalopen en het bericht daarna doorsturen naar Zapier of Make. Zapier heeft ook de gebeurtenis Catch Raw Hook, die volgens Zapier de ongeparste body en de headers doorgeeft; daarmee kan een Code by Zapier-stap de handtekening in principe nalopen.

Grenzen

• Alleen https naar een openbaar adres. Een IP-adres, localhost, een intern netwerk, een eigen poort of een gebruikersnaam in het adres wordt geweigerd.
• Presentor wacht 5 seconden op antwoord. Zapier en Make bevestigen direct. Een eigen server antwoordt snel en doet het werk daarna.
• Presentor volgt geen doorverwijzingen. Een 301 of 302 telt als mislukt, dus gebruik het definitieve adres.
• Een bericht is gelukt bij een 2xx-status. Alles anders, ook geen antwoord, telt als mislukt. Presentor stuurt een bericht één keer en probeert het niet opnieuw.
• Na 20 mislukte berichten op rij gaat de webhook uit. Dat zie je in de lijst bij Webhooks. Een geslaagde test (knop Test) zet de webhook weer aan, en een gelukt bericht zet de teller weer op nul.
• Hoogstens 10 webhooks per merk of bedrijf, elk met een eigen adres en eigen gebeurtenissen.

Slack en Microsoft Teams krijgen geen JSON. Een adres op hooks.slack.com of op webhook.office.com, logic.azure.com, api.powerplatform.com of powerautomate.com herkent Presentor als Slack of Teams en stuurt daar één leesbare regel naartoe, zoals "Sanne opende je voorstel", zonder handtekening. Zapier en Make krijgen altijd de JSON. Wil je het JSON-bericht in Power Automate gebruiken, dan lukt dat dus niet rechtstreeks, omdat die adressen als Teams gelden.