Inhoudsopgave
Advertenties
Een webhookactie aan een toets toevoegen
Weet u hoe webhooks werken, en wilt u deze op uw apparaat gebruiken? De Chat-software biedt op de
volgende wijze ondersteuning voor webhooks: Voor dit gedeelte is kennis van de basisbegrippen met
betrekking tot webhooks en programmeervaardigheden vereist.
Belangrijk! U moet verbonden zijn met wifi om webhooks te kunnen gebruiken.
Gebruikte termen
Term
webhook
webhookservice/
-provider
webhookgebeurtenis
URL
nettolading
JSON
tijdelijke aanduiding
Gebruikershandleiding NovaChat
Betekenis
Een webhook is een gebeurtenis die een actie teweegbrengt.
Een webhookservice is een webapplicatie waarmee gegevens van een
bepaalde gebeurtenis worden opgehaald en opgeslagen.
Een webhookgebeurtenis is een webaanvraag via een URL. Deze kan
aanvullende informatie bevatten die de webhookservice/-provider nodig
heeft.
Een webhookgebeurtenis bestaat uit twee delen: (1) de URL en (2) de
nettolading in JSON-indeling. De gebeurtenis is het deel dat door de Chat-
software wordt verzonden.
Voorbeeld gebeurtenis: Een document aanmaken
Een URL is een websiteadres. Voor webhooks is een URL het adres dat
wordt verzonden om een gebeurtenis te activeren. Webhooks gebruiken
het http-protocol om met de webhookservice/-provider te communiceren.
Aanvullende instructies kunnen met de URL worden verzonden om de
gebeurtenis uit te voeren. Deze aanvullende instructies worden ook wel
nettolading genoemd.
Opmerking: Niet alle gebeurtenissen vereisen een nettolading.
Voorbeelden nettolading: Inhoud aan uw document toevoegen (raadpleeg
"webhookgebeurtenis hierboven"); de inhoud opmaken
De webhookservice/-provider bepaalt de nettolading. Dit is slechts een
klein deel van hoe een nettolading eruitziet als deze aan een
webhookservice wordt geleverd:
{
"event_id": "LtWXD3crgy",
"event_type": "form_response",
"form_response": {
"form_id": "lT4Z3j",
"token": "a3a12ec67a1365927098a606107fac15",
"submitted_at": "2018-01-18T18:17:02Z",
Webhooks moeten de responsen (nettoladingen) in JSON-indeling
aanleveren. Dit is een taal die door programmeurs wordt gebruikt. De Chat-
software biedt voor deze responsen een interface. Het voorbeeld onder
"nettolading" hierboven heeft een JSON-indeling.
Om het maken van nettoladingen te vergemakkelijken, beschikt de Chat-
software over twee tijdelijke aanduidingen: (1) De inhoud van de
spreekbalk en (2) de toetsboodschap (die in het vak Boodschap en niet in
het vak Label wordt weergegeven).
Tijdelijke aanduidingen dienen de volgende indelingen te hebben: ${SB} en
${BOODSCHAP}
De tijdelijke aanduidingen zijn niet vereist. U kunt ze allebei gebruiken, of
geen of een van de twee.
203
Advertenties
Inhoudsopgave
