Skip to main content
A Wakeup Call automatically triggers an action when the user has been inactive for a specified period of time. Instead of leaving a silent gap when the caller goes quiet, the agent can gently check in, re-prompt, or offer help, keeping the conversation alive and maintaining engagement.

How it works

Set wake_up on your Agent to the number of seconds of caller silence to allow before nudging. When the caller stays quiet for that long, the runtime calls your agent’s on_wake_up method, where you decide what happens next.
Track state across nudges (like the _nudges counter above) to escalate your response — for example, offer more help on the first nudge and end the call after several unanswered check-ins.

Configuration Options

int
default:"0"
Set on the Agent. Seconds of caller silence to allow before triggering on_wake_up. 0 disables wake-up calls; a negative value is rejected.

Callback

async method
Override this method on your Agent to define the wake-up action. The runtime calls it each time the caller stays silent for wake_up seconds.

References

Examples

Wakeup Call

Checkout the full implementation on GitHub