Skip to main content

Contacts

Contacts directory — name, email, phone numbers, per-contact webhook URLs, and notes for alert recipients

Contacts are the people and groups who receive alert notifications. A contact record stores a person's name, email addresses, phone numbers, and per-contact webhook URLs — providing a central directory that escalation teams and on-call rotations can reference.


Creating Contacts

Navigate to Alerting → Contacts and click Add Contact.

FieldRequiredDescription
NameYesFull name of the contact
EmailNoEmail address for notifications
PhoneNoPrimary phone number for SMS and voice notifications. Use E.164 format (e.g., +18005551234). Stratora does not enforce format on save; malformed numbers fail at delivery time and surface in the alert's notification history.
MobileNoMobile phone number, distinct from Phone. When both are set, escalation rotation members can be configured per-step to dispatch SMS / Voice to either Phone or Mobile. Same E.164 guidance applies.
Slack Webhook URLNoPer-contact Slack incoming webhook URL. Used when an escalation step targets this contact on the Slack channel.
Teams Webhook URLNoPer-contact Microsoft Teams incoming webhook URL. Used when an escalation step targets this contact on the Teams channel.
Webhook URLNoGeneric-webhook URL for this contact. Distinct from Slack / Teams webhooks; used by the Generic Webhook channel only.
NotesNoFree-text notes about the contact's role or responsibilities

Contact Sources

Contacts can be created manually or synced from an external directory service.

SourceDescription
ManualCreated directly in the Stratora UI
LDAPSynced from an LDAP / Active Directory server
EntraSynced from Microsoft Entra ID (Azure AD) via OIDC + Microsoft Graph

Contacts synced from an external source are marked as managed. Each synced contact stores an external ID that links it back to the source directory record, ensuring updates and deletions are tracked correctly.

Local field overrides on managed contacts

Managed contacts support per-field local overrides for phone and mobile numbers. When you edit a managed contact's Phone or Mobile field in the Stratora UI, that field becomes locally-managed — the IdP sync will no longer overwrite it on subsequent syncs. Other fields (name, email, group memberships) continue to sync normally from the directory.

This pattern is useful when the directory's telephoneNumber is a desk line but on-call rotations need a personal mobile, or when a contact's mobile is correct in Stratora but incorrect in the IdP. To restore IdP-managed behavior on a field, clear the local override flag from the contact's edit modal.


Contact Groups

Contacts can be organized into groups for easier management.

Each group has:

FieldRequiredDescription
NameYesGroup name (e.g., "Network Team", "Site Admins")
DescriptionNoNotes about the group's purpose
MembersYesOne or more contacts

Groups are useful for organizing contacts by team, responsibility, or location.


How Contacts Are Used

Contacts integrate with the alerting system in two ways:

On-Call Rotations

When you set up an escalation team with a rotation schedule, each rotation member can optionally be linked to a contact record. This keeps contact details centralized — if someone's email or phone number changes, you update the contact once and all rotations referencing it get the new information automatically.

Escalation Step Channels

Escalation step channels can target on-call rotation members dynamically (current on-call, next on-call, etc.). When a channel targets a rotation member who is linked to a contact, the contact's email and phone are used for notification delivery.


Notification Channels

Stratora supports the following notification delivery methods, configured on escalation team step channels:

ChannelDescriptionStatus
EmailSMTP-based email deliveryAvailable
SlackIncoming webhook with Block Kit formattingAvailable
Microsoft TeamsIncoming webhook with Adaptive CardsAvailable
Generic WebhookHTTP POST with JSON payload and custom headersAvailable
SMSText message delivery via TwilioAvailable — requires Twilio configuration; see Twilio Integration
VoiceAutomated voice call via TwilioAvailable — requires Twilio configuration; see Twilio Integration