Hoe webhooks configureren om op de hoogte gebracht te worden van nieuwe PDF-formulierinzendingen

Benjamin André-Micolon

Een krachtige manier om de inzendingen naar uw applicatie te sturen of SimplePDF te verbinden met andere diensten zoals Zapier of Activepieces is het gebruik van webhooks.

Webhooks?

Webhooks maken het mogelijk om applicaties met elkaar te verbinden door gegevens in realtime van de ene applicatie naar de andere(n) te sturen wanneer een bepaalde gebeurtenis plaatsvindt.

In SimplePDF wordt elke keer dat een PDF wordt ingediend via uw bedrijfsportaal, hetzij via formulierlinks of integratie in uw website, een gebeurtenis verstuurd met onder andere de documentnaam en inzendings-URL.

Vanaf daar zijn de mogelijkheden eindeloos en kunt u uw fantasie de vrije loop laten.

U zou bijvoorbeeld die informatie in een Google Sheet kunnen opslaan of het integreren met Zapier of Activepieces en nog meer mogelijkheden ontsluiten!

Webhooks configureren in SimplePDF

Webhooks configureren is beschikbaar met het BASIC-abonnement

Log in op uw account
Navigeer naar de accountinstellingen

Webhooks configureren in de accountweergave

Klik op Configuratie bijwerken
Voer de webhook-URL in van de dienst of applicatie waarnaar u gebeurtenissen wilt sturen

Webhooks configureren: configuratiegegevens

Optioneel: geef de headers op die als onderdeel van de webhook moeten worden meegestuurd

Dat is het! Er wordt een gebeurtenis verstuurd bij elke nieuwe inzending

Webhook-gebeurtenissen

Hieronder vindt u de gebeurtenissen die door SimplePDF naar de door u geconfigureerde webhook worden verstuurd.

Nieuwe inzending

Payload

type: "submission.created",
data: {
  document: {
    id: "b7615a68-9e1f-4eac-bd20-5e80632a4d9e",
    name: "your_document.pdf",
  },
  submission: {
    id: "80146d5b-a068-490f-8eb9-fe393ba11396",
    submitted_at: "2023-06-04T11:54:58.995Z",
    url: "short_lived_15min_url",
  },
  context: {
    environment: "production",
    customer_id: "123"
  }
}

Over de context

Wanneer u SimplePDF integreert in uw website, wilt u mogelijk aanvullende informatie koppelen aan inzendingen.

U wilt bijvoorbeeld:

Weten of de inzending is gestart vanuit een ontwikkel-environment versus een production-omgeving.
Aanvullende gegevens sturen over wie het formulier heeft ingediend (zoals een ingelogde gebruiker) wat het voor u makkelijker maakt om de inzending te verwerken.

Leer hoe u een context opgeeft in de documentatie van SimplePDF embed

Playground

We houden van voorbeelden bij SimplePDF, dus wat dacht u van een praktijkvoorbeeld van hoe webhooks eruit zien?

Wijzig de context hieronder (klik om de inhoud te bewerken)

{"environment":"production","customer_id":"123"}

Dien dit formulier in
De webhook die door SimplePDF is verstuurd verschijnt hier