Why are you receiving webhook failure alerts?

Raquel Updated by Raquel

At Turn.io, we strive to provide a seamless and reliable messaging experience for our customers. As part of this commitment, we have introduced Webhook Failure Alerts—to notify you when there are issues with your webhook endpoint.

Webhooks allow Turn.io to send real-time updates to your system. However, for this process to work smoothly, your webhook endpoint must:

  1. Be online and responsive
  2. Acknowledge the incoming data from Turn.io within 5 seconds
  3. Return a 200-level HTTP status code (indicating successful receipt)

If your webhook fails to meet these criteria, Turn.io retries delivery for a limited period.

However, persistent failures lead to automatic webhook deactivation, and that’s when you receive an alert.
Common Reasons for Webhook Failures
  • Time-Out Issues: Your webhook is taking too long to process requests (exceeding the 5-second limit)
  • Invalid Response Codes: Your system is returning an error (4xx or 5xx status codes) instead of a success response.
  • Unreachable Endpoint: Your webhook server is down or experiencing network issues.
  • Rate Limiting or Overloaded Servers: If your system is throttling or struggling with high traffic, it may reject or delay webhook responses.
How This Impacts Your Service

When a webhook consistently fails:

  1. Messages may not be delivered to your system.
  2. Your webhook may be automatically disabled, stopping all real-time updates.
  3. Users relying on timely responses may experience delays or missing data.
How to Fix Webhook Failures
  • Check Your Logs: Review your server logs to identify and troubleshoot errors.
  • Optimize Response Time: If your webhook processes data before responding, consider queuing the data first and then responding within the 5-second limit.
  • Ensure Your Server is Always Online: Make sure your webhook is deployed on a stable and scalable infrastructure.
  • Monitor Webhook Status: Regularly check logs in Turn.io or your monitoring system to detect failures early.

Was this article helpful?

Getting Suggested Replies with ChatGPT

API calls returns 200 status for messages outside the Conversation Windows

Contact