Webhooks and event queue
Purpose
A webhook is a signed HTTP request Open Play sends to your own server when an event happens. This page shows the registered endpoints, the attempts to send each event to an endpoint, and the event queue (outbox) waiting to be sent. The page is read-only: there is no button in the panel to add or delete an endpoint, resend a failed delivery or see the secret. Endpoints are registered over REST; for details, see the Webhooks guide.
When to use
- To verify that your server is receiving webhooks.
- To understand why an event did not arrive (is it waiting, did it fail, which error).
- To see whether an endpoint is enabled and which event types it listens to.
Note
If the webhooks module is disabled, the webhook endpoints do not respond (
404,module_disabled). Enable the module on the Game settings › Modules page. To see the page, your role also needs webhook read permission.
Step by step
- Make sure you selected the right game and environment.
- In the “Webhook endpoints” table, check your endpoint’s address (URL), the event types it listens to and its status. If the filter is empty, it says “tümü” (all), which means the endpoint receives all events.
- In the “Delivery attempts / DLQ” table, filter deliveries by status. Those that are failed have used up their retries (DLQ, dead letter queue).
- In the “Hata” (Error) column you see the class of the error and, if there is one, the HTTP code your server returned. The raw error text is not shown.
- In the “Outbox” table you see the events waiting to be sent or being attempted.
- Press Yenile (Refresh) to see new data.
Fields and options
There is no form to fill in on this page.
Tables
| Table | Columns |
|---|---|
| Webhook endpoints | URL, Event filtreleri (Event filters), Durum (Status; enabled or disabled), Oluşturulma (Created); the Endpoint kimliği (Endpoint ID) column is turned on from the column menu |
| Delivery attempts / DLQ | Endpoint (URL, delivery ID and event ID), Durum (Status; pending, delivered, failed), Attempt (the number of attempts), Hata (Error), Oluşturma (Created), Teslim (Delivered); the delivery order and outbox ID columns are turned on from the column menu |
| Outbox | Event (the type and the event ID), Durum (Status), Attempt, Retry (the time of the next attempt), Oluşturma (Created) |
For a published (completed) outbox record, the next attempt time shows “—”. If the event type is a hidden internal event, it says “redacted/private”. The panel never shows secrets, the raw body or the raw error text.
Common situations
| Situation | What to do |
|---|---|
| It says “Webhook yüzeyi yetki gerektiriyor” (The webhook surface needs permission) | Your role has no webhook read permission; ask an admin. |
| The tables are empty | You may not have registered an endpoint yet; also check that you selected the right environment. |
| A delivery is “failed” | Your server is not returning 2xx or cannot be reached. Look at the class and code in the Hata column; fix your receiver. There is no resend from the panel. |
| The same event arrived more than once | Delivery happens at least once; your receiver should drop repeats by the event ID. For details, see the guide. |
| I cannot see an endpoint’s secret | The secret comes back only once, in the registration response; it is not shown anywhere afterwards. To renew it, delete the endpoint and register it again. |