Webhooks URL Configuration

Webhooks enable Glassix to communicate with your systems

Prerequisites:

  • Log into a Glassix account
  • Expose a public HTTPS endpoint to receive events

Webhooks

Webhooks allow actions in our system, e.g.:

  • Ticket documentation.
  • A new Ticket
    etc., to be communicated to your system.

If you can't support webhooks, an alternative method of polling may be applied.

Define a Webhook URL

  1. Go to Settings.

    Click on the symbol in the agent dashboard.

  2. In the Developers section, click on Webhooks.
  3. Click on New WebhookPOST request.
  4. In the Target text box, type <Your HTTPS Endpoint>.

  1. Use the checkbox to choose one or more desired Events.
  2. Click Save.

👍

When an event occurs in our system, a POST request containing all the relevant data will be sent to your URL.

🚧

Note:

Requests timeout after 20 seconds.

📘

Tip:

While testing, you can use ngrok to temporarily allow requests from Glassix to tunnel to a localhost port on your computer.

A simpler way is to use webhook.site to inspect and debug webhook requests.

Response

We expect a successful status code response (200–299). Until then, we'll keep the event in the queue for up to 3 days (while trying to send the event in increasing intervals).

Webhook Validation

We strongly advise validating that Glassix sent the data received via webhooks before digesting the request. Such validation is crucial for securing data and protecting your systems and servers from abuse.
Dedicated custom request headers can be added manually as an additional layer of precaution.
Further info regarding webhooks validation customer request headers can be found here.

Polling

If you can't set an endpoint to receive the events via webhooks, you can use long polling to get the events. This is useful when your servers can't be exposed to incoming requests.

See more polling information.

Define Polling

  1. Go to Settings.

    Click on the symbol in the agent dashboard.

  2. In the Developers section, click on Webhooks].
  3. Click on New WebhookPolling.
  4. In the Name text box, type a name for your polling.

  1. Choose desired Events.
  2. Click Save.