How to configure the custom webhook timeout for Voice API functionality and what are the allowed timeout ranges ? How to configure the custom webhook timeout for Voice API functionality and what are the allowed timeout ranges ?

How to configure the custom webhook timeout for Voice API functionality and what are the allowed timeout ranges ?

Vonage API Support

Question

How do I configure the custom webhook timeout for Voice API functionality, and what are the allowed timeout ranges?

Applies To

  • Voice API 
  • Webhooks

Answer

You can configure the custom webhook timeout for Voice API functionality in your Vonage API Dashboard.

Go to Your Applications section > Click on your Voice application > Click on Edit > Scroll down to Capabilities > Voice > Click on Show Advance Settings > Custom webhook timeouts. 

Screenshot 2024-12-18 at 4.57.57 PM.png

When configuring your application settings for voice capability, please note the following timeout range for the webhook.

Connection Timeout:

  • For all three categories, you can set a minimum of 300 milliseconds and a maximum of 1000 milliseconds.

Socket Timeout:

  • Answer and Fallback: You can set a minimum of 1000 milliseconds and a maximum of 5000 milliseconds.
  • Event: You can set a minimum of 1000 milliseconds and a maximum of 10000 milliseconds.

Additional Information

Please refer to our developer docs for details on the default webhook timeout values: https://developer.vonage.com/en/application/technical-details#webhook-timeouts