diff --git a/fern/server-url/events.mdx b/fern/server-url/events.mdx index 98761bdfb..4f4fa615c 100644 --- a/fern/server-url/events.mdx +++ b/fern/server-url/events.mdx @@ -113,6 +113,14 @@ For inbound phone calls, you can specify the assistant dynamically. If a PhoneNu } ``` + + You must respond to the `assistant-request` webhook within 7.5 seconds end-to-end. This limit is fixed and not configurable: the telephony provider enforces a 15-second cap, and Vapi reserves ~7.5 seconds for call setup. The timeout value shown elsewhere in the dashboard does not apply to this webhook. + + To avoid timeouts: + - Return quickly with an existing assistantId or a minimal assistant, then enrich context asynchronously after the call starts using Live Call Control. + - Host your webhook close to us-west-2 to reduce latency, and target < ~6s to allow for network jitter. + + Respond with either an existing assistant ID, a transient assistant, or transfer destination: ```json