The following article will introduce you to the concept of webhooks and provide practical tips on how to use them for effective integration with Lockme.

    What is a Webhook?

    A webhook is a URL to which event information is sent. In the case of Lockme, these are booking events (adding, editing and deleting bookings). Detailed information about webhooks can be found in the following sources:

    How to create a webhook integration?

    The integration configuration has been placed in the Reservations tab, available in the company profile.

    1. Log in to the company profile.
    2. Then go to the "Integrations" tab and add a new integration.image
    3. Select the department to which the integration is to be assigned.
    4. Select a Webhook type integration from the available options.
    5. Define a custom name for this integration.
    6. Create the integration and move on.image
    7. Change the status of the integration to active (IMPORTANT: You cannot delete the integration, but you can activate or deactivate it).
    8. Decide on a specific API version. If in doubt, choose the latest version.
    9. Enter the Webhook URL and confirm the changes.image

    In what format are Lockme events sent?

    Lockme events are sent as a POST request to the address defined for the webhook. The body of the request is empty, and the headers include:

    • User-Agent with the value LockMe/1.0
    • X-MessageId containing the message identifier.

    How to read the message details?

    Retrieve the message details using our API by sending a request GET /message/{messageid}, where messageid is the message ID from the headers. After handling the event on your side, you should mark the message as read by sending a request POST /message/{messageid}. Otherwise, the message of the same event will be repeated for 24 hours in increasing intervals.

    What is worth remembering?

    • Always read the API documentation carefully for details about the expected data format and other requirements.
    • Be prepared for potential errors, such as network connection problems, incorrect data format or authorization errors.
    • Regularly monitor the performance of webhooks to detect potential problems and ensure the reliability of the integration.

    Not all clear?

    Contact us: [email protected].

    Hej, vår webbplats använder cookies för att alla funktioner ska fungera korrekt.

    Utöver dessa nödvändiga cookies använder vi även cookies från tredje part för att kunna använda tredje parts analys-, sociala medie- och marknadsföringsverktyg. Detta innebär att de uppgifter som samlas in genom dem också behandlas av leverantörerna av dessa verktyg.

    Godkänner du att vi använder andra cookies än de som är nödvändiga för driften av webbplatsen enligt vår sekretesspolicy?

    Inställningar för cookies

    Här kan du ändra de detaljerade inställningarna för de cookies som används på vår webbplats. Om du godkänner cookies av en viss typ innebär det att du godkänner att de uppgifter som samlas in av dem kommer att användas av administratören av den här webbplatsen och av leverantören av det specifika verktyg som vi använder - enligt beskrivningen i vår sekretesspolicy.

    Denna typ av filer är nödvändiga för att vår webbplats ska fungera korrekt. De används bland annat för funktioner som att webbläsaren kommer ihåg det land som användaren har valt, produkter i kundvagnen eller webbplatsens färgtema.

    Dessa filer gör det möjligt för oss att förstå hur användarna navigerar på vår webbplats. Ett sådant verktyg är Google Analytics, som gör det möjligt för oss att samla in anonym information om antalet besök, användningen av specifika funktioner eller typen av användarens enheter. Tack vare dem kan vi anpassa webbplatsen till olika användares behov och möjligheter.

    Verktyg från Google, Facebook och Seznam.cz som samlar in information om användare som vi kan använda för marknadsföringsändamål.