Questo articolo spiega come creare un Webhook nella Dashboard di Aircall, consentendoti di ricevere gli eventi di Aircall in un sistema esterno a tua scelta.

Passaggi:

  1. Accedi a Dashboard di Aircall > Integrazioni > Webhook
  2. Fai clic sul pulsante verde Aggiungi Webhook e seleziona Installa Webhook
  3. Configura le impostazioni del Webhook:
  • Personalizza il nome del Webhook.
  • Aggiungi l'URL su cui desideri ricevere gli eventi Webhook di Aircall.
  • Seleziona gli eventi Webhook che desideri ricevere. Tutti gli eventi sono abilitati per impostazione predefinita. Per ulteriori informazioni sull'utilizzo dei Webhook e sugli eventi disponibili, consulta la documentazione relativa ai Webhook.
Screenshot 2026-04-08 at 6.35.21 PM.png
  1. Fai clic su Aggiungi Webhook per completare la creazione del Webhook.
Nota: Una volta creato il Webhook, Aircall inizia a inviare gli eventi all'URL configurato in base agli eventi selezionati.

Risoluzione dei problemi relativi ai Webhook

Errore del Webhook: "timeout of 5000ms exceeded"

Sintomo

Ricevi la seguente risposta di errore, che indica un malfunzionamento del Webhook:

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

Causa

Aircall invia richieste HTTP a server web esterni con un timeout impostato su 5 secondi. Una richiesta Webhook viene considerata non riuscita se si verifica una delle seguenti condizioni:

  • Il server ricevente non risponde entro 5 secondi.
  • Il server risponde con un codice di stato HTTP che non rientra nell'intervallo 2XX.

Risoluzione

Assicurati che il server risponda rapidamente e correttamente alle richieste Webhook.

  1. Controlla l'endpoint del Webhook per verificare che possa elaborare le richieste in modo efficiente.
  2. Assicurati che l'endpoint restituisca un codice di stato HTTP 200.
  3. Verifica che la risposta venga inviata entro 5 secondi dalla ricezione della richiesta.
Importante: Se il server non restituisce un codice di stato HTTP 2XX entro 5 secondi, la richiesta Webhook viene contrassegnata come non riuscita e potrebbe essere disattivata.

Ottimizzando i tempi di risposta e garantendo una risposta HTTP corretta, puoi evitare malfunzionamenti dei Webhook e mantenere integrazioni affidabili con Aircall.