diff --git a/src/pages/docs/platform/integrations/webhooks/index.mdx b/src/pages/docs/platform/integrations/webhooks/index.mdx index d0b7247b48..2faa5749c0 100644 --- a/src/pages/docs/platform/integrations/webhooks/index.mdx +++ b/src/pages/docs/platform/integrations/webhooks/index.mdx @@ -497,6 +497,8 @@ The following steps are required to verify the signature: If you choose to sign your webhook requests, it is recommended that you try the following: -1. Set up a free [`RequestBin`](https://requestbin.com/) HTTP endpoint test URL. -2. [Configure](#configure) a webhook with the URL set to the `RequestBin` endpoint. Make sure you choose to [batched](#batched) messages and use a key to sign each webhook request. -3. Trigger an event using the Dev Console in your app [dashboard](https://ably.com/dashboard/any). This will generate a webhook. Then confirm that RequestBin received the webhook. +1. Set up your webhook testing/inspection tools: + - **Local testing/inspection**: Perform local tunneling with [ngrok](https://ngrok.com/download/linux), paired with [webhook-tester](https://github.com/tarampampam/webhook-tester). You can install webhook-tester [here](https://github.com/tarampampam/webhook-tester?tab=readme-ov-file#-installation). The ngrok CLI tool will generate your **webhook listener URL**. + - **Using zero-setup, cloud-based, webhook testing services**: Services like Beeceptor (https://beeceptor.com/webhook-integration/) or Webhook.site (https://webhook.site/) offer a zero-setup, no-login, free webhook testing endpoint for webhook monitoring, payload inspection and signature verification. These services provide you a unique, random endpoint URL, which is your **webhook listener URL**. +2. [Configure](#configure) your webhook sender (Ably) with the webhook listener URL obtained from **Step 1**. Make sure you choose to [batch](#batched) messages and use a key to sign each webhook request. +3. Trigger an event using the Dev Console in your app [dashboard](https://ably.com/dashboard/any). This will send a webhook event to your webhook testing/inspection tool via the webhook listener URL. You can, using your preferred choice of webhook testing/inspection tool, monitor requests and confirm that a webhook request was sent, and inspect request headers for signature verification.