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].

    Hey, our website uses cookies so that its all features can work properly.

    In addition to those necessary, we also use third-party cookies, so that we can use third-party analytics, social media or marketing tools. This means that the data collected through them is also processed by the providers of these tools.

    Do you consent to the use of cookies other than those necessary for the operation of the site as described by our privacy policy?

    Cookie settings

    Here you can change the detailed settings of the cookies used on our site. If you agree to particular type cookies, it means that you agree that the data collected by them will be used by the administrator of this site, as well as the provider of the specific tool we use - as described in our privacy policy.

    This type of files is necessary for the proper functioning of our site. They are used, among other things, for features such as the browser remembering the user's selected country, products in the shopping cart or the site's color theme.

    These files allow us to understand how users navigate our site. One such tool is Google Analytics, which allows us to collect anonymous information about the number of visits, use of specific features or type of user devices. Thanks to them, we are able to tailor the site to the needs and capabilities of diverse users.

    Tools from Google, Facebook and Seznam.cz that collect information about users that we are able to use for marketing purposes.