Contacts
Contacts are the people or systems Watchman notifies when an agent detects something important. Each contact can receive alerts over email, SMS, and HTTP webhooks.
What are contacts?
A contact is a reusable notification target. Instead of hard‑coding email addresses, phone numbers, or webhook URLs into every agent, you create contacts once in the Directory and then attach them to agents.
- One contact can have multiple channels enabled (email, SMS, webhook).
- Agents decide which contacts to notify when an alert fires.
- You can reuse the same contact across many agents, and update it in a single place.
Create a contact
- Go to Directory in the dashboard.
- Click “Add Contact”.
- Fill in a Name that clearly identifies who or what this contact is (e.g. “Ops On‑Call”, “Slack #alerts”).
- Enable one or more channels (Email, SMS, Webhook) and fill in the required details.
- Save. The contact will be available when configuring agents.
Channels: Email, SMS, Webhooks
Email
- Enable email to send human‑friendly alert messages.
- Set the recipient in the Email To field.
- Use your own SMTP settings or defaults, depending on your workspace setup.
SMS
- Enable SMS to send short text alerts to a phone number.
- Provide a valid phone number in the Phone field.
- Some workspaces may require verification; unverified numbers will be clearly labeled.
Webhook
- Enable webhook to send machine‑readable HTTP requests to another system.
- Set a valid HTTPS endpoint URL, HTTP method, and optional headers.
- Use this for chat tools, incident management systems, custom dashboards, and internal services. See Webhooks docs for details.
Use contacts with agents
Once you have contacts, you attach them to agents. When an agent decides an event is important, it will notify all of its configured contacts using the channels enabled on each contact.
- Open Agents and create or edit an agent.
- In the contacts section, pick one or more contacts to notify. For each contact, you can choose which channels (email, SMS, webhook) should be used.
- Save the agent. Future alerts from this agent will use the selected contacts and channels.
Manage and audit contacts
The Directory view shows all contacts in your workspace, with their channels, status, and last updated time.
- Use search to quickly find contacts by name, email, phone, or webhook URL.
- Edit a contact to update channels, rotate webhook tokens, or change recipients.
- Delete unused contacts to keep your alerting configuration clean.
Tip
Treat contacts as shared alerting profiles. Instead of editing multiple agents, update the contact once and all linked agents will use the new configuration.