Skip to main content

Using Webhooks

A guide for developers and administrators on how to use webhooks to send real-time Mero event data to external applications.

Updated over 2 weeks ago

Webhooks are a powerful tool for advanced users who want to integrate Mero data with other systems, such as custom dashboards, internal ticketing systems, or communication platforms like Slack. A webhook will automatically send a message with event data to a URL you specify whenever that event occurs in Mero.

Note: Setting up webhooks typically requires technical knowledge and a server endpoint capable of receiving HTTP POST requests.

1. How to Configure a Webhook

  1. Navigate to Settings in the bottom-left menu.

  2. Select the Webhooks tab.

  3. Click Add Endpoint to create a new webhook.

  4. Configure the endpoint settings:

    • Endpoint URL: This is the most important field. Enter the URL of the external application that will receive the data from Mero.

    • Event Types: Select which Mero events you want to subscribe to. When one of these events happens, Mero will send a notification to your endpoint. Examples include:

      • station_offline

      • sensor_empty

      • shift_ended

    • Advanced Configuration: For integrations that require specific formatting, you can add custom HTTP headers (e.g., for passing authentication tokens).

    • Signing Secret: For enhanced security, Mero provides a signing secret. You can use this on your server to verify that incoming webhook requests are genuinely from Mero and have not been tampered with.

  5. Click Save to activate the webhook.

2. How Webhooks Work

Once saved, the webhook is active. When a subscribed event occurs (for example, a base station goes offline), Mero will immediately send an HTTP POST request to the endpoint URL you provided. The body of this request will be a JSON payload containing details about the event, such as the event type, a message ID, and relevant data about the device or cleaner involved.

Your application can then parse this JSON data and trigger its own workflows, allowing for seamless integration and automation between Mero and your other business systems.

3. Special Integrations: Slack & Zapier

In addition to standard webhooks, Mero offers streamlined integrations with popular platforms to enhance your workflows.

  • Slack/Teams Integration: Turn your Mero notifications directly into a Slack/Teams bot, delivering real-time alerts straight to your team's channels for immediate visibility and response.

  • Zapier Integration: Connect Mero to thousands of other applications by integrating webhooks with Zapier. This allows for limitless automation possibilities, linking your Mero data to project management tools, spreadsheets, and more.

Important: To enable either the Slack or Zapier integration for your organization, please contact Mero Support.

Did this answer your question?