Postbacks zijn geautomatiseerde meldingen die vanuit GelatoConnect naar externe systemen worden gestuurd wanneer een orderstatus verandert. Ze zijn essentieel om Print Service Providers (PSP's) en klanten in realtime op de hoogte te houden van hun bestellingen, zonder dat handmatige updates nodig zijn.
Postbacks stellen je in staat om:
Informeer klanten automatisch wanneer hun bestelstatus verandert (bijv. ontvangen, verzonden, afgeleverd).
Waarschuw je team over bestellingen die aandacht nodig hebben (mislukte bestellingen).
Werk je voorraadbeheersystemen bij wanneer bestellingen zijn voltooid.
Volg de voortgang van bestellingen gedurende je fulfilment workflow.
Deze meldingen kunnen worden afgeleverd via webhooks (URL) of e-mail, afhankelijk van je integratiebehoeften.
Vereisten voor het instellen van postbacks
Voordat je postbacks aanmaakt, zorg ervoor dat je beschikt over:
Klanten die notificaties zullen ontvangen worden geconfigureerd in het klantgedeelte van GelatoConnect.
URL-eindpunten zijn klaar om webhook-gegevens te ontvangen (als je de URL-bezorgmethode gebruikt).
Een basiskennis van sjablonen en triggers.
Bekendheid met de orderstatusstroom in GelatoConnect.
Stap-voor-stap handleiding voor het instellen van postbacks
1. Maak een postback-sjabloon
Templates bepalen de structuur en inhoud van je postback-meldingen. Je kunt ze op twee manieren maken:
Optie A: Via de sectie sjablonen
Navigeer naar Workflow > Order Intake > Templates
Klik op Sjabloon toevoegen
Selecteer het sjabloontype:
Trigger: Webhook - Voor het verzenden van JSON of XML gegevens naar externe systemen
Trigger: Email - Voor het versturen van e-mailnotificaties
Kies het juiste formaat (JSON of XML)
Optie B: Via het klantprofiel
Ga naar het profiel van je klant
Navigeer naar het tabblad Triggers en klik op Trigger toevoegen
Je kunt de template direct aanmaken binnen de trigger-instellingen
Voor gedetailleerde instructies over het maken van templates, zie Templates maken voor orderverwerking.
2. Configureer een trigger
Triggers bepalen wanneer postbacks worden verzonden en waar ze worden afgeleverd:
Geef je trigger een beschrijvende naam (bijv. \"Melding verzonden bestelling\")
Kies het moment waarop de trigger wordt geactiveerd:
Bestelling ontvangen
Bestelling mislukt
Order canceled
Bestelling geretourneerd
Bestelling geproduceerd
Bestelling afgeleverd
Bestelling verscheept
Bestelling onderweg
Kies je bezorgmethode:
URL (webhook): Verzendt gegevens naar een specifiek eindpunt
E-mail: Verstuurt meldingen via e-mail
Voor URL-levering, configureer:
De bestemmings-URL waar notificaties naartoe worden gestuurd
Stel de methode in op POST (aanbevolen)
Je kunt JSON of XML kiezen als gegevensformaat
Schakel \"Opnieuw proberen bij mislukking\" in voor betrouwbaarheid
Voor e-mailbezorging, configureer het e-mailadres van de ontvanger.
3. Voeg een sjabloon toe
Je sjabloon transformeert de interne gegevens van GelatoConnect naar een formaat dat bruikbaar is voor jouw systemen en die van je klanten.
Als er al een sjabloon is gemaakt, kun je dit selecteren tijdens het configureren van de trigger. Anders moet je een nieuw sjabloon maken.
Geef je sjabloon een duidelijke naam (bijv. \"OrderShippedNotification\")
Gebruik de voorbeeldgegevens die worden aangeboden voor je geselecteerde gebeurtenistype
Breng de invoergegevensvelden in kaart met je gewenste uitvoerformaat met behulp van de Template Mapper
Voorbeeldsjabloon voor het evenement "Order Shipped":
{ \"event\": \"Bestelling verzonden\", \"orderId\": \"##{{ orderId }}\", \"orderReferenceId\": \"##{{ orderReferenceId }}\", \"timestamp\": \"##{{ created }}\", "status": "##{{ fulfillmentStatus }}", \"trackingInfo\": { {% for item in items %} {% for fulfillment in item.fulfillments %} \"trackingCode\": \"##{{ fulfillment.trackingCode }}\", \"trackingUrl\": \"##{{ fulfillment.trackingUrl }}\", "carrier": "##{{ fulfillment.carrierName }}" {% endfor %} {% endfor %} }}Gebruik de \"Render\"-knop om een voorbeeld te zien van hoe je output eruit zal zien
Test het sjabloon om te controleren of het de verwachte output genereert
Voor meer voorbeelden van sjablonen, zie Voorbeelden van Sjabloonmapping.
4. Testen en activeren
Voordat je je postback live zet, stuur enkele tests om te controleren of alles werkt zoals verwacht. Daarna kun je de statussen van je trigger en template wijzigen naar actief.
Na het voltooien van deze stappen stuurt het systeem een postback naar de aangewezen URL of e-mailadres met de relevante bestelinformatie, elke keer dat de gespecificeerde bestelgebeurtenis plaatsvindt.
Geavanceerde postback-technieken
Lookups gebruiken in je sjablonen
Lookups zijn handig voor het koppelen van interne waarden aan klantvriendelijke formaten:
{% set carrier = lookups({\"shipmentMethodUid\": fulfillment.carrierUid}, strict=False, default=\"\") %}\"vervoerder\": \"##{{ carrier }}\"Dit zet interne GelatoConnect-codes om in meer betekenisvolle waarden voor je klanten. Meer informatie in Hoe je Lookups instelt.
Evenementspecifieke gegevensvelden
Verschillende evenementen bieden verschillende gegevensvelden. Hier zijn de belangrijkste velden die beschikbaar zijn voor veelvoorkomende evenementen:
Bestelling verzonden/afgeleverd: trackingcodes, vervoerdersinformatie, leveringsdata
Bestelling mislukt/geannuleerd: foutredenen, tijdstempels
Bestelling ontvangen: bestelgegevens, artikelinformatie
Voor een volledig begrip van deze velden, zie Introductie tot Template Mappers in GelatoConnect.
Problemen met postbacks oplossen
Als je postbacks niet werken zoals verwacht:
Controleer of de bestemmings-URL klopt en bereikbaar is
Controleer de sjabloonsyntax op fouten
Bevestig dat de trigger correct is geconfigureerd voor de juiste gebeurtenis
Zoek naar niet-overeenkomende gegevenstypen of ontbrekende velden
Test het sjabloon met voorbeeldgegevens voordat je het activeert
Specifiek voor e-mail postbacks:
Controleer of je SMTP-servergegevens correct zijn (indien geconfigureerd)
Controleer of het e-mailadres van de afzender correct is opgemaakt
Zorg ervoor dat je SMTP-server de verbinding van GelatoConnect toestaat
Controleer of de authenticatiegegevens (gebruikersnaam/wachtwoord) correct zijn
Voor uitgebreider advies over probleemoplossing, raadpleeg het gedeelte "Probleemoplossing" in Templates maken voor orderverwerking.
Je e-mailserver instellen voor postbacks
Als printserviceprovider kun je GelatoConnect configureren om e-mailpostbacks te versturen via je eigen e-mailserver. Dit betekent dat ontvangers e-mails zien die van jouw domein komen in plaats van van GelatoConnect, waardoor je merkidentiteit consistent blijft.
Om je e-mailserverinstellingen te configureren:
Navigeer naar het gedeelte Workflow in de linker zijbalk
Zoek de sectie Configuratie en selecteer Werkinstellingen
Zoek het gedeelte Instellingen voor uitgaande e-mailserver
Vul de volgende gegevens in:
E-mailadres afzender: Het e-mailadres dat zal verschijnen in het \"Van\" veld
Afzendernaam: De naam die naast het e-mailadres wordt weergegeven
SMTP-server: Het adres van je e-mailserver (bijv. smtp.jouwbedrijf.com)
SMTP-poort: De poort die je e-mailserver gebruikt (meestal 587 of 465)
SMTP-gebruikersnaam: De gebruikersnaam die je nodig hebt om in te loggen op je SMTP-server
SMTP-wachtwoord: Het wachtwoord voor je SMTP-server
Gebruik TLS: Schakel dit in als je SMTP-server TLS-encryptie vereist (aanbevolen)
Sla je configuratie op
Eenmaal geconfigureerd worden alle e-mail postbacks via uw e-mailserver verzonden, wat zorgt voor consistente branding en een verbeterde bezorging bij uw klanten.
Volgende stappen
Na het instellen van je postbacks:
Houd het succes van leveringen bij op de pagina Verzoeken binnen Orderinname.
Controleer bij je klanten of ze de meldingen correct ontvangen
Door een robuust postbacksysteem te implementeren, verbeter je de ervaring van je klanten met realtime orderupdates terwijl je handmatige communicatie vermindert.