v3.23.1

Getting Started Devices Gateways Integrations Reference
Get The Things Stack

Integrations

    Overview
  • Adding Applications
  • Adding Integrations
  • Cloud Integrations
  • MQTT Server
  • Pub/Sub
  • LoRa Cloud
  • Node-RED
  • IFTTT
  • Payload Formatters
  • Storage Integration
  • Webhooks
    • Creating Webhooks
    • Scheduling Downlinks
    • Webhook Path Variables
    • Webhook Templates
    • Troubleshooting Webhooks

Troubleshooting Webhooks

This section provides help for common issues and frequently asked questions you may have when using Webhooks.

I see as.webhook.fail events in the Live data view. What does this mean?

When sending an uplink via Webhooks fails, The Things Stack generates a failure event as.webhook.fail. You can find out about the failure cause by observing the event details. The Things Stack will return the request body up to 1KB.

Besides the possibility that the Webhook integration might be misconfigured, the most common failure cause is that the user’s upstream endpoint cannot handle all uplinks received from The Things Stack fast enough, or cannot process the uplink message in 5 seconds (which is The Things Stack default timeout).

An example of a Webhook failure event is shown on the image below.

Webhook failure

The event details contain a detailed description of a failure cause:

"details":[
    {
        "@type": "type.googleapis.com/google.protobuf.Struct",
        "value": {
            "body": "{\"success\":false,\"error\":{\"message\":\"Alias ed2d46a2-00fc-4b2d-98f8-83a9fe7590c not found\",\"id\":null}}",
            "status_code": 404,
            "url": "https://webhook.site/ed2d46a2-00fc-4b2d-98f8-83a9fe7590c",
            "webhook_id": "test"
        }
    }
]

By inspecting details shown above, you can see that the Webhook failed with a status code 404, indicating that the configured BaseURL is not found. To avoid this error, always make sure to check if the upstream endpoint URL is accessible.

← Webhook Templates

On this page

  • I see as.webhook.fail events in the Live data view. What does this mean?

The Things Stack

Getting Started

Devices

Gateways

Integrations

Reference

Contributing

GitHub

Forum

About Us

The Things Network

The Things Industries

About this page

Last changed by Nejra Selimović on 14 Feb 2022.
doc: Update Webhooks documentation (#774)

Edit on Github