Creating a Webhook in the Aircall Dashboard

This article explains how to create a Webhook in the Aircall Dashboard, allowing you to receive Aircall events in an external system of your choice.

Steps:

1. Log to Aircall Dashboard > Integrations & API
2. In search bar and type "Webhook"

3. Scroll down and select Webhook.
4. Click Install integration.

5. Configure your Webhook settings:
   • Customize your webhook name.
   • Add the URL where you want to receive Aircall Webhook events.
   • Select the webhook events you want to receive. All events are enabled by default. For more information about webhook usage and available events, refer to the Webhook documentation.

6. Click Add Webhook to complete the creation of your Webhook.

Note: Once the Webhook is created, Aircall starts sending events to the configured URL based on the events you selected.

Webhook troubleshooting

Webhook error: "timeout of 5000ms exceeded"

Symptom

You receive the following error response indicating a webhook failure:

{
  "status": "{\"message\":\"timeout of 5000ms exceeded\",\"name\":\"AxiosError\",\"stack\":\"AxiosError: timeout of 5000ms e…\"}
}

Cause

Aircall sends HTTP requests to external web servers with a timeout set to 5 seconds. A webhook request is considered failed if either of the following occurs:

• The receiving server does not respond within 5 seconds.
• The server responds with an HTTP status code that is not in the 2XX range.

Resolution

Ensure that your server responds quickly and correctly to webhook requests.

1. Review your webhook endpoint to confirm it can process requests efficiently.
2. Make sure the endpoint returns an HTTP 200 status code.
3. Verify that the response is sent within 5 seconds of receiving the request.

Important: If your server does not return a 2XX HTTP status code within 5 seconds, the webhook request is marked as failed and may be deactivated.

By optimizing response time and ensuring a successful HTTP response, you can prevent webhook failures and maintain reliable integrations with Aircall.