# xMatters

### What is xMatters integration in ZigiOps?

xMatters is an intelligent communications platform used for automated alerting, on-call scheduling, and incident response coordination across IT and DevOps teams. It supports multi-channel notifications and integrates with a wide range of ITSM and monitoring tools.

ZigiOps enables integration between xMatters and ITSM, monitoring, and DevOps platforms. Supporting Basic Auth, API Token, and OAuth authentication methods, ZigiOps connects xMatters to external systems to support automated alert routing, incident escalation, and cross-team notification workflows.

With ZigiOps, xMatters can:

* Receive alerts and incidents from ITSM platforms and trigger automated notifications
* Participate in bi-directional workflows between alerting and service management systems
* Support automated on-call escalation and incident response coordination
* Integrate with monitoring and DevOps platforms without custom scripting

### Which xMatters versions are supported?

Please note that using a supported version is mandatory.

| Product  | Supported Deployment Types | Supported Versions |
| -------- | -------------------------- | ------------------ |
| xMatters | All                        | All                |

### Are there any environmental prerequisites for xMatters?

There are no environmental prerequisites for this product.

### How do I connect xMatters to ZigiOps?

#### xMatters - Connected System Configuration

Follow the steps below to add your xMatters instance as a connected system.

{% stepper %}
{% step %}
Log in to ZigiOps

Log in to your **ZigiOps** instance.
{% endstep %}

{% step %}
Navigate to the xMatters connected system

Navigate to **Connected Systems > Add New System > xMatters**.
{% endstep %}

{% step %}
Configure the system parameters

Configure the following parameters:

**Server URL**\
Input the URL of your instance.\
Example: `https://example.xmatters.com`

**Authentication Details**\
Select the desired authentication type:

**Basic Auth:**

* **Username** - Input your username.
* **Password** - Input the password for the above user.

**API Token:**

* **API Key** - Input your API key.
* **Client Secret** - Input your Client Secret.

**OAuth:**

* **Username** - Input your username.
* **Password** - Input your password.
* **Client Application ID** - Input your Client Application ID.

**Proxy Settings (optional)**\
Enables the usage of a proxy server.
{% endstep %}

{% step %}
Save the system

Examine the settings and, if they are correct, click **Save** to store the system.

Once saved, xMatters becomes available for use in ZigiOps integration templates.
{% endstep %}
{% endstepper %}

### What are the most common xMatters integration use cases?

#### Use case 1: Automated alert routing from monitoring to xMatters

Alerts from monitoring platforms can be forwarded through ZigiOps to xMatters, triggering automated on-call notifications and escalation workflows without manual intervention.

#### Use case 2: Incident escalation between xMatters and ITSM platforms

xMatters alerts and incidents can be synchronized with ITSM platforms such as ServiceNow or Jira, ensuring that critical incidents tracked in alerting systems are also visible to service management teams.

### What integration templates are available for xMatters?

ZigiOps provides integration templates for xMatters. Contact the ZigiWave support team at <support@zigiwave.com> for more information regarding available templates for this system.

Templates are documented individually in the **Integration Catalog**.

### Summary

The xMatters integration in ZigiOps enables:

* Three authentication methods: Basic Auth, API Token, and OAuth
* Support for all xMatters deployment types and versions
* No environmental prerequisites required
* Alert routing and incident escalation workflows
* Integration with ITSM, monitoring, and DevOps platforms
* Optional proxy configuration
* Fully customizable synchronization workflows without custom scripting

ZigiOps allows xMatters to participate in enterprise-grade alerting, incident response, and IT operations ecosystems without requiring custom development.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zigiwave.com/available-systems/xmatters.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
