Samenvatting
In dit artikel lees je wat het veld Webhook-URL doet en waar het staat. Je leest wat er bij het publiceren verandert zodra dat veld een adres bevat.
Je vindt er ook welke zeven gegevens Mach3Blocks naar jouw adres stuurt, en hoe lang het bestand blijft bestaan. Verder lees je wat er in Mach3Blocks juist niet verandert.
Wanneer gebruik je dit?
Je gebruikt de webhook als je de publicatie wilt afvangen in een ander systeem. Mach3Blocks maakt dan een bestand met de hele website en meldt waar dat staat.
Dat is handig als je de website elders host. Het is ook handig als je de publicatie in een eigen proces wilt opnemen, bijvoorbeeld met Zapier.
Let op het verschil met het doorsturen van een formulierinzending. Dat is een andere functie, met een ander bericht en een eigen adres bij de formulierinstellingen.
Wil je de website gewoon live zetten, laat het veld dan leeg. Wil je de website eenmalig als bestand ophalen, gebruik dan Website downloaden.
Hoe werkt dit in Mach3Blocks?
Waar je het adres invult
Het veld Webhook-URL staat op het tabblad Geavanceerd van de website-instellingen. Het is een gewoon tekstveld.
Onder het veld staat een veldmelding met een korte toelichting. Die tekst noemt ook de bewaartijd van het bestand.
Wat er bij publiceren gebeurt
Zodra het veld een adres bevat, gaat de knop Publiceren een andere kant op. De knop zelf en de titel van de pop-in blijven hetzelfde.
| Onderdeel | Wat het doet | Bijzonderheden |
|---|---|---|
| Het veld Webhook-URL | Bepaalt of de knop naar jouw adres publiceert | vraagt geen recht. Wordt alleen op de vorm van een adres gecontroleerd, niet op het bestaan ervan |
| De pop-in | Toont een bevestiging met jouw adres en de knop Publiceren | geen veld en geen vinkje. Gebruikt een pagina Google Maps zonder sleutel, dan staat die waarschuwing erboven |
| Het bestand | De hele website wordt opgebouwd en ingepakt als een ZIP-bestand | de bestandsnaam bevat een unieke sleutel van zestien tekens |
| Het bericht | Een POST naar jouw adres, met zeven gegevens erin | |
| De uitkomst | Antwoordt jouw adres met een code in de 200-reeks, dan is het gelukt | ook 201 of 204 is dus goed |
| De melding | Een groene melding met jouw adres erin als link | bij een andere code lees je "De POST naar de webhook-URL is mislukt." |
Het bestand blijft tussen de 1 en 2 uur bestaan. Daarna is het weg, en dan moet je opnieuw publiceren om er weer bij te komen.
Wat er in het bericht staat
Het bericht is een POST met zeven velden. Hieronder staat per veld wat erin staat.
| Veld | Wat erin staat |
|---|---|
| account | De naam van het account |
| website | De naam van de website |
| domain_name | De domeinnaam van de website |
| publication_file | Het volledige adres van het ZIP-bestand |
| published_until | Het moment waarop het bestand vervalt |
| published_at | Het moment van publiceren |
| published_by | De naam van degene die publiceerde |
De domeinnaam gaat dus wel mee in het bericht. Hij wordt alleen niet gebruikt, want er komt geen live website op dat adres.
Wat je ermee kunt
Je zet de webhook in twee handelingen aan. Daarna gaat elke publicatie vanuit de topbalk naar jouw adres.
- Vul het veld Webhook-URL in en sla de instellingen op.
- Klik op Publiceren en bevestig in de pop-in.
Wat jouw systeem daarna doet, bepaal je zelf. Het haalt het bestand op zolang dat er staat, en verwerkt de website verder.
Zo zet je de website op je eigen hosting neer. Je kunt het bestand ook bewaren als vaste kopie van een opgeleverde versie.
Een koppelplatform als Zapier kan het bericht net zo goed opvangen. Van daaruit geef je de gegevens door aan het systeem dat jij gebruikt.
Grenzen en wat niet kan
Mach3Blocks zet de website bij deze route niet live. Er komt geen publicatie op de publicatieserver te staan, en er gaat geen mail uit.
De status in het websiteoverzicht verandert ook niet. Staat er Concept, dan blijft dat staan, ook na tien geslaagde publicaties naar de webhook.
In de interface zie je nergens terug dat er naar de webhook is gepubliceerd. Het tabblad Informatie krijgt geen extra regel en het overzicht geen badge.
Wil je weten of het gelukt is, dan lees je de melding in de pop-in. Daarna kun je het alleen nog in je eigen systeem nakijken.
De knop Publiceren in de editor volgt deze instelling niet. Vanuit de editor wordt de website wel gewoon live gezet.
Bij een website in een presentatiegroep bestaat het veld niet. Het tabblad Geavanceerd is daar weggehaald.
Voorwaarden en rechten
Voor het veld zelf is geen recht nodig. Wie de instellingen van de website kan openen, kan het adres invullen.
Publiceren vraagt wel het recht Publiceren. Ook op deze route heeft de website een websitepakket nodig waarin publiceren zit.
Praktijkvoorbeelden
Je bouwt een website in Mach3Blocks, maar de klant host zelf. Je vult het adres van je eigen server in bij de webhook. Bij elke publicatie ontvangt die server het bericht, haalt het bestand op en zet de nieuwe versie klaar.
Je wilt van elke oplevering een vaste kopie bewaren. Je koppelt een adres van Zapier aan de website. Bij elke publicatie legt Zapier het bericht vast en zet het bestand in je eigen opslag.