Static Documentation

Voice Call Channel

Version latest · Updated 2026-08-17
Interactive docs View on GitHub

Voice call channel#

Voice call is an outgoing notification channel. It calls the assigned user's profile phone number through the globally configured voice provider.

Delivery model#

Alert assignee -> assignee.phone -> configured voice provider

Required data:

LocationRequired value
User profilephone
Global config[voice] provider settings
Voice channel configoptional channel policy and severity filter

Global voice config#

[voice]
provider = stub
providers_dir = /usr/local/lib/incidentrelay/voice_providers
callback_secret =

Custom providers are documented in Voice Providers.

Severity filter#

Use the common channel severity filter:

{
  "notify_on_severities": ["critical"]
}

Do not use channel-specific severity keys.

DTMF actions#

A custom provider can support DTMF actions for ACK/Resolve flows. See:

Test button#

The channel test uses the current user's profile phone number.

Real alert delivery uses the assigned user's profile phone number.